Hermes Agent 完整配置教程:从安装到 40+ 工具全开,30 分钟跑通
2026/7/9 3:21:56 网站建设 项目流程

发布日期:2026-06-30 | 数据来源: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-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bashsource~/.bashrc# 让 hermes 命令立即生效

Windows(PowerShell):

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

验证安装成功:

hermes--version

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

文件内容
config.yaml所有非敏感配置(模型、工具、频道等)
.envAPI Key 等密钥,不进版本库
auth.jsonOAuth 凭据
SOUL.mdAgent 人格与身份设定

第二步:首次配置向导(推荐新手)

hermes setup

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

诊断工具随时可用:

hermes doctor

第三步:配置模型

方式 A:命令行快速切换

hermes model

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

方式 B:直接写配置文件

编辑~/.hermes/config.yaml

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

API Key 写进.env,不要写进config.yaml

# 方式一:命令行写入(推荐,自动路由到 .env)hermes configsetOPENROUTER_API_KEY sk-or-xxxx hermes configsetANTHROPIC_API_KEY sk-ant-xxxx hermes configsetOPENAI_API_KEY sk-xxxx# 方式二:直接编辑 ~/.hermes/.envOPENROUTER_API_KEY=sk-or-xxxxANTHROPIC_API_KEY=sk-ant-xxxx

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

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

auxiliary:vision:provider:custombase_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:truehard_stop_enabled:falsewarn_after:exact_failure:2# 连续同样失败 2 次告警same_tool_failure:3hard_stop_after:exact_failure:5# 连续同样失败 5 次强制停止same_tool_failure:8

第五步:配置频道(接入 Telegram / Discord 等)

hermes gateway

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

各平台工具进度显示控制(在config.yaml里按平台细调):

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

第六步:切换终端后端

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

terminal:backend:docker# local | docker | ssh | modal | daytona | singularitytimeout:180

Docker 沙箱(推荐安全场景):

terminal:backend:dockerdocker_image:"nikolaik/python-nodejs:python3.11-nodejs20"docker_mount_cwd_to_workspace:falsecontainer_memory:5120# MBcontainer_disk:51200# MBcontainer_persistent:true

SSH 远程服务器:

# .env 中填入TERMINAL_SSH_HOST=my-server.example.comTERMINAL_SSH_USER=ubuntu
# config.yaml 中terminal:backend:sshpersistent_shell:true

进阶配置:MCP 集成 & Skills

接入任意 MCP 服务器:

Hermes 原生支持 MCP(Model Context Protocol),在config.yamlskills下挂载:

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

记忆模块调优:

memory:memory_enabled:trueuser_profile_enabled:truememory_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.yamlSOUL.md放进私有 git,.env单独用密码管理器或加密存储。


权威来源

  • Hermes Agent 官方文档
  • GitHub: NousResearch/hermes-agent
  • Hermes Agent 配置参考
  • 自定义模型端点接入:七牛云 AI 大模型广场

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

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询