Hermes Agent 配置与安装教程：20 分钟从克隆到发出第一次对话
读完这篇 Hermes Agent 配置与安装教程，你会独立完成 Hermes Agent 安装、完成首次配置，并让它在终端里回出你的第一条消息。全程只有三件事：装、配、跑。
Hermes Agent 能帮你做什么
- 个人助手：把日常问答、查资料、整理文件交给它，你在 Telegram 里发一句，它在你的机器上动手。
- 自动化工作流：定时日报、夜间备份、周审计，用一句自然语言描述，之后无人值守运行。
- 多代理应用：需要并行处理时，它生成隔离子代理分担工作流，主会话不被阻塞。
动手前：环境 3 分钟自检
安装脚本会自动处理大部分系统级问题，但先花三分钟确认基础条件，能少走很多弯路。
| 项目 | 最低要求 |
|---|---|
| 操作系统 | Linux 或 macOS（Windows 用 WSL2） |
| Python | 3.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 ~/.bashrc（zsh 用户执行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），仅供参考
