Hermes Agent 完整配置教程：从安装到 40+ 工具全开，30 分钟跑通

发布日期2026-06-30 | 数据来源Hermes Agent 官方文档、GitHubHermes 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 命令立即生效WindowsPowerShelliex(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.yamlmodel:default:anthropic/claude-opus-4# 主模型provider:openrouter# openrouter / anthropic / nous / openaicontext_length:200000# 主模型不可用时的降级链fallback_providers:-provider:anthropicmodel:claude-sonnet-4-provider:mainAPI Key 写进.env不要写进config.yaml# 方式一命令行写入推荐自动路由到 .envhermes configsetOPENROUTER_API_KEY sk-or-xxxx hermes configsetANTHROPIC_API_KEY sk-ant-xxxx hermes configsetOPENAI_API_KEY sk-xxxx# 方式二直接编辑 ~/.hermes/.envOPENROUTER_API_KEYsk-or-xxxxANTHROPIC_API_KEYsk-ant-xxxx接入国内模型或自定义端点Hermes 支持任意兼容 OpenAI SDK 格式的自定义 endpoint在config.yaml里用${ENV_VAR}语法引用环境变量auxiliary:vision:provider:custombase_url:${CUSTOM_BASE_URL}api_key:${CUSTOM_API_KEY}model:你的模型名七牛云 AIqiniu.com/ai/models提供兼容 OpenAI 格式的统一接入接口把base_url填入七牛云的 API 地址即可在 Hermes 里调用国内可直接访问的多款主流模型包括用于主模型、备用模型或辅助模型vision、compression 等的不同场景。第四步配置工具Toolshermes tools交互式开关各类工具。如果想精确控制在config.yaml里用disabled_toolsets禁用不需要的类别agent:disabled_toolsets:-memory# 关闭记忆模块-web# 关闭网页工具max_turns:90# 单次任务最大轮次reasoning_effort:medium# none | minimal | low | medium | high | xhighNous Portal Tool Gateway 内置的工具集包括网页搜索Firecrawl图像生成FAL语音合成 TTSOpenAI云端浏览器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:180Docker 沙箱推荐安全场景terminal:backend:dockerdocker_image:nikolaik/python-nodejs:python3.11-nodejs20docker_mount_cwd_to_workspace:falsecontainer_memory:5120# MBcontainer_disk:51200# MBcontainer_persistent:trueSSH 远程服务器# .env 中填入TERMINAL_SSH_HOSTmy-server.example.comTERMINAL_SSH_USERubuntu# config.yaml 中terminal:backend:sshpersistent_shell:true进阶配置MCP 集成 Skills接入任意 MCP 服务器Hermes 原生支持 MCPModel Context Protocol在config.yaml的skills下挂载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# 是否每次写记忆都要审批常见问题QHermes Agent 和 OpenClaw 有什么本质区别两者架构不同。OpenClaw 是Gateway-first——核心是 Gateway 节点Agent 通过 Gateway 触达各个频道Hermes 是Agent-first——核心是持续学习的 Agent 本体Gateway 只是它的一个触达渠道。实际使用上Hermes 更强调自我进化和跨会话技能积累OpenClaw 更强调本地化私有部署和硬件权限控制。两者不互斥可以搭配使用。Qhermes 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-agentHermes Agent 配置参考自定义模型端点接入七牛云 AI 大模型广场本文基于 2026 年 6 月 30 日 Hermes Agent 官方文档配置格式以官方最新版本为准。