跳到主要内容

集成

Hermes Agent 可连接外部系统,用于 AI 推理、工具服务器、IDE 工作流、程序化访问等多种场景。这些集成扩展了 Hermes 的能力边界和运行环境。

AI 提供商与路由

Hermes 内置支持多种 AI 推理提供商。使用 hermes model 进行交互式配置,或在 config.yaml 中直接设置。

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

工具服务器(MCP)

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

网页搜索后端

web_searchweb_extract 工具支持四种后端提供商,可通过 config.yamlhermes tools 配置:

后端环境变量搜索提取爬取
Firecrawl(默认)FIRECRAWL_API_KEY
ParallelPARALLEL_API_KEY
TavilyTAVILY_API_KEY
ExaEXA_API_KEY

快速配置示例:

web:
backend: firecrawl # firecrawl | parallel | tavily | exa

如果未设置 web.backend,系统会根据可用的 API Key 自动检测后端。也支持通过 FIRECRAWL_API_URL 使用自托管的 Firecrawl。

浏览器自动化

Hermes 内置完整的浏览器自动化功能,提供多种后端选项,可用于网站导航、表单填写和信息提取:

  • Browserbase — 托管云端浏览器,具备反机器人工具、CAPTCHA 识别和住宅代理
  • Browser Use — 备选云端浏览器提供商
  • 本地 Chrome(通过 CDP) — 使用 /browser connect 连接到正在运行的 Chrome 实例
  • 本地 Chromium — 通过 agent-browser CLI 使用无头本地浏览器

详情请参阅浏览器自动化

语音与 TTS 提供商

跨所有消息平台的文本转语音和语音转文本:

提供商质量费用API Key
Edge TTS(默认)良好免费无需
ElevenLabs优秀付费ELEVENLABS_API_KEY
OpenAI TTS良好付费VOICE_TOOLS_OPENAI_KEY
MiniMax良好付费MINIMAX_API_KEY
NeuTTS良好免费无需

语音转文本支持六种提供商:本地 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.mdUSER.md 文件实现持久化、精选式记忆。Agent 维护有界存储的个人笔记和用户配置数据,跨会话保留。
  • 记忆提供商 — 接入外部记忆后端,实现更深层的个性化。支持八种提供商:Honcho(辩证推理)、OpenViking(分层检索)、Mem0(云端提取)、Hindsight(知识图谱)、Holographic(本地 SQLite)、RetainDB(混合搜索)、ByteRover(CLI 式)和 Supermemory。

消息平台

Hermes 可作为网关机器人运行在 19+ 个消息平台上,均通过同一 gateway 子系统配置:

请参阅消息网关概览,查看平台对比表和设置指南。

家庭自动化

  • Home Assistant — 通过四个专用工具(ha_list_entitiesha_get_stateha_list_servicesha_call_service)控制智能家居设备。配置 HASS_TOKEN 后,Home Assistant 工具集将自动激活。

插件

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

训练与评估

  • 强化学习训练 — 从 Agent 会话中生成轨迹数据,用于强化学习和模型微调。支持 Atropos 环境,并可自定义奖励函数。
  • 批处理 — 跨数百个提示词并行运行 Agent,生成结构化的 ShareGPT 格式轨迹数据,用于训练数据生成或评估。