Hermes部署与使用

一、部署与配置文档

官方文档：https://hermes-agent.nousresearch.com/docs/zh-Hans/

中文社区文档：https://hermesagent.org.cn/docs/getting-started/installation

二、常用命令

部分可参考：https://hermesagent.org.cn/docs/user-guide/configuration

# 所有设置均存储在 ~/.hermes/ 目录中，便于访问。

# 启动Hermes Agent CLI 的“交互式配置向导”。这将启动一个分步问答流程，帮你把 Hermes 运行所需的核心配置一次性配好，而不是手写 YAML
hermes setup
# 不用每次都跑完整向导，可以跳到具体章节
# 命令	               #配置内容
hermes setup model	    #模型提供商、base_url、API Key、默认模型、上下文长度
hermes setup terminal	#终端后端（Local / Docker / SSH 沙箱）
hermes setup gateway	#消息平台（飞书、Telegram、Discord、Slack 等）
hermes setup tools	    #按平台启用/禁用工具（浏览器、TTS、搜索、图像生成等）
hermes setup agent	    #Agent 行为参数（个性、推理级别、审批模式等）

# 管理配置
hermes config              # 查看当前配置
hermes config edit         # 在编辑器中打开 config.yaml
hermes config show        # 展示当前配置
hermes config set KEY VAL  # 设置指定配置项
hermes config check        # 检查缺失配置项（升级后常用）
hermes config migrate      # 交互式补全缺失配置项
# 示例：
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...  # 保存到 `.env`


# 配置优先级
# 设置按以下顺序解析（优先级从高到低）：
CLI 参数               —— 例如 hermes chat --model anthropic/claude-sonnet-4（每次调用的覆盖）
~/.hermes/config.yaml —— 用于所有非敏感设置的主要配置文件
~/.hermes/.env        —— 环境变量的备用位置；必须用于敏感信息（API 密钥、令牌、密码）
内置默认值              —— 当其他设置均未配置时使用的硬编码安全默认值

# 激活hermes所使用的虚拟python环境
source /usr/local/lib/hermes-agent/venv/bin/activate