Hermes Agent 配置与安装教程20 分钟从克隆到发出第一次对话读完这篇 Hermes Agent 配置与安装教程你会独立完成 Hermes Agent 安装、完成首次配置并让它在终端里回出你的第一条消息。全程只有三件事装、配、跑。Hermes Agent 能帮你做什么个人助手把日常问答、查资料、整理文件交给它你在 Telegram 里发一句它在你的机器上动手。自动化工作流定时日报、夜间备份、周审计用一句自然语言描述之后无人值守运行。多代理应用需要并行处理时它生成隔离子代理分担工作流主会话不被阻塞。动手前环境 3 分钟自检安装脚本会自动处理大部分系统级问题但先花三分钟确认基础条件能少走很多弯路。项目最低要求操作系统Linux 或 macOSWindows 用 WSL2Python3.11 或更高版本内存4GB磁盘空间2GB工具git 已安装、网络可用环境自检命令python --version git --version如果 Python 版本低于 3.11不用手动折腾Hermes Agent 一键安装流程中的安装脚本会代为装好合适版本。安装并确认就绪拿到源码git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent执行安装脚本./setup-hermes.sh脚本会依次完成安装 uv 包管理器、创建 Python 3.11 虚拟环境、装齐项目依赖、把环境变量和命令别名写进你的 shell 配置并把核心技能模块同步到本地。中途若提示输入 sudo 密码是为了装系统级依赖输入即可。装完执行验证命令hermes --version hermes doctor你会看到类似输出✅ Hermes Agent v0.1.0 ✅ Python环境: 3.11.7 (venv) ✅ 依赖项: 全部满足 ✅ 环境变量: 已配置 ✅ 技能模块: 已加载 (24个核心技能)全绿即代表 Hermes Agent 安装完成环境就绪。把默认配置调成你的向导直接执行hermes首次启动会进入配置向导依次选定默认 AI 模型、技能存储路径、日志级别并勾选要启用的功能模块。按你的实际用法选即可之后随时可改。改 .env执行cat .env.example查看配置模板再对照着编辑.env。配置项作用建议值模型 API 密钥调用 Anthropic、OpenAI 等服务填你实际使用的服务商密钥数据库连接信息使用外部数据库时的连接串默认本地存储可留空第三方服务凭证集成外部服务的认证信息用到哪个填哪个注意密钥属于敏感值不要把填好的.env提交进仓库。换模型Hermes Agent 支持多种模型切换默认模型不需要改代码hermes config set default_model anthropic/claude-sonnet执行后用hermes models list可随时查看当前可用模型清单。完成第一个真实任务打开终端执行hermes chat进入终端界面后发一条真实消息比如让它总结一段文字。如果看到流式返回的回复说明 Hermes Agent 安装到模型调用这条链路已经完整跑通。回到终端逐项确认三个环节工具执行hermes tools list列表非空说明工具层可用技能执行hermes skills list能列出核心技能说明技能系统正常诊断执行hermes doctor --verbose无红色报错即通过。三项都过环境才算真正可用。在桌面应用里会话按来源分文件夹管理历史会话、新建入口和搜索都集中在同一个界面适合长期管理多个任务按需扩展技能、看板与 MCP技能当某个操作你已经手动重复了十次以上再考虑把它固化成技能。执行hermes skills hub浏览现成技能hermes skills install github-search装一个试试需要自己的逻辑时用hermes skills new my-custom-skill起骨架。看板给项目型任务用的。执行hermes kanban启动界面hermes kanban add 完成项目文档建一张卡之后任务在 TODO、DOING、DONE 三列间移动进度一眼可见。MCP面向要接外部系统的场景。执行hermes mcp list看当前服务器状态hermes mcp add linear接入一个服务模型即可直接调用对方的工具。三类扩展都是可选的没有对应需求就跳过不影响日常使用。报错时的排查顺序安装脚本中途失败现象是脚本在某一步中断原因多为网络波动或依赖下载不全处理重跑./setup-hermes.sh脚本会接着未完成的部分继续也可手动执行uv pip install -r requirements.txt补装依赖。hermes 命令找不到现象是终端提示 command not found原因是安装目录还没进 PATH处理先source ~/.bashrczsh 用户执行source ~/.zshrc仍不行的话用echo $PATH确认 Hermes 的安装路径是否在其中。依赖冲突现象是命令报包版本冲突原因是环境里混入了不兼容的包处理uv pip check列出冲突确认后删掉 venv 目录重跑./setup-hermes.sh重建环境。装完之后的四周路线周次目标参考目录第 1 周熟悉基础命令与界面操作docs/第 2 周创建第一个自定义技能skills/第 3 周集成外部 API 与 MCP 服务docs/第 4 周清理缓存、优化性能并部署agent/最小起步动作执行hermes chat发起一次真实对话再跑一遍hermes doctor确认环境健康。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考