Hermes Agent 文档中文导读

官方文档入口

Hermes Agent 由 NousResearch 开发，官方文档托管在 hermes-agent.nousresearch.com/docs。源代码和 Issues 在 github.com/NousResearch/hermes-agent。两个地方都要收藏：官方 Docs 看概念和配置字段，GitHub 看最新 release tag 和 bug 讨论。

文档全部是英文，暂无官方中文版。本文是社区导读，不是官方翻译——配置字段定义和 API 规格请以原文为准。

文档结构导读

官方 Docs 按功能分区，以下是最常用的几个章节，括号内是对应的官方链接：

• 安装（Installation）：覆盖 pip、Docker、源码三种方式。中文用户建议优先看 Docker 路线，避免 Python 环境问题。
• Docker 指南（Docker Guide）：容器化部署的完整说明，含 volume 挂载和 env 文件配置。
• API Server：Hermes 内置 OpenAI 兼容 API，默认端口 8642。需在 ~/.hermes/.env 里设 API_SERVER_ENABLED=true。端点包括 /v1/chat/completions、/v1/models、/v1/runs、/health。
• Web Dashboard：可视化管理界面，默认端口 9119，只监听 localhost，无内置认证。需单独安装：pip install hermes-agent[web]，然后运行 hermes dashboard。
• Skills（技能）：内置、可选和社区 Skills 的说明。Skills 让 Hermes 学会特定任务，不需要 fine-tune 模型。
• Skills Hub：652 个技能的完整目录（72 内置 + 59 可选 + 521 社区）。含视频（ascii-video、manim-video）、音乐（heartmula、audiocraft-audio-generation）、图片（pixel-art、p5js）等媒体生成技能。
• CLI 参考（CLI Reference）：所有 hermes 子命令的完整列表，包括 hermes pairing、hermes skills、hermes mcp 等。
• MCP 集成：在 config.yaml 里配置 MCP 服务器，通过 mcp_servers: 字段接入外部工具。

配置体系：Hermes 用 config.yaml 管功能开关和 MCP，用 ~/.hermes/.env 管密钥和环境变量。两个文件都要看清楚，别把 API key 写进 config.yaml。

按任务找章节：速查表

中文用户常踩的坑

• API key 写错位置：密钥（OPENAI_API_KEY、FAL_KEY 等）要写进 ~/.hermes/.env，不是 config.yaml。混着写会导致密钥明文暴露在版本库。
• Dashboard 端口没暴露：9119 默认只监听 localhost。Docker 部署时要加 -p 9119:9119，同时在反向代理（Nginx / Caddy）上做好认证，否则管理页对公网裸奔。
• Skills 装了但模型不调用：多半是 SKILL.md 里 description 写得太抽象。模型靠这个字段决定要不要激活 skill，要写成“用户说 X 时触发”的具体场景。详见 Skills 中文指南。
• 换模型 provider 没重启：config.yaml 里的 approvals.mode、provider 等配置在启动时读取一次。改完必须重启容器，热重载对这类字段无效。
• 搜索功能 404：Hermes 内置 4 个搜索 provider（Tavily、Exa、Parallel、Firecrawl），按 env 里哪个 key 有值自动选。一个都没配时自动降级到 DuckDuckGo（不需要 key），但有时防爬拦截导致结果为空，换付费 provider 更稳。
• Pairing 凭据路径：hermes pairing approve 把凭据存在 /opt/data/platforms/pairing/。Docker volume 没挂这个路径的话重启容器后需要重新 pairing。

能力速览（基于 v2026.4.16 源码）

以下内容来自官方源码检查，仅供参考，新版本可能有变化，以 GitHub 仓库为准：

• OpenAI 兼容 API：端口 8642，支持 /v1/chat/completions、/v1/models、/v1/runs、/health，支持 previous_response_id 和 Runs API 做会话连续性。
• 图片生成：FAL.ai（env: FAL_KEY、FAL_IMAGE_MODEL）+ Skills Hub 里的图片技能（pixel-art、p5js）。
• 网络搜索：Tavily、Exa、Parallel、Firecrawl 四选一，无 key 时自动用 DuckDuckGo。
• 视觉输入：集中式辅助路由，支持 OpenRouter、Nous、Codex、原生 Anthropic 及自定义 OpenAI 兼容端点。
• 音频转录：tools/transcription_tools.py。
• Shell 执行：本地、Docker、Modal、SSH、Singularity、Daytona 等多种环境，支持前台和后台模式。
• 审批策略：approvals.mode 支持 manual / smart / off 三档，命令白名单支持 once / session / always 范围。
• 人格预设：14 种（helpful、concise、technical、creative、teacher、kawaii、pirate 等）。
• MCP：config.yaml 的 mcp_servers: 字段，CLI 用 hermes mcp。

不想读文档：30 秒托管上线

OpenClaw Launch 提供 Hermes Agent 托管服务——TLS、容器管理、自动更新、渠道 pairing 全部代劳，不需要读 config.yaml，不需要转发端口，不需要任何 Docker 命令。从注册到 Hermes 跑起来约 30 秒。

常见问题

有官方中文文档吗？

没有。官方文档（hermes-agent.nousresearch.com/docs）和 GitHub README 均为英文。本页是 OpenClaw Launch 整理的中文导读，不是官方翻译。如需社区中文讨论，可在 GitHub Issues 用中文提问。

文档入口在哪里？

官方文档：hermes-agent.nousresearch.com/docs。GitHub 源码与 Issues：github.com/NousResearch/hermes-agent。两者都建议收藏，前者看配置，后者看最新 release 和已知 bug。

安装文档看哪节？

看 Installation，中文用户推荐同时读 Docker Guide，省去 Python 环境问题。本站也有中文安装指南：安装与配置。

不想读文档，最快的上手方式是什么？

直接用 OpenClaw Launch 托管版——约 30 秒从注册到 Hermes 跑起来，完全跳过安装文档。TLS、容器、更新、渠道 pairing 都帮你做好了，不需要动任何配置文件。

Hermes 支持视频和音乐生成吗？

支持，通过 Skills Hub 里的媒体技能实现：视频（ascii-video、manim-video）、音乐（heartmula、audiocraft-audio-generation）、图片（pixel-art、p5js）。完整目录见 Skills Hub，共 652 个技能。

下一步

• Hermes Agent 中文介绍
• 安装与配置（中文）
• Skills 中文指南
• Memory（记忆系统）
• Hermes 官网导航