Hermes 教程 01：安装与快速入门

难度：⭐ 入门 | 预计时间：10 分钟 | 适配版本：v0.13.0

系统要求

操作系统：Linux、macOS、Windows WSL2
依赖：Python 3.10+、Git
可选：Docker（远程后端模式）
注意：WSL2 建议启用 systemd=true（/etc/wsl.conf），否则后台服务在关闭窗口后会终止

安装流程

安装脚本
依赖检测
环境配置
健康检查
是
否
通过
失败

运行安装脚本

curl | bash
2. 自动检测依赖

Python/Git
3. 依赖满足?
4. 写入 ~/.hermes/

config.yaml & auth
5. 提示安装依赖
6. 运行 hermes doctor
7. 健康检查结果
✅ 安装完成
查看错误信息

步骤详解

Step 1：运行安装脚本

bash 复制代码

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Step 2：首次配置（交互式向导）

bash 复制代码

hermes setup

向导会依次询问：

选择模型提供商（OpenRouter / Anthropic / DeepSeek / MiniMax 等）
输入 API Key
选择终端后端（local / docker / ssh / modal / daytona）
启用哪些工具集（web / terminal / file / vision 等）

v0.13.0 推荐认证方式 ：使用 hermes auth 命令管理凭证，替代手动编辑 .env：

bash 复制代码

# 添加 API Key（推荐方式）
hermes auth add openrouter --api-key sk-or-xxxxx
hermes auth add anthropic --api-key sk-ant-xxxxx
hermes auth add minimax-cn --api-key xxxxx

# 查看所有认证状态
hermes auth list

# 查看特定提供商
hermes auth status openrouter

Step 3：验证安装

bash 复制代码

hermes doctor

输出示例：

复制代码

✅ Python 3.12.3
✅ Git installed
✅ Config valid
✅ API key configured
✅ Tools: web, terminal, file, vision, ...

首次使用

交互模式（推荐新手）

bash 复制代码

hermes

进入交互界面后直接对话：

复制代码

You: 帮我解释什么是 Skills 系统
Hermes: [回复内容]

单次查询模式

bash 复制代码

hermes chat -q "What is the capital of France?"

纯文本一次性输出（v0.12+）

bash 复制代码

hermes -z "解释量子计算"

-z 模式输出纯文本，无交互元素、无加载动画，适合脚本管道使用。

指定模型

bash 复制代码

hermes chat -q "解释量子计算" -m anthropic/claude-sonnet-4

恢复会话

bash 复制代码

hermes --continue                    # 恢复最近会话
hermes --resume 20260225_143052_a1b2c3   # 恢复指定会话

查看配置

bash 复制代码

hermes config show
hermes config path                   # 查看配置文件路径
hermes config env-path              # 查看 .env 路径

目录结构

复制代码

~/.hermes/
├── config.yaml           # 主配置文件
├── .env                  # API Keys 和密钥（legacy，推荐用 hermes auth）
├── skills/               # 安装的技能
├── sessions/             # 会话记录
├── state.db              # SQLite 会话存储
├── checkpoints/          # 文件系统快照（用于 /rollback）
├── state-snapshots/      # 状态快照
├── logs/                 # 日志文件
│   ├── agent.log         # Agent 活动日志
│   ├── errors.log        # 警告和错误
│   └── gateway.log       # 网关活动日志
├── hermes-agent/         # 源码（git 安装时）
├── plugins/              # 第三方插件（v0.13.0+）
│   └── model-providers/  # 提供商插件目录
└── backups/              # 备份文件

全局选项速查

选项	说明
`--version`, `-V`	显示版本
`--profile <name>`, `-p`	选择 Profile
`--resume <session>`, `-r`	恢复指定会话
`--continue`, `-c`	恢复最近会话
`--worktree`, `-w`	隔离 git worktree 模式
`--yolo`	跳过危险命令确认
`--ignore-user-config`	忽略用户配置
`--ignore-rules`	跳过自动注入规则

常见问题

问题	解决
`command not found: hermes`	重启终端，或检查 PATH 是否包含 `~/.local/bin`
`hermes doctor` 报 Python 版本低	升级到 Python 3.10+
API Key 无效	使用 `hermes auth add <provider> --api-key <key>` 重新添加
OAuth 未登录警告	非阻塞问题，使用 MiniMax-CN 等无需 OAuth 的提供商可忽略
Skills Hub rate limit	在 `.env` 中加 `GITHUB_TOKEN=...`（可选优化）

下一步

前往下一节学习 config.yaml 各项配置
或运行 hermes model 切换模型提供商