> **来源：[研报客](https://pc.yanbaoke.cn)** # Hermes Agent 完全技术参考手册总结 ## 核心内容 Hermes Agent 是 Nous Research 开发的开源 AI Agent 框架，旨在将大模型的语言理解能力扩展为真实世界中的任务执行能力。它不是传统的聊天机器人，而是一个可以在终端、消息平台（如 Telegram、Discord、Slack、飞书、微信等）和 IDE 中自主运行的执行代理。 ## 主要观点 - **AI 范式跃迁**：AI 产品的形态正在经历从问答到行动的第三次跃迁，Hermes Agent 站在第三阶段。 - **自学习循环**：Hermes Agent 的核心差异化能力是其自学习循环，包括感知任务、执行行动、沉淀技能、更新记忆。 - **模型无关性**：兼容 200+ 模型，包括 OpenAI、Anthropic、Gemini、MiniMax、月之暗面 Kimi、智谱 GLM 等，支持模型切换，无需改代码。 - **多平台网关**：支持 10+ 消息平台，具备跨平台运行能力。 - **Profile 隔离**：支持多实例配置隔离，适应不同工作场景。 - **记忆系统**：三层记忆（会话、持久化、Skill）提升 AI 的适应性和效率。 ## 关键信息 ### 部署方式 - **本地原生**：适用于 macOS/Linux/WSL2，安装简单。 - **Docker**：推荐用于生产环境，提供容器化隔离。 - **SSH远端**：适合远程服务器执行。 - **Singularity**：适用于 HPC 集群。 - **Modal**：支持 Serverless 弹性部署。 ### 安装与配置 - **快速安装**：使用 pip 安装或官方一键脚本。 - **配置文件**：主配置文件为 `~/.hermes/config.yaml`，支持多种配置选项。 - **健康检查**：使用 `hermes doctor --fix` 检查和修复问题。 ### 技能系统 - **107+ 个技能**：涵盖开发效率、内容创作、研究与信息收集、自动化与运维、媒体与生活等多个领域。 - **Skill 沉淀**：Agent 能自动创建和沉淀技能，提升任务执行能力。 ### 上下文文件 - **支持文件**：如 `AGENTS.md`、`SOUL.md` 等，用于定义项目约定、Agent 人格和行为准则。 - **文件大小限制**：单文件最大字符数为 20,000，保留头部 70%，尾部 20%，其余为截断标记。 ### 会话管理 - **会话命令**：支持创建、列出、导出、重命名、清理会话。 - **搜索会话**：支持按关键词或 ID 搜索会话。 ### 上下文压缩机制 - **双层压缩系统**：Agent 压缩层和 Gateway 安全网关分别在 50% 和 85% 上下文窗口使用率时触发。 - **Prompt Caching**：保留用户消息，压缩工具调用历史，重新注入初始上下文。 ### 定时任务 - **Cron 任务**：支持创建、编辑、暂停、恢复、运行和删除定时任务。 - **典型场景**：如每日 SEO 监控，成本约为 $0.18 次。 ### 网关与平台支持 - **支持平台**：包括 Telegram、Discord、Slack、WhatsApp、Signal、Email、Matrix、微信等。 - **网关最佳实践**：安装为系统服务、设置 Home Channel、SSH 断线保护、WSL2 配置。 ### 安全最佳实践 - **命令审批机制**：支持智能、手动和关闭审批模式。 - **密钥泄露保护**：自动脱敏敏感信息。 - **网站屏蔽**：配置网站黑名单。 - **工具级隔离**：支持禁用或启用特定工具。 ### Kanban 多 Agent 协作看板 - **任务管理**：支持创建任务卡片、设置依赖关系、跟踪状态。 - **工作模式**：包括 Orchestrator 和 Worker 模式，支持并行和串行任务执行。 ### 高级技巧与隐藏用法 - **子代理**：支持将任务分配给其他 Agent。 - **生成多个独立 Agent**：通过 tmux 实现。 - **MCP 集成**：支持 6000+ MCP 工具。 - **Webhook 事件驱动**：支持 GitHub Push 和 Pull Request 事件。 - **上下文压缩**：支持手动和自动压缩。 ### 推荐配置 - **模型配置**：默认使用 Claude Sonnet 4.6，备用模型为 Kimi K2。 - **压缩配置**：启用压缩，设置阈值和目标比例。 - **安全配置**：启用密钥脱敏和网站屏蔽。 - **记忆配置**：启用持久化记忆，设置同步间隔。 - **审批配置**：设置为智能审批模式，自动审批常用命令。 ### 常见问题与避坑指南 - **配置未生效**：使用 `/reset` 或 `/new` 重置对话，或重启网关。 - **网关崩溃**：检查日志并重启服务。 - **Discord 消息接收问题**：启用 Message Content Intent。 - **Slack Bot 仅在 DM 中工作**：订阅 message.channels 事件。 - **技能安装问题**：检查权限并配置技能文件。 ### 工作流示例 - **技术文章写作**：预加载技能，搜索素材，撰写文章，润色并保存。 - **代码审查**：预加载审查技能，指定 PR，生成审查报告，自动修复。 - **定时日报自动化**：创建定时任务，搜索会话记录，生成报告并发送。 - **多 Agent 协作**：使用 Kanban 看板管理任务，分配给不同角色。 ## 行动建议 1. **体验自学习循环**：48 小时内体验 Hermes 的自学习能力，验证其是否真实存在。 2. **对比 Agent 迁移成本**：评估当前 Agent 的模型和云平台锁定情况，Hermes 提供模型无关和本地部署。 3. **关注 Skill Marketplace**：30 天内参与早期 Skill 市场建设，提升影响力。 ## 参考资料 - **官方文档**：[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 / 腾讯云等技术博客。