数据来源：Hermes Agent 官方文档、GitHub

Hermes Agent 是 Nous Research 开发的自进化 AI Agent，核心特点是内置学习循环——每次解决问题后自动创建 Skill 并持久记忆，下次遇到同类任务直接调用。它内置 40+ 工具，覆盖终端执行、网页搜索、浏览器自动化、图像生成、TTS/STT 等 8 大类别，支持 Telegram、Discord、Slack、WhatsApp、Signal、Email、CLI、Home Assistant 共 8 个频道，终端后端可选 local、Docker、SSH、Modal 等 6 种，通过 OpenRouter 可接入 300+ 模型，以 MIT 协议开源。本文按操作顺序提供从安装到完整配置的全套命令，每步都可直接复用。

 

第一步：安装

Linux / macOS / WSL2 / Termux（一行命令）：

 

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc   # 让 hermes 命令立即生效

Windows（PowerShell）：

 

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

验证安装成功：

 

hermes --version

安装后所有配置文件放在 ~/.hermes/ 目录下：

文件

内容

config.yaml

所有非敏感配置（模型、工具、频道等）

.env

API Key 等密钥，不进版本库

auth.json

OAuth 凭据

SOUL.md

Agent 人格与身份设定

 

第二步：首次配置向导（推荐新手）

 

hermes setup

交互式向导会引导你完成模型选择和基础配置。如果想跳过向导，直接编辑配置文件也完全可以。

诊断工具随时可用：

 

hermes doctor

 

第三步：配置模型

方式 A：命令行快速切换

 

hermes model

交互式选择提供商和模型，无需手动编辑文件。

方式 B：直接写配置文件

编辑 ~/.hermes/config.yaml：

 

model:
  default: anthropic/claude-opus-4    # 主模型
  provider: openrouter                 # openrouter / anthropic / nous / openai
  context_length: 200000
 
# 主模型不可用时的降级链
fallback_providers:
  - provider: anthropic
    model: claude-sonnet-4
  - provider: main

API Key 写进 .env，不要写进 config.yaml：

 

# 方式一：命令行写入（推荐，自动路由到 .env）
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes config set ANTHROPIC_API_KEY sk-ant-xxxx
hermes config set OPENAI_API_KEY sk-xxxx
 
# 方式二：直接编辑 ~/.hermes/.env
OPENROUTER_API_KEY=sk-or-xxxx
ANTHROPIC_API_KEY=sk-ant-xxxx

接入国内模型或自定义端点：

Hermes 支持任意兼容 OpenAI SDK 格式的自定义 endpoint，在 config.yaml 里用 ${ENV_VAR} 语法引用环境变量：

 

auxiliary:
  vision:
    provider: custom
    base_url: ${CUSTOM_BASE_URL}
    api_key: ${CUSTOM_API_KEY}
    model: "你的模型名"

七牛云 AI（qiniu.com/ai/models）提供兼容 OpenAI 格式的统一接入接口，把 base_url 填入七牛云的 API 地址，即可在 Hermes 里调用国内可直接访问的多款主流模型，包括用于主模型、备用模型或辅助模型（vision、compression 等）的不同场景。

 

第四步：配置工具（Tools）

 

hermes tools

交互式开关各类工具。如果想精确控制，在 config.yaml 里用 disabled_toolsets 禁用不需要的类别：

 

agent:
  disabled_toolsets:
    - memory      # 关闭记忆模块
    - web         # 关闭网页工具
  max_turns: 90                    # 单次任务最大轮次
  reasoning_effort: "medium"       # none | minimal | low | medium | high | xhigh

Nous Portal Tool Gateway 内置的工具集包括：

● 网页搜索（Firecrawl）

● 图像生成（FAL）

● 语音合成 TTS（OpenAI）

● 云端浏览器（Browser Use）

防止工具死循环的保护配置（按需调整）：

 

tool_loop_guardrails:
  warnings_enabled: true
  hard_stop_enabled: false
  warn_after:
    exact_failure: 2         # 连续同样失败 2 次告警
    same_tool_failure: 3
  hard_stop_after:
    exact_failure: 5         # 连续同样失败 5 次强制停止
    same_tool_failure: 8

 

第五步：配置频道（接入 Telegram / Discord 等）

 

hermes gateway

启动消息网关后，Hermes 可以通过任意已配置的频道接收并响应消息。

各平台工具进度显示控制（在 config.yaml 里按平台细调）：

 

display:
  tool_progress: all   # 默认：off | new | all | verbose
  platforms:
    telegram:
      tool_progress: verbose   # Telegram 上显示详细进度
    signal:
      tool_progress: 'off'     # Signal 上不显示
    slack:
      tool_progress: 'off'

 

第六步：切换终端后端

默认在本地运行终端命令。如果你需要隔离环境或远程执行，在 config.yaml 里切换：

 

terminal:
  backend: docker   # local | docker | ssh | modal | daytona | singularity
  timeout: 180

Docker 沙箱（推荐安全场景）：

 

terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_mount_cwd_to_workspace: false
  container_memory: 5120    # MB
  container_disk: 51200     # MB
  container_persistent: true

SSH 远程服务器：

 

# .env 中填入
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=ubuntu


# config.yaml 中
terminal:
  backend: ssh
  persistent_shell: true

 

进阶配置：MCP 集成 & Skills

接入任意 MCP 服务器：

Hermes 原生支持 MCP（Model Context Protocol），在 config.yaml 的 skills 下挂载：

 

skills:
  guard_agent_created: false   # 是否审批 Agent 自动创建的 skill
  write_approval: false        # 是否审批每次写入
  config:
    my_mcp_plugin:
      path: ~/my-mcp-data

记忆模块调优：

 

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200       # 记忆总字符上限
  user_char_limit: 1375         # 用户画像字符上限
  write_approval: false         # 是否每次写记忆都要审批

 

常见问题

Q：Hermes Agent 和 OpenClaw 有什么本质区别？

两者架构不同。OpenClaw 是"Gateway-first"——核心是 Gateway 节点，Agent 通过 Gateway 触达各个频道；Hermes 是"Agent-first"——核心是持续学习的 Agent 本体，Gateway 只是它的一个触达渠道。实际使用上，Hermes 更强调自我进化和跨会话技能积累；OpenClaw 更强调本地化私有部署和硬件权限控制。两者不互斥，可以搭配使用。

Q：hermes config set 和直接编辑 config.yaml 有什么区别？

hermes config set KEY VALUE 会自动判断这个 KEY 属于 .env（密钥类）还是 config.yaml（设置类），并写入对应文件。直接编辑 config.yaml 更直观，适合一次改多个字段。两种方式效果等价，推荐密钥始终用 hermes config set 写入 .env，避免意外提交到 git。

Q：切换模型后立即生效吗？

hermes model 切换后，下一次新对话立即使用新模型；当前进行中的会话不受影响。config.yaml 中的 fallback_providers 在主模型超时或报错时自动接管，无需手动干预。

Q：如何备份 Hermes 配置？

整个 ~/.hermes/ 目录即为完整配置备份，但注意 .env 中有 API Key，备份时不要上传到公开 git 仓库。推荐的做法是把 config.yaml 和 SOUL.md 放进私有 git，.env 单独用密码管理器或加密存储。

 

权威来源：

● Hermes Agent 官方文档

● GitHub: NousResearch/hermes-agent

● Hermes Agent 配置参考

● 自定义模型端点接入：七牛云 AI 大模型广场

本文基于 2026 年 6 月 30 日 Hermes Agent 官方文档，配置格式以官方最新版本为准。