> **来源：[研报客](https://pc.yanbaoke.cn)** # Hermes Agent 完全技术参考手册总结 ## 核心内容 Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架，旨在将大模型的语言理解能力扩展为真实世界中的任务执行能力。它支持在多个平台（如 Telegram、Discord、Slack、微信等）和 IDE 中自主运行，代表 AI 从“问答”走向“行动”的关键范式。 ## 主要观点 - **AI 产品形态跃迁**：从 Chatbot 到 Copilot，再到 Agent，Hermes 代表了第三代 AI 代理，具备自主拆解任务、调用工具、执行验证、交付结果的能力。 - **自学习循环**：Hermes 的核心优势在于其四步闭环机制：感知任务 → 执行行动 → 沉淀技能 → 更新记忆，使 Agent 越用越聪明。 - **模型无关与本地优先**：兼容 200+ 模型，支持本地部署，无云端锁定，保障数据主权。 - **三层记忆架构**：包括会话记忆（短期）、持久记忆（长期）和 Skill 记忆（程序性），提供更高效的上下文管理和任务执行能力。 - **多平台网关**：支持 10+ 消息平台，用户可自定义网关配置，实现跨平台自动化任务。 - **Kanban 看板系统**：支持多 Agent 协作、任务依赖关系、状态跟踪和审计日志，适用于复杂项目管理。 - **安全与隐私**：提供命令审批机制、密钥泄露保护、网站屏蔽和工具级隔离，保障系统安全。 ## 关键信息 ### 1. 部署方式 - **本地原生**：适用于 macOS/Linux/WSL2，安装简单。 - **Docker**：推荐用于生产环境，支持容器化隔离。 - **SSH 远端**：适合远程服务器执行，支持 7×24 在线。 - **Singularity**：适用于 HPC 集群，兼容科研环境。 - **Modal**：支持 Serverless 弹性部署。 ### 2. 安装与配置 - 快速安装：`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash hermes setup` - 模型切换：支持多种模型（如 Claude Sonnet 4.6、GPT-4o-mini、Kimi K2、本地 Qwen3-32B），可自定义默认模型。 - 配置文件：`~/.hermes/config.yaml` 包含模型、压缩、安全、网关等配置项。 ### 3. 技能系统 - **技能分类**： - 开发效率类：如 `systematic-debugging`、`github-pr-workflow` - 内容创作类：如 `humanizer`、`tech-article-writing` - 研究与信息收集类：如 `tavily-search`、`arxiv` - 自动化与运维类：如 `self-improvement`、`kanban-worker` - 媒体与生活类：如 `spotify`、`apple-reminders` - **技能沉淀**：Agent 可自动创建并优化技能，社区已建立 `awesome-hermes-agent` 仓库。 ### 4. 上下文文件 - **支持的文件**：`AGENTS.md`、`CLAUDE.md`、`SOUL.md` 等，用于定义项目约定、Agent 人格和行为准则。 - **文件限制**：单文件最大字符数为 20,000，保留比例为 70%（头部）+ 20%（尾部）+ 10%（截断标记）。 ### 5. 上下文压缩机制 - **双层压缩系统**：Agent 压缩层（50% 使用率触发）和 Gateway 安全网（85% 使用率触发），保留语义连贯性。 - **Prompt Caching**：通过 Anthropic 的缓存机制优化性能。 ### 6. 安全最佳实践 - **命令审批**：支持智能审批（推荐）、手动审批（默认）和关闭审批（不推荐）。 - **密钥保护**：自动打码敏感信息。 - **网站屏蔽**：支持自定义黑名单。 - **工具隔离**：可禁用或启用特定工具集。 ### 7. 会话管理 - **会话命令**：支持创建、列出、导出、重命名、清理会话。 - **搜索功能**：支持按关键词或 session ID 搜索历史会话。 ### 8. Cron 定时任务 - **创建定时任务**：支持多种时间格式（如 "30m"、"0 9 * * *"）。 - **实用场景**：日报生成、监控告警、内容更新、SEO 监控等。 - **YAML 配置**：支持复杂任务调度，如依赖任务和多 Agent 协作。 ### 9. Profile 系统 - **多实例隔离**：每个 Profile 有独立的配置、技能、记忆、会话和 API 密钥。 - **使用场景**：内容创作、开发、研究、家庭自动化等。 ### 10. Gateway（消息平台网关） - **支持平台**：Telegram、Discord、Slack、微信等。 - **最佳实践**：安装为系统服务、设置 Home Channel、SSH 断线保护、WSL2 配置等。 ### 11. 常见问题与解决方案 - **配置未生效**：使用 `/reset` 或 `/new` 重置对话，或重启网关。 - **Gateway 崩溃**：检查日志并重启服务。 - **Discord 消息接收问题**：启用 Message Content Intent。 - **Slack Bot 仅在 DM 中工作**：订阅 message.channels 事件。 - **Skill 安装失败**：检查权限和配置，手动创建 Skill。 ### 12. 工作流示例 - **技术文章撰写**：搜索 → 撰写 → 润色 → 保存。 - **代码审查**：指定 PR → 生成报告 → 自动修复。 - **定时日报**：搜索记录 → 生成报告 → 发送到飞书 → 保存。 - **多 Agent 协作**：创建 Kanban 任务，分配给不同 Profile，跟踪状态和依赖关系。 ## 行动建议 1. **体验自学习循环**：48 小时内体验 Hermes 的自我进化能力。 2. **对比部署成本**：了解 Hermes 的模型无关和本地优先优势。 3. **关注 Skill Marketplace**：早期贡献者更容易建立影响力，布局垂直行业 Agent 更具价值。 ## 参考资料 - **官方文档**：[https://hermes-agent.nousresearch.com/docs/](https://hermes-agent.nousresearch.com/docs/) - **研究报告**： - 解数咨询 × D17:《Hermes Agent 品牌研究报告》 - 清华大学清新研究团队:《Hermes Agent 深度研究报告》 - **GitHub 仓库**： - [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) - [awesome-hermes-agent](https://github.com/awesome-hermes-agent) - **社区与博客**： - Reddit: r/hermesagent - Medium / Dev.to / 腾讯云等技术博客 Hermes Agent 的核心竞争力在于其自学习能力、模型无关性和数据主权，是当前 AI Agent 领域的重要创新。