Hermes 如何对接外部世界
除了大模型本身,Hermes 还集成五类外部服务:AI 推理、MCP 工具服务器、网页搜索、语音后端,以及 OpenAI 兼容 API 模式。每一类都用环境变量驱动,配合配置文件条目或交互式 CLI 命令。本课讲清每种集成的形状,让你决定先接什么、先放什么。
主要来源:集成索引 https://hermes-agent.nousresearch.com/docs/integrations/。权威的、逐服务的配置步骤请以该页为准。
AI 模型提供商
Hermes 支持 OpenAI、Anthropic、Google、Nous Portal、OpenRouter、Ollama,以及任意 OpenAI 兼容端点。提供商选择不仅是「向哪家付费」 —— 更是路由策略:
- 提供商路由 —— 按成本、延迟或质量决定每个请求交给谁。
- 回退提供商 —— 主路失败时自动重试备路。
- 凭证池 —— 在多把 key 间轮换,分摊流量,key 被吊销也能撑过去。
交互式管理用 hermes model 与 hermes auth。它们处理 OAuth 与 API key 存储,密钥永远写入 ~/.hermes/.env 而不是 YAML 配置。
MCP:不写工具也能加工具
Model Context Protocol 是你不需要每次都写一个 Python 集成的原因。MCP 服务器以标准协议暴露能力;Hermes 订阅它就能用。社区已经有针对 GitHub、数据库、文件系统、浏览器栈以及各类内部 API 的 MCP 服务器。
从 CLI 管理 MCP:
hermes mcp list
hermes mcp add <server>
hermes mcp test <server>
hermes mcp configure <server>
hermes mcp serve # 让 Hermes 自己作为 MCP 服务器运行最后一条值得强调 —— 你可以把 Hermes 暴露给其他 MCP 兼容智能体,让它变成别的系统可调用的工具。
网页搜索:四种后端,自动检测
网页搜索是 Hermes 不重新发明的通用能力。支持四个后端:
- Firecrawl —— 默认。
- Parallel —— 偏速度、偏成本。
- Tavily —— 面向答案生成。
- Exa —— 神经搜索。
每家用各自的 API key 环境变量选择(FIRECRAWL_API_KEY、TAVILY_API_KEY 等)。如果你不显式设置 web.backend,Hermes 会根据已有凭证自动挑选。一旦配好,内置的 web_search 与 web_extract 工具会透明地走到你选的后端。
语音后端:TTS 与 STT
文字转语音提供商:Edge TTS(免费默认)、ElevenLabs、OpenAI、MiniMax、NeuTTS。语音转文字提供商:本地 Whisper、Groq、OpenAI。推荐从 Edge TTS 起步,因为你可以零成本把整条语音链路跑通。
语音提供商配好后,在支持的所有消息平台上语音转写都会生效 —— Telegram、Discord、WhatsApp、飞书、QQ 机器人等等。语音不用按平台重新配置;配一次,所有支持的网关都用同一套栈。
OpenAI 兼容 API 服务器
把 hermes 作为 OpenAI 兼容的 HTTP 服务器运行,相当于把整个智能体变成任何 OpenAI 客户端应用的后端 —— Open WebUI、LobeChat、你自己的 Next.js 原型。端口可配置,服务器讲标准的 /v1/chat/completions 形状。对已经喜欢某个前端的团队来说,这是「让同样的界面获得智能体能力」最短的路径。
外部记忆提供商
除了本地的 MEMORY.md / USER.md 文件,Hermes 还能用七家外部记忆提供商做背板,包括 Honcho 与 Mem0。每家有自己的持久化模型 —— 适合「记忆要跟着用户跨机器」或「跨会话个性化要规模化」的场景。
管理命令:
hermes memory setup
hermes memory status
hermes memory off # 关闭外部记忆,回退到文件
hermes honcho # Honcho 专属:peer 身份与召回模式插件
插件系统是最后的逃生口:自定义工具、生命周期钩子、备选记忆提供商、自定义上下文引擎 —— 都能从 ~/.hermes/plugins/ 加载,不碰核心代码。如果你要集成一个不属于上述任何类别的定制系统,插件通常是最干净的答案。
下一步
第 6 课是实操向的「如何真正用好」 —— 提问规范、AGENTS.md、快捷键、运维安全。第 7 课给想贡献、扩展、或自己写提供商的开发者。如果你是英国团队、集成清单让你开始犯愁,这正是 SetupClaw 托管服务存在的原因。