Hermes Agent 完整知识总结与使用教程

Hermes Agent 完整知识总结与使用教程项目地址: https://github.com/NousResearch/hermes-agent官方文档: https://hermes-agent.nousresearch.com/docs一、项目概述1.1 Hermes Agent 是什么Hermes Agent 是由 Nous Research 构建的开源自我改进型 AI 智能体。它不是绑定在 IDE 上的代码助手也不是围绕单一 API 的聊天机器人包装器而是一个驻留在你服务器上的自主智能体——拥有持久记忆、自动生成技能、跨平台通信能力并且运行时间越长越智能。核心定位自我改进内置学习闭环从经验中创建技能Skills在使用中改进技能主动持久化知识持久记忆跨会话记住你的偏好、项目上下文和环境信息全平台覆盖CLI、Telegram、Discord、Slack、WhatsApp、Signal、Email、Matrix、钉钉、飞书、企业微信等 15 平台灵活部署可运行在 $5 的 VPS、GPU 集群或按需休眠的无服务器基础设施上1.2 核心特性总览特性说明自我改进循环从复杂任务中自动创建可复用技能文档使用中持续优化持久记忆MEMORY.md USER.md 双文件系统加上 FTS5 全文搜索历史会话多平台网关单一 gateway 进程连接 15 消息平台跨平台对话无缝衔接六种终端后端Local、Docker、SSH、Daytona、Singularity、Modal多模型支持Nous Portal、OpenRouter200 模型、OpenAI、z.ai/GLM、Kimi、MiniMax 等MCP 支持连接任意 MCP 服务器扩展工具能力定时自动化自然语言 cron 调度自动执行报告、备份、简报子智能体隔离的子智能体拥有独立对话、终端和 Python RPC 脚本浏览器控制Web 搜索、浏览器自动化、视觉识别、图片生成、TTS语音模式CLI 麦克风输入、消息平台语音回复技能市场兼容 agentskills.io 开放标准社区贡献的 Skills Hub研究就绪批处理、轨迹导出、Atropos RL 训练二、架构与核心概念2.1 记忆系统四层架构Hermes Agent 的记忆并非单一系统而是由四个不同层次组成第一层MEMORY.md提示记忆存储位置~/.hermes/memories/MEMORY.md容量上限约 2,200 字符约 800 tokens内容类型环境事实、项目约定、发现的解决方案、经验教训注入方式每次会话启动时作为冻结快照注入系统提示特点会话中的修改立即写入磁盘但要到下次会话才反映在系统提示中保持 LLM 前缀缓存性能第二层USER.md用户画像存储位置~/.hermes/memories/USER.md内容类型用户偏好、沟通风格、个人信息注入方式同样在会话启动时注入系统提示第三层会话搜索Session Search存储位置~/.hermes/state.dbSQLite FTS5 全文搜索所有 CLI 和消息平台的会话都被存储搜索查询返回相关的历史对话并通过 Gemini Flash 进行摘要按需调用不在系统提示中——用于我们上周讨论过 X 吗这类查询第四层可插拔外部记忆提供者支持 7 个外部记忆提供者包括 Honcho、Hindsight、Mem0 等提供结构化提取、实体解析和跨会话持久化通过hermes memory provider配置同一时间只能激活一个外部提供者内置记忆始终并行运行记忆操作通过memory工具执行支持的操作有add、replace、remove无 read 操作——内容自动注入系统提示。记忆条目写入前会进行安全扫描检测注入和数据窃取模式。2.2 技能系统Skills技能是 Hermes Agent 的程序化记忆——当智能体解决了复杂任务通常涉及 5 次工具调用后会自主创建结构化的 Markdown 技能文档。技能存储与结构~/.hermes/skills/ # 本地主目录可读写 ├── devops/deploy-k8s/ │ └── SKILL.md └── mlops/axolotl/ └── SKILL.md技能特点兼容 agentskills.io 开放标准可跨智能体移植和分享渐进式披露模式最小化 token 使用智能体可通过skill_manage工具创建、更新和删除技能支持外部技能目录只读共享技能可作为斜杠命令直接调用/axolotl help me fine-tune Llama 3技能安装与管理hermes skills search kubernetes# 搜索技能hermes skills search react--sourceskills-sh# 从 skills.sh 搜索hermes skillsinstallopenai/skills/k8s# 安装技能hermes skills inspectskill# 安全检查hermes skills check# 检查上游更新hermes skills update# 更新技能所有从 Hub 安装的技能都会通过安全扫描器检查数据窃取、提示注入、破坏性命令等威胁。2.3 终端后端Hermes 支持六种命令执行方式后端说明Local直接在本机执行默认Docker容器隔离执行安全沙箱SSH远程服务器执行Daytona无服务器持久化——空闲时休眠按需唤醒SingularityHPC 环境容器Modal无服务器持久化——空闲时几乎零成本切换后端hermes configsetterminal.backenddocker# Docker 隔离hermes configsetterminal.backendssh# 远程服务器2.4 网关系统Gateway网关是一个长运行进程将智能体连接到消息平台。支持的平台包括CLI、Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email、SMS、钉钉DingTalk、飞书Feishu、企业微信WeCom、BlueBubbles、Home Assistant特点语音备忘录转写跨平台对话连续性在 Telegram/Slack 上支持原生按钮进行危险命令审批三、安装指南3.1 系统要求支持平台: Linux、macOS、WSL2、Androidvia Termux不支持: 原生 Windows需先安装 WSL2依赖: 安装脚本自动处理 Python、Node.js、ripgrep、ffmpeg 等3.2 一键安装推荐curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash安装完成后重新加载 Shell 并启动source~/.bashrc# 或: source ~/.zshrchermes# 开始对话安装脚本自动完成所有依赖安装、仓库克隆、虚拟环境创建、全局hermes命令设置、LLM 提供者配置。3.3 手动安装# 安装 uvcurl-LsSfhttps://astral.sh/uv/install.sh|sh# 克隆仓库gitclone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcdhermes-agent# 创建 Python 3.11 虚拟环境uv venv venv--python3.11exportVIRTUAL_ENV$(pwd)/venv# 完整安装包含所有功能uv pipinstall-e.[all]# 可选RL 训练后端uv pipinstall-e./tinker-atropos# 可选浏览器自动化和 WhatsAppnpminstall# 创建配置目录mkdir-p~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}cpcli-config.yaml.example ~/.hermes/config.yamltouch~/.hermes/.envechoOPENROUTER_API_KEYsk-or-v1-your-key~/.hermes/.env# 全局可用mkdir-p~/.local/binln-sf$(pwd)/venv/bin/hermes~/.local/bin/hermes# 验证安装hermes doctor可选 extras 组合安装uv pipinstall-e.[messaging,cron]# 仅消息平台和定时任务3.4 Android / Termux 安装Termux 安装使用精选的.[termux]extra因为完整的.[all]extra 包含与 Android 不兼容的语音依赖。具体步骤参见官方 Termux 指南。四、配置与使用4.1 初始配置hermes setup# 完整配置向导hermes model# 选择 LLM 提供者和模型hermes tools# 配置启用的工具hermes gateway setup# 设置消息平台hermes configset# 设置单个配置值4.2 LLM 提供者支持的提供者随时通过hermes model切换无需改代码提供者说明Nous Portal订阅制零配置使用 OAuthOpenRouter多提供者路由200 模型需 API KeyOpenAIGPT 系列模型z.ai / GLM智谱 AIKimi / Moonshot月之暗面MiniMaxMiniMax 模型阿里云通义千问等Hugging Face开源模型自定义端点任何兼容 API4.3 CLI 交互启动后进入功能完整的 TUI终端用户界面多行编辑斜杠命令自动补全对话历史中断重定向输入新消息按回车即可中断当前任务CtrlC 也可以流式工具输出4.4 MCP 服务器配置在~/.hermes/config.yaml中添加mcp_servers:github:command:npxargs:[-y,modelcontextprotocol/server-github]env:GITHUB_PERSONAL_ACCESS_TOKEN:ghp_xxx支持 MCP OAuth 2.1 PKCE 标准认证以及通过 OSV 漏洞数据库自动扫描 MCP 扩展包恶意软件。4.5 消息平台网关hermes gateway setup# 交互式平台配置hermes gateway start# 启动网关配置完成后可以从手机上通过 Telegram 等平台与智能体对话同时它在云端 VM 上工作。4.6 定时自动化Cron使用自然语言设置定时任务❯ Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.智能体会自动设置通过网关运行的 cron 任务。4.7 语音模式pipinstallhermes-agent[voice]# 推荐安装免费本地语音转文字pipinstallfaster-whisperCLI 中按CtrlB录音使用/voice tts让 Hermes 语音回复支持 CLI、Telegram、Discord 及 Discord 语音频道4.8 ACP 编辑器集成Hermes 可作为 ACP 服务器运行兼容 VS Code、Zed、JetBrains 等编辑器。编辑器可以注册自己的 MCP 服务器Hermes 会将其作为额外的智能体工具。五、常用命令速查5.1 核心命令命令说明hermes启动对话hermes setup完整配置向导hermes model选择/切换 LLM 提供者和模型hermes tools配置工具hermes doctor诊断安装问题hermes logs查看和过滤日志5.2 网关命令命令说明hermes gateway setup交互式平台配置hermes gateway start启动网关服务5.3 技能命令命令说明hermes skills search query搜索技能hermes skills install skill安装技能hermes skills inspect skill安全审查技能hermes skills check检查上游变更hermes skills update更新已安装技能5.4 配置命令命令说明hermes config set key value设置配置项hermes config show显示当前配置hermes config migrate迁移配置5.5 迁移命令从 OpenClawhermes claw migrate# 交互式迁移hermes claw migrate --dry-run# 预览迁移内容hermes claw migrate--presetuser-data# 仅迁移用户数据hermes claw migrate--overwrite# 覆盖已有冲突六、安全机制6.1 命令审批危险命令执行前需要用户审批CLI 中需要手动/approveTelegram 和 Slack 支持原生按钮审批容器硬化和命名空间隔离6.2 记忆安全记忆条目写入前扫描注入和窃取模式匹配威胁模式提示注入、凭据窃取、SSH 后门或包含不可见 Unicode 字符的内容会被阻止6.3 技能安全Hub 安装的技能通过安全扫描器检查检查项目包括数据窃取、提示注入、破坏性命令、供应链信号--force可覆盖非危险的策略阻止但无法覆盖危险扫描结论官方可选技能official/...视为内置信任级别6.4 MCP 安全MCP OAuth 2.1 PKCE 标准认证通过 OSV 漏洞数据库自动扫描 MCP 扩展包七、高级功能7.1 子智能体Subagents隔离的子智能体拥有独立的对话上下文、终端和 Python RPC 脚本实现零上下文成本的管道处理。适合将复杂任务分解为并行子任务。7.2 浏览器自动化Camofox 反检测浏览器后端使用 Camoufox 实现隐身浏览持久会话VNC URL 发现用于可视化调试可配置 SSRF 旁路通过hermes tools自动安装7.3 研究与训练功能批量轨迹生成为训练生成大量智能体交互轨迹Atropos RL 环境强化学习训练环境轨迹压缩训练下一代工具调用模型7.4 API 服务器集成与 Open WebUI 集成实时流式传输工具进度事件支持X-Hermes-Session-Id头部实现持久会话会话持久化到共享 SessionDB7.5 日志系统结构化日志输出到~/.hermes/logs/agent.log完整日志errors.log错误日志通过hermes logs命令查看和过滤7.6 多实例Profiles支持配置多个实例 Profile可以运行多个独立的 Hermes Agent 实例。八、配置文件参考主配置文件位于~/.hermes/config.yaml。关键配置目录结构~/.hermes/ ├── config.yaml # 主配置文件 ├── .env # 环境变量API Keys ├── memories/ │ ├── MEMORY.md # 智能体记忆 │ └── USER.md # 用户画像 ├── skills/ # 技能目录 ├── sessions/ # 会话数据 ├── logs/ # 日志 │ ├── agent.log │ └── errors.log ├── cron/ # 定时任务 ├── hooks/ # 钩子 ├── state.db # SQLite 会话存储 └── whatsapp/session/ # WhatsApp 会话九、生态系统与社区资源9.1 核心资源官方文档: https://hermes-agent.nousresearch.com/docsGitHub 仓库: https://github.com/NousResearch/hermes-agentSkills Hub: 社区贡献的技能市场Discord 社区: Nous Research Discord9.2 推荐社区项目项目说明awesome-hermes-agent精选技能、工具、集成和资源列表hermes-workspaceHermes 原生工作空间聊天、终端、技能管理器mission-control智能体编排仪表盘舰队管理、任务调度、成本追踪wondelai/skills跨平台技能库380 starsautonovel基于 Hermes 的自主小说写作管道9.3 最佳实践从简单开始先跑通 quickstart再逐步添加功能精心维护记忆将 USER.md 和 MEMORY.md 视为高信号基础设施保持条目简洁、持久、聚焦偏好使用沙箱后端生产环境中推荐 Docker 或 SSH 后端而非 Local定期检查技能更新hermes skills check追踪上游变更外部记忆推荐如果需要自动化结构化记忆提取Hindsight 是推荐的首选提供者本地运行、无持续成本、在 LongMemEval 上得分最高十、快速上手流程# 1. 一键安装curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# 2. 重新加载 Shellsource~/.bashrc# 3. 启动对话安装过程中已配置 LLM 提供者hermes# 4. 尝试基本功能# 在对话中输入任何任务例如# 帮我搜索最近的 AI 新闻并总结# 每天早上 9 点发送 Hacker News AI 摘要到 Telegram# 5. 配置消息平台可选hermes gateway setup hermes gateway start# 6. 切换到安全后端推荐hermes configsetterminal.backenddocker# 7. 安装实用技能hermes skills search kubernetes hermes skillsinstallopenai/skills/k8s十一、版本历史亮点v0.7.0 主要更新Camofox 反检测浏览器后端内联 Diff 预览API 服务器会话连续性与工具流式传输ACP 客户端提供的 MCP 服务器非活跃超时改进追踪实际工具活动而非墙钟时间Telegram/Slack 原生审批按钮MCP OAuth 2.1 PKCE OSV 恶意软件扫描集中式日志与配置验证