Hermes-Agent：安装与快速上手
目录
- 一键安装（官方脚本）
- 安装后第一件事
- 两条主路径：CLI 与 Gateway
- 官方对照表：CLI vs Messaging
- 从 OpenClaw 迁移（可选）
- 贡献者本地开发（可选）
- 安装失败的典型原因
- 下一步读什么
- 原文链接
一键安装（官方脚本）
官方推荐脚本（Linux / macOS / WSL2；不要用原生 Windows 直接跑，README 明确说明）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装脚本来源（可复核）：scripts/install.sh。
安装后按提示重新加载 shell：
source ~/.bashrc
# 或
source ~/.zshrc
然后验证入口：
hermes --help
更细的「两分钟跑通」见官方 Quickstart。
安装前自检（强烈建议）
- 确认网络能访问 GitHub（脚本拉取资源）。
- 确认磁盘空间充足（Python 依赖与缓存可能较大）。
- WSL2 用户确认发行版更新、DNS 正常（否则 curl 可能间歇失败）。
安装后第一件事
建议按下面顺序建立「可控的第一次成功」，避免一上来就开满工具：
hermes # 进入交互 CLI（TUI）
hermes model # 选择 provider 与模型
hermes tools # 了解/启用工具集
hermes doctor # 诊断环境与配置
若要一次性完成向导式配置：
hermes setup
hermes doctor 的意义不只是「报错没有」：它能把配置不一致、路径问题、依赖缺口提前暴露在你接入公网消息之前。
“第一次成功”的定义
建议你把它定义成可验证标准，而不是“感觉能聊”：
hermes能进入 TUI；hermes model能稳定调用至少一个 provider；hermes doctor没有阻塞级错误（或你已理解警告含义）。
两条主路径：CLI 与 Gateway
| 目标 | 典型命令/入口 | 你需要读的资料 |
|---|---|---|
| 终端里用 | hermes | CLI Usage |
| IM 里用 | hermes gateway 相关子命令 | Messaging Gateway |
官方强调：Hermes 有两个入口——终端 UI 与 消息网关；进入会话后，大量 slash 命令在两种界面间共享（见 README CLI vs Messaging Quick Reference）。
为什么建议先 CLI 再 Gateway
CLI 路径更利于调试：你能直接看到错误栈、工具输出与配置问题。先跑通 CLI，再接入公网消息，通常比反过来更快。
官方对照表：CLI vs Messaging
README 提供了一张跨界面速查表（节选示例，完整以原文为准）：
| Action | CLI | Messaging platforms |
|---|---|---|
| Start chatting | hermes | hermes gateway setup + hermes gateway start 后给 bot 发消息 |
| Start fresh | /new 或 /reset | 同左 |
| Change model | /model [provider:model] | 同左 |
| Browse skills | /skills | 同左 |
完整表格见 README 对应章节。
从 OpenClaw 迁移（可选）
若检测到 ~/.openclaw，hermes setup 可能主动提示迁移；也可随时执行：
hermes claw migrate --dry-run
hermes claw migrate
导入范围（SOUL、记忆、技能、平台配置、部分 API Key 等）以官方说明为准：Migrating from OpenClaw。
贡献者本地开发（可选）
README 给出的开发者路径大致为：
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"
python -m pytest tests/ -q
若涉及可选 RL 子模块，按 README 的 tinker-atropos 说明初始化。贡献流程见 Contributing。
安装失败的典型原因
| 现象 | 常见原因 | 处理方向 |
|---|---|---|
| curl 失败 | 网络/DNS/代理 | 换网络、配置代理、重试 |
| Python 依赖冲突 | 系统 Python 混用 | 严格用 venv/uv 隔离 |
| Termux 装不全 | .[all] 拉取不兼容依赖 | 按 Termux guide 使用 curated extra |