hermes教程-集成

Hermes Agent 连接到外部系统，用于 AI 推理、工具服务器、IDE 工作流、程序化访问等。这些集成扩展了 Hermes 的能力和运行范围。

提示 — 从这里开始

如果你只有时间设置一个集成，请设置 Nous Portal —— 一次 OAuth 登录即可覆盖 300 多个模型以及四个工具网关工具（网页搜索、图像生成、TTS 和浏览器自动化）。

AI 提供商与路由

Hermes 开箱即支持多个 AI 推理提供商。使用 hermes model 进行交互式配置，或在 config.yaml 中设置。

• AI 提供商 — OpenRouter、Anthropic、OpenAI、Google 以及任何兼容 OpenAI 的端点。Hermes 会自动检测每个提供商的视觉、流式传输和工具使用等能力。
• 提供商路由 — 精细控制哪些底层提供商处理你的 OpenRouter 请求。通过排序、白名单、黑名单和显式优先级排序，优化成本、速度或质量。
• 备用提供商 — 当主模型遇到错误时，自动故障转移到备用 LLM 提供商。包括主模型备用以及独立的辅助任务备用（用于视觉、压缩和网页提取）。

工具服务器 (MCP)

• MCP 服务器 — 通过模型上下文协议将 Hermes 连接到外部工具服务器。访问来自 GitHub、数据库、文件系统、浏览器栈、内部 API 等的工具，无需编写原生 Hermes 工具。支持 stdio 和 SSE 传输、按服务器过滤工具，以及感知能力的资源/提示注册。

网页搜索后端

web_search 和 web_extract 工具支持八个后端提供商，通过 config.yaml 或 hermes tools 配置：

快速设置示例：

web:
  backend: firecrawl    # firecrawl | searxng | brave-free | ddgs | tavily | exa | parallel | xai

如果未设置 web.backend，则会根据可用的 API 密钥自动检测后端。自托管 Firecrawl 也通过 FIRECRAWL_API_URL 支持。

浏览器自动化

Hermes 包含完整的浏览器自动化，提供多个后端选项，用于导航网站、填写表单和提取信息：

• Browserbase — 托管云浏览器，具备反机器人工具、验证码解决和住宅代理
• Browser Use — 替代云浏览器提供商
• 本地 Chromium 系列 CDP — 使用 /browser connect 连接到正在运行的 Chrome、Brave、Chromium 或 Edge 浏览器
• 本地 Chromium — 通过 agent-browser CLI 运行无头本地浏览器

有关设置和使用，请参阅 浏览器自动化。

语音与 TTS 提供商

所有消息平台上的文本转语音和语音转文本：

语音转文本支持六个提供商：本地 faster-whisper（免费，在设备上运行）、本地命令包装器、Groq、OpenAI Whisper API、Mistral 和 xAI。语音消息转录适用于 Telegram、Discord、WhatsApp 和其他消息平台。详情请参阅 语音与 TTS 和 语音模式。

IDE 与编辑器集成

• IDE 集成 (ACP) — 在兼容 ACP 的编辑器（如 VS Code、Zed 和 JetBrains）中使用 Hermes Agent。Hermes 作为 ACP 服务器运行，在编辑器内呈现聊天消息、工具活动、文件差异和终端命令。

程序化访问

• API 服务器 — 将 Hermes 暴露为兼容 OpenAI 的 HTTP 端点。任何使用 OpenAI 格式的前端（Open WebUI、LobeChat、LibreChat、NextChat、ChatBox）都可以连接并将 Hermes 作为后端，使用其完整工具集。

记忆与个性化

• 内置记忆 — 通过 MEMORY.md 和 USER.md 文件实现持久、精选的记忆。代理维护有限的个人笔记和用户配置文件数据存储，这些数据在会话之间持久存在。
• 记忆提供商 — 插入外部记忆后端以实现更深层次的个性化。支持八个提供商：Honcho（辩证推理）、OpenViking（分层检索）、Mem0（云提取）、Hindsight（知识图谱）、Holographic（本地 SQLite）、RetainDB（混合搜索）、ByteRover（基于 CLI）和 Supermemory。

消息平台

Hermes 作为网关机器人运行在 27 个以上的消息平台上，所有平台都通过相同的 gateway 子系统配置：

• Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email、SMS、DingTalk、Feishu/Lark、WeCom、WeCom Callback、Weixin、BlueBubbles、QQ Bot、Yuanbao、Home Assistant、Microsoft Teams、Microsoft Teams Meetings、Microsoft Graph Webhook、Google Chat、LINE、ntfy、SimpleX、Open WebUI、Webhooks

请参阅 消息网关概述 获取平台对比表和设置指南。

家庭自动化

• Home Assistant — 通过四个专用工具（ha_list_entities、ha_get_state、ha_list_services、ha_call_service）控制智能家居设备。当配置了 HASS_TOKEN 时，Home Assistant 工具集会自动激活。

插件

• 插件系统 — 无需修改核心代码即可使用自定义工具、生命周期钩子和 CLI 命令扩展 Hermes。插件从 ~/.hermes/plugins/、项目本地 .hermes/plugins/ 以及通过 pip 安装的入口点发现。
• 构建插件 — 创建包含工具、钩子和 CLI 命令的 Hermes 插件的分步指南。

训练与评估

• 批处理 — 在数百个提示上并行运行代理，生成结构化的 ShareGPT 格式轨迹数据，用于训练数据生成或评估。