Hermes Agent 完全技术参考手册：从入门到生产部署 **适用对象**：开发者、AI工程师、DevOps运维、技术管理者 **核心定位**：会自我进化的开源 AI Agent 框架 —— 从"会说"走向"会做"

**阅读时间**：29437字，约 75 分钟【适合收藏PC端阅读】** ** **一句话判断**：Hermes 代表 AI 从"问答"走向"行动"的关键范式。

【完整内容已经整理成PDF，移步文末小程序下载】一、Hermes Agent 是什么1.1 定义与核心定位 Hermes Agent 是 **Nous Research** 开源的 AI Agent 框架。它不是一个聊天机器人——它是一个能在你的终端、消息平台（Telegram、Discord、Slack、飞书、微信等 **10+ 平台**）和 IDE 里自主运行的执行代理。 根据清华大学清新研究团队 2026 年 4 月发布的《Hermes Agent 深度研究报告》的核心判断： **Hermes Agent 是"可执行型 AI Agent"的代表形态。** 其核心价值在于把大模型的语言理解能力扩展为真实世界中的任务执行能力。未来 AI 产品的关键分野，不是"谁更会回答"，而是"谁更能完成任务"。 AI 产品的形态正在经历第三次跃迁： • **第一次**：Chatbot —— 回答问题、生成内容，止步于文本 • **第二次**：Copilot —— 嵌入单一工作流，局部建议，不承担完整任务链 • **第三次**：Agent —— 接收目标，自主拆解任务，调用工具，执行验证，交付结果 Hermes 站的就是第三阶段。它能分析整个仓库结构、读懂代码逻辑、修改多个文件、跑测试、整理文档，最后给你一个可以直接合并的 PR。1.2 核心差异化能力 维度 传统 Agent 框架 Hermes Agent**核心理念** 功能清单堆砌 自改进学习循环**记忆系统** 向量记忆（AutoGPT）/ 无持久记忆（LangChain） 三层记忆：会话 + 持久化 + Skill**技能沉淀** 人工编写和维护 Agent 自动创建 + 自改进**执行深度** 单次调用、简单链式 多步规划、工具编排、状态管理**部署方式** 云端锁定 本地优先、模型无关、数据主权 **核心差异化五要素**： 1. **Skill（技能）系统** —— 解决过的问题沉淀为可复用技能，越用越聪明。社区已建立 awesome-hermes-agent 仓库聚合共享技能，上线 2 周即破 1.2K Stars。 2. **持久记忆** —— 跨会话记住你是谁、你的偏好、环境信息。MEMORY.md 直接可读，用户可编辑/删除记忆条目。 3. **多平台网关** —— 同一套 Agent 跑在 Telegram、Discord、Slack、飞书、微信等 **10+ 平台**上。 4. **模型无关** —— 兼容 **200+ 模型**（OpenAI/Anthropic/Gemini/MiniMax/月之暗面 Kimi/智谱 GLM 等），随时切换，无需改代码，无云端锁定。 5. **Profile 隔离** —— 多实例隔离，不同工作场景用不同的 profile。1.3 自学习循环：四步闭环 这是 Hermes 2026 年唯一具备的能力，也是其护城河所在： ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ STEP 1 │ → │ STEP 2 │ → │ STEP 3 │ → │ STEP 4 │ │ 感知任务 │ │ 执行行动 │ │ 沉淀技能 │ │ 更新记忆 │ │ │ │ │ │ │ │ │ │ 解析用户指令 │ │ 调用40+工具 │ │ 成功路径固化 │ │ FTS5写入 │ │ 决定调用工具 │ │ 完成任务 │ │ 为可复用技能 │ │ MEMORY.md │ │ │ │ 记录上下文 │ │ │ │ 下次直接调取 │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘

**解数咨询 × D17 品牌研究报告** 的核心判断：传统 Agent 框架（LangChain 手工编排、AutoGPT 向量记忆）都是"一次性执行"，Hermes 的差异化是"自学习循环"——**感知任务 → 执行行动 → 沉淀技能 → 更新记忆**，四步循环让 Agent 越用越聪明。二、安装与初始配置2.1 五种部署形态 Hermes 支持五种后端部署形态，覆盖从个人开发到企业生产的全场景： 部署方式 适用场景 特点**本地原生** macOS/Linux/WSL2 最简单，3 分钟安装**Docker** 容器化隔离 生产环境推荐，沙箱化终端后端**SSH 远端** 远程服务器执行 适合 VPS 7×24 在线**Singularity** HPC 集群兼容 科研/高性能计算场景**Modal** Serverless 弹性 按需扩缩容2.2 快速安装（三种方式） **方式一：pip 安装（快速体验）** # 最简单，适合快速体验，功能完整但定制性有限 pip install hermes-agent

初始化向导 hermes setup

**方式二：官方一键脚本（推荐）** # 单行 curl 安装，3 分钟搞定 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

初始化向导 hermes setup

**方式三：Docker 部署（生产环境推荐）** # 拉取官方镜像 docker pull nousresearch/hermes-agent

运行容器（挂载本地配置目录，保持状态持久化） docker run -d \ --name hermes \ -v ~/.hermes:/root/.hermes \ -v /opt/data:/opt/data \ -e DASHSCOPE_API_KEY=your_key \ -e ANTHROPIC_API_KEY=your_key \ nousresearch/hermes-agent

进入容器交互 docker exec -it hermes hermes

**注意**：Docker 部署时挂载 /opt/data 目录到宿主机，可以保持状态持久化。多设备之间可用网盘定期同步 ~/.hermes/ 目录（不推荐实时同步 SQLite，但定期拷贝没问题）。 **方式四：从源码构建（深度定制）** git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent pip install -e .

适合修改核心逻辑、添加自定义 Tool 的开发者 2.3 健康检查与故障修复 # 第一次跑完后执行，检查依赖和配置是否完整 # --fix 会自动修复常见问题 hermes doctor --fix 2.4 关键路径速查 路径 作用~/.hermes/config.yaml 主配置文件~/.hermes/.env API 密钥和敏感信息$HERMES_HOME/skills/ 已安装的技能（107+ 个）~/.hermes/state.db 会话存储（SQLite + FTS5 全文搜索）~/.hermes/logs/ 网关和错误日志~/.hermes/memory.db 持久化记忆数据库~/.hermes/profiles/ 多实例配置隔离目录三、推荐的 Skills（技能） Hermes 目前有 **107+ 个技能**、**40+ 内置工具**。以下是实际使用中最值得安装和使用的，按场景分类：3.1 开发效率类 技能 用途 推荐指数 核心场景systematic-debugging 四阶段根因调试法：重现 → 定位 → 修复 → 验证 ⭐⭐⭐⭐⭐ 遇到 bug 先看这个，避免盲目改代码writing-plans 写实现计划，把大任务拆成可执行的小步骤，存到 .hermes/plans/ ⭐⭐⭐⭐⭐ 复杂任务拆解github-pr-workflow GitHub PR 全流程：分支、提交、打开、CI、合并 ⭐⭐⭐⭐ 自动化代码协作github-code-review PR 代码审查，支持 diff 和内联评论 ⭐⭐⭐⭐ 代码质量门禁codebase-inspection 用 pygount 分析代码库：行数、语言、比例 ⭐⭐⭐ 技术债评估requesting-code-review 提交前自动审查：安全扫描、质量门控、自动修复 ⭐⭐⭐⭐ 预提交检查 **安装示例**： # 搜索技能 hermes skills search debug

安装技能 hermes skills install systematic-debugging

查看技能详情 hermes skills view systematic-debugging

预加载多个技能启动对话 hermes -s systematic-debugging -s writing-plans -s github-code-review 3.2 内容创作类 技能 用途 推荐指数 核心场景humanizer 去除 AI 写作痕迹，让文本读起来像人写的 ⭐⭐⭐⭐⭐ 发布前必做tech-article-writing 技术文章写作：对比文章、工具介绍、分析类内容 ⭐⭐⭐⭐⭐ 技术博客/公众号architecture-diagram 暗色主题 SVG 架构/云/基础设施图 ⭐⭐⭐⭐ 技术方案可视化baoyu-image-gen AI 图片生成（支持 OpenAI、DashScope、Google 等多个后端） ⭐⭐⭐⭐ 配图生成baoyu-slide-deck 从内容生成专业 PPT 图片 ⭐⭐⭐⭐ 汇报材料obsidian Obsidian 笔记管理：读取、搜索、创建、编辑 ⭐⭐⭐⭐ 知识库联动3.3 研究与信息收集类 技能 用途 推荐指数 核心场景tavily-search Tavily API 网络搜索，返回精炼结果和摘要 ⭐⭐⭐⭐⭐ 高质量搜索multi-search-engine**17 个搜索引擎集成** （8 国内 + 9 国际），无需 API Key ⭐⭐⭐⭐ 多源信息聚合arxiv arXiv 论文搜索：关键词、作者、分类 ⭐⭐⭐⭐ 学术研究blogwatcher 监控博客和 RSS/Atom 订阅源 ⭐⭐⭐ 信息监控tech-repo-research 研究 GitHub 仓库并生成对比/概览文章 ⭐⭐⭐⭐ 技术选型youtube-content YouTube 转录转摘要、Thread、博客 ⭐⭐⭐ 视频内容处理3.4 自动化与运维类 技能 用途 推荐指数 核心场景hermes-agent Hermes 自身配置、扩展、贡献的全套指南 ⭐⭐⭐⭐⭐ 元技能self-improvement 自我改进：捕获错误、纠正和新发现的工作流 ⭐⭐⭐⭐⭐ 持续进化openclaw-auto-updater 定时自动更新 Hermes 和技能，带可靠的重试机制 ⭐⭐⭐⭐ 维护自动化kanban-worker Kanban 工作流指南，多 Agent 协作任务 ⭐⭐⭐ 团队协作webhook-subscriptions Webhook 订阅：事件驱动的 Agent 运行 ⭐⭐⭐ CI/CD 触发3.5 媒体与生活类 技能 用途 推荐指数spotify Spotify 播放、搜索、队列、播放列表管理 ⭐⭐⭐gif-search Tenor GIF 搜索/下载 ⭐⭐⭐songwriting-and-ai-music 歌曲创作和 Suno AI 音乐提示词 ⭐⭐⭐imessage macOS 上收发 iMessage/SMS ⭐⭐apple-reminders Apple 提醒事项管理 ⭐⭐四、Context Files 上下文文件 这是 Hermes 一个非常实用的功能——通过项目根目录的约定文件，让 Agent 每次自动加载你的项目规则和偏好。这是 **Harness Engineering**（缰绳工程）方法论的产品化实现。4.1 支持的文件 Hermes 会自动发现并加载以下文件： 文件名 用途 推荐内容 兼容性AGENTS.md 项目级指令 “用 pytest，不要用 unittest”、“API 在 /api/v2” Hermes 原生CLAUDE.md 兼容 Claude Code 的指令 代码规范、目录结构说明 Claude Code / HermesSOUL.md Agent 人格和行为准则 沟通风格、决策偏好、底线原则 OpenClaw / Hermes.cursorrules 兼容 Cursor 的规则 IDE 行为偏好 Cursor / Hermes.hermes.md Hermes 专属指令 特定于 Hermes 的工作流配置 Hermes 原生4.2 AGENTS.md 最佳实践 如果你发现自己在重复同样的指令——“用 tab 不用空格”、“我们跑 pytest”、“API 地址是 /api/v2”——把它们写进 AGENTS.md，Agent 每次会话自动读取，**零额外成本**。 **示例 AGENTS.md**： # 项目约定

技术栈 - 测试框架：pytest，不用 unittest - 代码风格：4 空格缩进，行宽 88（Black 默认） - API 版本：当前使用 v2，路径 /api/v2/ - 数据库：PostgreSQL 15+ - 包管理：uv，不用 pip - 提交信息：Conventional Commits 格式

架构约束 - 所有 API 路由必须带版本前缀 - 数据库迁移使用 Alembic - 异步任务使用 Celery + Redis

审查重点 - 安全检查：SQL 注入、XSS、CSRF - 性能检查：N+1 查询、内存泄漏 - 忽略：格式问题（Black 自动处理） 4.3 SOUL.md 最佳实践 SOUL.md 定义 Agent 的"人格"——沟通风格、决策偏好、底线。这是 **Harness Engineering** 中"指令层"的核心载体。 **示例 SOUL.md**： # SOUL

沟通风格 - 直接，不绕弯子，用中文 - 技术讨论用英文术语，解释用中文

决策偏好 - 遇到不确定的事情：先问我，不要自己猜 - 技术选型：优先成熟方案，不追新 - 代码审查：重点看安全和性能，格式问题忽略

底线原则 - 如果要求不合理，直接拒绝并说明原因 - 不执行删除生产数据的命令，除非双重确认 - 涉及密钥的操作必须脱敏处理 4.4 Context References 在对话中用 @ 引用文件、文件夹、git diff 和 URL，Hermes 会自动展开内容： # 引用项目约定文件 > @AGENTS.md 帮我看看这个架构设计是否符合项目约定

引用代码目录 > @src/auth/ 审查认证模块的代码

引用 git diff > @git diff 看看这次变更的影响范围

引用 URL > @https://api.example.com/docs 根据这个 API 文档生成客户端代码 4.5 文件大小限制与截断策略 限制 值 说明 单文件最大字符数 20,000（约 7,000 tokens） 超过后自动截断 头部保留比例 70% 保留文件开头的重要信息 尾部保留比例 20% 保留文件结尾的关键代码 截断标记 10% 显示字符数并建议使用文件工具 **截断示例**： [文件内容已截断：共 45,000 字符，显示 20,000 字符] [头部 14,000 字符 | 尾部 4,000 字符 | 中间 27,000 字符已省略] [建议使用 @filename 或 file_read 工具获取完整内容] 五、日常使用最佳实践5.1 启动与对话模式 # 交互式对话（默认模式） hermes

单次查询，适合脚本调用 hermes chat -q "帮我分析这段代码的问题"

指定模型（支持 200+ 模型热切换） hermes chat -m anthropic/claude-sonnet-4

切换到国产模型（如 Kimi） hermes model use kimi-k2 # 输出：✓ Switched. API key loaded from $KIMI_API_KEY.

预加载特定技能 hermes -s systematic-debugging -s writing-plans

恢复最近会话 hermes --continue

恢复指定会话 hermes --resume 20260526_143052_abc123

**模型切换成本对比**（每复杂任务）： 模型组合 单任务成本 平均耗时 适用场景 Claude Sonnet 4.6 $0.45 28s 复杂推理 / 长任务 GPT-4o-mini $0.12 19s 日常自动化 Kimi K2 / GLM-4 ¥0.6 ≈ $0.08 24s 中文场景首选 本地 Qwen3-32B $0.00 42s 完全离线 / 隐私场景5.2 对话内的斜杠命令 命令 作用 使用场景/new 新建会话 开始新任务/model 查看或切换模型 根据任务复杂度换模型/tools 管理工具集 开启/关闭特定工具/skills 搜索、安装、管理技能 动态扩展能力/usage 查看 token 使用量 成本控制/config 查看当前配置 调试配置问题/insights 使用分析 优化使用模式/compress 手动压缩上下文 长对话优化/yolo 跳过所有确认（危险） 自动化脚本模式5.3 工具集管理 工具集的开启/关闭用 hermes tools 命令： # 交互式管理（推荐） hermes tools

启用某个工具集 hermes tools enable web

禁用某个工具集 hermes tools disable browser

查看当前启用的工具集 hermes tools list

**重要**：工具集变更后需要 /reset 或新建会话才能生效。这是为了保护 prompt 缓存——会话中途改工具会打断缓存命中，导致 token 成本上升。 **40+ 内置工具能力图谱**： 工具分类 数量 代表工具 社区使用率 Web 搜索与抓取 8browser.navigate , web.search 62%, 48% 系统/Shell 6shell.exec 28% 记忆与技能 4memory.save 41% 视觉与多模态 5vision.analyze 33% MCP 扩展 4 6000+ MCP 工具 - **浏览器自动化（旗舰能力）**： • 导航 / 点击 / 输入 / 截图 / 抓取 • 支持多云端（Browserbase / Browser Use / Firecrawl）与本地 CDP • 内置随机指纹反检测与 CAPTCHA 求解 • 每个任务会话隔离 **视觉与多模态**： • 内置视觉分析（基于 Claude / GPT-4V） • 图像生成（DALL-E / SDXL） • 文本转语音（TTS） • 与浏览器工具组合可实现"看截图 → 决策 → 操作"完整链路5.4 多模型切换策略 Hermes 支持 **20+ 个提供商、200+ 模型**，切换非常方便： # 交互式选择 hermes model

命令行直接设置 hermes config set model.default anthropic/claude-sonnet-4

对话内临时切换 /model anthropic/claude-sonnet-4

查看可用模型列表 hermes model list

**推荐做法**： • **日常查询**：用性价比高的模型（如 Claude Sonnet 4、Kimi K2） • **复杂任务**：切到更强大的模型（Claude Opus、GPT-4o） • **简单查询**：用便宜的模型（GPT-4o-mini、本地模型） • **中文场景**：优先 Kimi K2 或 GLM-4，成本更低且理解更准确 **成本优化公式**： 复杂任务平均成本 ~0.30，VPS常驻成本0.30，VPS 常驻成本0.30，VPS常驻成本5-10/月，本地数据全权管控，单行 curl 安装耗时 3 分钟。六、Memory（记忆）系统 Hermes 的持久记忆是核心亮点之一。根据清华大学研究报告，这是 **三层记忆架构**：6.1 三层记忆架构 ┌─────────────────────────────────────────────────────────────┐ │ 三层记忆系统架构 │ ├──────────────┬──────────────┬───────────────────────────────┤ │ 第一层：会话记忆 │ 第二层：持久记忆 │ 第三层：Skill 记忆 │ │ (短期记忆) │ (长期记忆) │ (程序性记忆) │ ├──────────────┼──────────────┼───────────────────────────────┤ │ 当前对话上下文 │ 跨会话用户画像 │ 自动提炼反复做的事 │ │ 滚动窗口管理 │ 偏好、习惯、环境 │ 生成可复用 Skill │ │ 关了对话就没了 │ MEMORY.md 持久化 │ 用越久 Skill 越多，效率越高 │ │ │ 用户可编辑/删除 │ │ └──────────────┴──────────────┴───────────────────────────────┘ ↓ ┌─────────────────┐ │ Honcho 用户建模 │ │ 动态画像，每次交互 │ │ 都在更新"你是谁" │ └─────────────────┘

**与全量加载记忆方案的对比**： 维度 全量加载（传统方案） 按需检索（Hermes） 上下文占用 随对话增长线性膨胀 基本恒定 检索精度 什么都在，什么都找不到 按关键词精准匹配 长期可用性 几天后就撑不下了 可以用几个月甚至几年 响应速度 越来越慢 基本不变6.2 自动记忆的内容 Agent 会在对话中自动保存以下信息： 类型 示例 存储位置**用户画像** 名字、角色、偏好、沟通风格memory.db**环境信息** 操作系统、已安装工具、项目结构memory.db**工具特性** 某个工具的坑、特殊用法memory.db**约定和规范** 项目约定、API quirks、工作流偏好AGENTS.md / memory.db6.3 记忆管理命令 # 查看/设置记忆 hermes memory status

查看记忆内容（可直接编辑） cat ~/.hermes/memory.db

关闭记忆（不推荐） hermes config set memory.memory_enabled false

导出记忆备份 cp ~/.hermes/memory.db ~/hermes-memory-backup-$(date +%Y%m%d).db 6.4 记忆的最佳用法 1. **主动纠正** —— 当 Agent 犯错时，直接说「记住，以后别这样」，它会把纠正存到记忆里 2. **环境发现** —— Agent 发现你的项目约定、目录结构等会自动记录，下次不用重复说 3. **偏好沉淀** —— 沟通风格、代码风格、工具偏好等会被自动学习 4. **别存临时信息** —— 任务进度、PR 号、session 状态这些不要存到记忆里，它们很快过期 **记忆持久化技巧**： # 把 ~/.hermes/ 备份到 U 盘，换台电脑继续用 cp -r ~/.hermes /mnt/usb/hermes-backup

Docker 部署时挂载数据目录 docker run -v ~/.hermes:/root/.hermes -v /opt/data:/opt/data ...

多设备之间用网盘定期同步（不推荐实时同步 SQLite） rsync -av ~/.hermes/ ~/Dropbox/hermes-sync/ 七、Session（会话）管理7.1 浏览和搜索 # 列出最近会话 hermes sessions list

交互式选择器（推荐） hermes sessions browse

导出会话 hermes sessions export ~/my-sessions.jsonl

重命名会话 hermes sessions rename "我的项目名称"

清理旧会话（保留最近 30 天） hermes sessions prune --older-than 30 7.2 会话搜索 在对话中使用 session_search 工具可以搜索过去的对话： # 发现模式：搜索主题 session_search(query="auth refactor", limit=3)

滚动模式：读取某段对话的完整上下文 session_search(session_id="20260526_143052_abc123", around_message_id=42)

浏览模式：浏览最近的会话列表 session_search() 八、上下文压缩机制 这是 Hermes 解决上下文窗口问题的核心能力。很多 Agent 的做法是简单截断旧消息，但 Hermes 用的是 **结构化压缩**。8.1 双层压缩系统 Hermes 使用两层压缩机制，故意错开触发阈值： 层级 触发时机 作用 设计意图**Agent 压缩层** 上下文窗口使用率达 **50%** 理解对话结构，保留语义连贯性 主动优化，保持流畅**Gateway 安全网** 上下文窗口使用率达 **85%** 防止溢出，兜底保护 最后一道防线 两层故意错开——如果都设成 50%，每轮对话都会过早压缩，影响体验；如果都设成 85%，没有提前优化的空间。8.2 压缩策略 策略 说明 效果**压缩，不截断** 丢掉旧消息会丢失信息。Hermes 的压缩器理解对话结构，保留语义连贯性 信息保留率 > 90%**渐进式披露** Skills、工具、上下文文件都有元数据层，按需加载完整内容 Token 开销降低 40%+**预算作为一等概念** 迭代次数、token 数、时间，Agent 需要预算管理和压力警告 成本可控**保留叙事连续性** 压缩后仍然保持故事线的完整 对话不突兀8.3 Prompt Caching Hermes 利用 **Anthropic prompt caching** 来提升长对话的效率。当压缩触发时，缓存系统会： 1. 保留最近的真实用户消息（不可压缩，确保响应针对性） 2. 压缩中间的工具调用历史（可压缩，保留结果摘要） 3. 重新注入初始上下文（AGENTS.md、SOUL.md 等）8.4 手动压缩与配置 # 对话内手动触发 /compress

查看当前压缩配置 hermes config get compression

调整压缩配置 hermes config set compression.enabled true hermes config set compression.threshold 0.50 hermes config set compression.target_ratio 0.20

查看压缩统计 hermes config get compression.stats 九、Cron 定时任务 这是 Hermes 最实用的功能之一，让 Agent 实现 **7×24 小时无人值守**。9.1 创建定时任务 # 每 30 分钟执行 hermes cron create "30m"

每天早上 9 点 hermes cron create "0 9 * * *"

每周一上午 9 点 hermes cron create "every monday 9am"

每 5 分钟检查系统状态 hermes cron create "5m" 9.2 管理任务 # 列出所有任务 hermes cron list

编辑任务 hermes cron edit

暂停/恢复 hermes cron pause hermes cron resume

手动触发 hermes cron run

删除任务 hermes cron remove

查看任务日志 hermes cron logs 9.3 实用场景 场景 配置示例 成本估算**日报生成** 每天早上 9 点自动汇总昨天完成的工作 ~$0.05/天**监控告警** 每 5 分钟检查磁盘/CPU/内存，超阈值发消息 ~$0.02/天**内容更新** 定期更新 RSS 订阅源并生成摘要 ~$0.10/天**技能维护** 定时检查和更新已安装的技能 ~$0.03/天**SEO 监控** 每天 9:00 抓取 10 个关键词 → vision 校验 → memory 对比 → Slack 推送 ~$0.18/次 **典型 Agent 工作流示例：每日 SEO 监控** ① cron 触发 → ② browser 抓取 → ③ vision 校验 → ④ memory 对比 → ⑤ Slack 推送 每天 9:00 10 个关键词排名 截图防止反爬误判 昨日数据 diff 异常告警 ↓ 首次执行后 Hermes 会沉淀 skill:seo_daily_check 后续直接命中，无需重复配置 9.4 高级用法（YAML 配置） # ~/.hermes/cron/jobs/seo-monitor.yaml name:"每日 SEO 监控" schedule:"0 9 * * *" model:"anthropic/claude-sonnet-4"# 指定每任务的模型 skills: ["tavily-search", "tech-article-writing"] # 预加载技能 enabled_toolsets: ["web", "browser", "memory"] # 限制工具集，减少 token 开销 script:"scripts/seo_check.py"# 脚本预运行收集数据 workdir:"/path/to/project"# 工作目录（加载该目录的 AGENTS.md/CLAUDE.md） no_agent:false# 是否纯脚本模式（不调用 LLM）

链式任务：Job A 收集数据 → Job B 处理 → Job C 推送通知 context_from:"data-collection-job"# 继承上游任务的上下文 十、Profile（配置文件）系统10.1 什么是 Profile Profile 让你在同一台机器上运行多个完全独立的 Hermes 实例。每个实例有自己的： • 配置（config.yaml） • 技能（skills/） • 记忆（memory.db） • 会话（sessions/） • API 密钥（.env） 这是 **多租户隔离** 在本地 Agent 层面的实现。10.2 使用场景 Profile 类型 安装技能 连接平台 适用场景**内容创作**humanizer , tech-article-writing, baoyu-image-gen 飞书/微信公众号 自媒体运营**开发**systematic-debugging , github-pr-workflow, codebase-inspection GitHub 软件研发**家庭自动化**spotify , apple-reminders, imessage Home Assistant 智能家居**研究**arxiv , tavily-search, tech-repo-research Slack 学术研究10.3 操作命令 # 列出所有 profile hermes profile list

创建新 profile hermes profile create content-builder

从现有 profile 克隆（继承配置和技能） hermes profile create content-builder --clone dev-profile

切换 profile hermes profile use content-builder

查看 profile 详情 hermes profile show my-profile

删除 profile hermes profile remove old-profile

**Profile 目录结构**： ~/.hermes/ ├── profiles/ │ ├── default/ │ │ ├── config.yaml │ │ ├── .env │ │ ├── skills/ │ │ ├── memory.db │ │ └── sessions/ │ ├── content-builder/ │ │ ├── config.yaml │ │ ├── .env │ │ ├── skills/ │ │ │ ├── humanizer/ │ │ │ ├── tech-article-writing/ │ │ │ └── baoyu-image-gen/ │ │ ├── memory.db │ │ └── sessions/ │ └── dev/ │ ├── config.yaml │ ├── .env │ ├── skills/ │ │ ├── systematic-debugging/ │ │ ├── github-pr-workflow/ │ │ └── codebase-inspection/ │ ├── memory.db │ └── sessions/ 十一、Gateway（消息平台网关） Hermes 可以连接 **10+ 消息平台**，让 Agent 随时在线。11.1 支持的平台 平台 用户规模 说明 成熟度**Telegram** 9.5 亿 最成熟，推荐首选 ⭐⭐⭐⭐⭐**Discord** 2 亿+ 支持 Bot 和 DM ⭐⭐⭐⭐**Slack** 3200 万 企业场景 ⭐⭐⭐⭐**WhatsApp** 20 亿+ 需要第三方提供商 ⭐⭐⭐**Signal** 7000 万 隐私优先 ⭐⭐⭐**Email** 通用 IMAP/SMTP ⭐⭐⭐**Matrix** 开源协议 去中心化 ⭐⭐⭐**Home Assistant** 智能家居 设备控制 ⭐⭐⭐**API Server** - Open WebUI 等 ⭐⭐⭐⭐**微信** 13 亿+ 国内生态 ⭐⭐⭐11.2 启动网关 # 前台运行（调试用） hermes gateway run

安装为后台服务（推荐） hermes gateway install

启动/停止/重启 hermes gateway start hermes gateway stop hermes gateway restart

查看状态 hermes gateway status

配置平台 hermes gateway setup 11.3 网关最佳实践 1. **安装为系统服务** —— hermes gateway install，这样重启后自动运行 2. **设置 Home Channel** —— 在对话中用 /sethome 设置主消息通道 3. **SSH 断线保护** —— 如果通过 SSH 管理，开启 linger： sudo loginctl enable-linger $USER

4. **WSL2 用户注意** —— 需要在 /etc/wsl.conf 中设置 systemd=true十二、Security（安全）最佳实践12.1 命令审批机制 # 智能审批（推荐）——低风险命令自动放行，高风险仍需确认 hermes config set approvals.mode smart

手动审批（默认）——每次危险命令都确认 hermes config set approvals.mode manual

关闭审批（不推荐，仅用于完全受信环境） hermes config set approvals.mode off

YOLO 模式（跳过所有确认，危险） hermes --yolo # 或 export HERMES_YOLO_MODE=1 # 或对话内 /yolo

**注意**：YOLO 模式不会关闭密钥脱敏，两者是独立的。redact_secrets 始终生效。12.2 密钥泄露保护 # 开启密钥自动脱敏 hermes config set security.redact_secrets true

开启后，Agent 在工具输出中看到 API Key、Token 等敏感信息会自动打码。 **注意**：这个配置需要新会话才会生效，中途切换不生效——这是故意的，防止 LLM 自己改配置绕过保护。 **脱敏示例**： # 开启前 Error: API call failed with key sk-abc123def456ghi789

开启后 Error: API call failed with key sk-***[REDACTED]*** 12.3 网站屏蔽 # 在 config.yaml 中添加屏蔽列表 hermes config set security.website_blocklist "['bad-site.com', 'malicious.org', 'phishing.example.com']" 12.4 工具级隔离 通过 hermes tools 关闭不需要的工具集，比如在生产环境中关闭 terminal 和 browser，只保留 file 和 web： # 生产环境最小权限配置 hermes tools disable terminal hermes tools disable browser hermes tools enable file hermes tools enable web hermes tools enable memory 十三、Kanban 多 Agent 协作看板 这是 Hermes 最强大的高级用法之一——用看板系统把多个 Profile（独立 Agent 实例）组织成一个协作团队。13.1 什么是 Kanban Hermes Kanban 是一个基于 SQLite 的持久化任务看板。你可以： • 创建任务卡片，分配给不同的 Profile（相当于不同角色的 Agent） • 设置任务依赖关系——子任务等父任务完成自动进入 ready 状态 • 跟踪任务状态：todo → ready → running → done / blocked • 多个 Agent 并行工作，通过看板协调 • 完整的审计日志，所有操作持久化13.2 什么时候用 Kanban 满足以下任一条件就用看板，否则用 delegate_task 或者直接回答： 条件 说明 需要多个 specialist 研究员 + 工程师 + 审稿人 工作需要跨重启存活 长时间运行、重要任务 用户可能中途介入 human-in-the-loop 多个子任务可以并行执行 效率最大化 需要审查 / 迭代循环 质量保证 审计追踪很重要 合规要求13.3 Orchestrator（编排者）工作模式 编排者的核心规则：**只分解和派发，不自己干活**。 # Step 0: 发现可用的 Profile # hermes profile list

Step 1: 理解目标，画出任务依赖图

Step 2: 分解任务，每个 lane 对应一个 Profile

Step 3: 创建看板卡片，设置依赖关系

独立研究任务，可以并行 t1 = kanban_create( title="成本对比分析：AWS vs GCP vs Azure", assignee="researcher", # 研究角色的 Profile description="收集三家云厂商的定价数据，重点对比计算和存储", priority="high" )["task_id"]

t2 = kanban_create( title="性能基准测试：API 响应延迟", assignee="researcher", # 同一个 Profile，并行执行 description="使用 k6 压测，记录 P50/P95/P99 延迟", priority="high" )["task_id"]

综合任务，依赖 t1 和 t2 t3 = kanban_create( title="综合推荐报告：云厂商选型建议", assignee="analyst", description="基于研究结果，输出 5 页以内的选型建议报告", parents=[t1, t2], # 等两个研究都完成才启动 priority="medium" )["task_id"] 13.4 Worker（执行者）工作模式 Worker 的生命周期： Orient → Work → Heartbeat → Complete / Block ↓ ↓ ↓ ↓ 确认任务 执行工作 定期汇报进度 完成或阻塞等待 状态 在工作空间 "epoch 12/50, loss 0.31"

**好的完成报告示例**： kanban_complete( summary="限流器已交付 — 令牌桶算法，基于 user_id 键控，IP 作为备选，14 个测试通过", metadata={ "changed_files": ["rate_limiter.py", "tests/test_rate_limiter.py"], "tests_run": 14, "tests_passed": 14, "decisions": ["user_id 优先，未认证请求回退到 IP"], "performance": "P99 延迟 **代码类任务建议**： # 不要直接 complete，先 block 等待人工审查 kanban_block( task_id="code-refactor-123", reason="review-required: 请审查 rate_limiter.py 的实现，重点关注线程安全性", metadata={ "pr_url": "https://github.com/org/repo/pull/456", "changed_lines": 142, "test_coverage": "87%" } )

人工审查通过后，unblock 继续 kanban_unblock("code-refactor-123") 13.5 Dashboard 看板面板 Hermes 自带 Dashboard，提供以下能力： 功能 说明**实时状态** 所有任务的当前状态、执行进度**Recovery 面板** Worker 崩溃时的快速恢复操作**Reclaim** 立即中止运行中的 worker，重置为 ready**Reassign** 切换到另一个 Profile 重新执行**Change profile model** 修改 Profile 的模型配置后重试**告警标记** 任务失败或异常时显示 ⚠ 标记**审计追踪** 所有操作记录持久化，方便排查13.6 常用命令 # 初始化看板 hermes kanban init

创建任务 hermes kanban create "任务标题" --assignee researcher --priority high

列出任务 hermes kanban list hermes kanban list --status running hermes kanban list --assignee researcher

查看任务详情 hermes kanban show

完成任务 hermes kanban complete --summary "完成说明"

阻塞任务 hermes kanban block "需要人工确认的决策"

解除阻塞 hermes kanban unblock

追踪任务实时日志 hermes kanban tail

归档旧任务 hermes kanban archive 13.7 常见模式 模式 说明 适用场景**扇出 + 扇入** N 个研究任务并行 → 1 个综合任务汇总 数据收集 → 报告生成**并行实现 + 验证** 实现者做修改，同时验证者确认配置 代码重构**流水线** 规划者 → 实现者 → 审查者，每步依赖上一步 标准研发流程**同 Profile 队列** 多个任务分给同一个 Profile，串行执行积累经验 单一领域深度任务**Human-in-the-loop** 任何任务可以随时 block 等待人工输入 关键决策点13.8 避坑指南 坑 后果 解决方案 编造 Profile 名称 Dispatcher 对不存在的 assignee 静默失败，任务永远卡在 ready 先用 hermes profile list 确认 把独立任务绑在一起 两个独立结果要拆成两张卡 每个独立交付物一张卡 依赖关系别漏设 子任务在父任务完成前启动，导致错误 用 parents=[...] 确保顺序 用 delegate_task 替代 kanban_createdelegate_task 是会话内的短推理，重启后丢失 持久化协作必须用 kanban_create十四、高级技巧与隐藏用法14.1 子代理（Delegate Task） 让 Agent 派生独立的子代理来并行工作： # 单任务：指定一个目标，子代理独立执行 delegate_task( goal="分析 src/auth/ 目录的安全漏洞", assignee="security-reviewer", context="@src/auth/" )

批量并行：最多 3 个子代理同时运行（可配置） delegate_task( goal="并行审查三个模块", subtasks=[ {"goal": "审查 auth 模块", "context": "@src/auth/"}, {"goal": "审查 payment 模块", "context": "@src/payment/"}, {"goal": "审查 notification 模块", "context": "@src/notification/"} ], max_parallel=3 )

角色区分 # leaf（叶子节点，不能再派生）vs orchestrator（编排器，可以继续派生） delegate_task( goal="深度分析", role="leaf", # 防止无限递归 max_depth=1 )

**适用场景**：复杂的研究任务、代码审查、多文件重构。14.2 生成多个独立 Agent # 一次性任务（fire-and-forget） hermes chat -q "研究 GRPO 论文并写总结到 ~/research/grpo.md"

交互式 Agent（用 tmux 长期运行） tmux new-session -d -s agent1 'hermes' # 等待启动后发消息 tmux send-keys -t agent1 'Build a FastAPI auth service' Enter # 查看输出 tmux capture-pane -t agent1 -p

创建多个长期运行的 Agent tmux new-session -d -s researcher 'hermes -s arxiv -s tavily-search' tmux new-session -d -s developer 'hermes -s systematic-debugging -s github-pr-workflow' tmux new-session -d -s writer 'hermes -s tech-article-writing -s humanizer'

**适用场景**：需要 Agent 长时间自主工作的情况，比如搭建整个项目、跑 CI/CD 配置。14.3 MCP（Model Context Protocol）集成 MCP 让 Hermes 可以接入外部的工具和服务，这是扩展能力的关键方式。 # 添加 MCP 服务器 hermes mcp add my-server --command"npx -y @some/mcp-server"

使用本地 MCP 工具 hermes mcp add local-db --command"python /path/to/mcp-server.py"

列出已配置的服务器 hermes mcp list

测试连接 hermes mcp test my-server

选择工具（按需启用） hermes mcp configure my-server

查看 MCP 工具调用统计 hermes mcp stats

**MCP 生态规模**：Hermes 支持 **6000+ MCP 工具**，覆盖数据库、API、文件系统、版本控制等。14.4 Webhook 事件驱动 # 创建 Webhook 路由 hermes webhook subscribe github-push

配置触发规则 hermes webhook configure github-push --events push,pull_request

列出所有订阅 hermes webhook list

测试触发 hermes webhook test github-push --payload '{"ref": "refs/heads/main"}'

查看 Webhook 日志 hermes webhook logs github-push

**适合场景**：CI/CD 管道触发、GitHub 事件通知、外部系统推送等。14.5 上下文压缩（手动触发） # 自动压缩（默认开启） # 阈值：50% context 剩余时触发 # 目标：压缩到 20%

手动压缩 /compress

调整配置 hermes config set compression.enabled true hermes config set compression.threshold 0.50 hermes config set compression.target_ratio 0.20

查看压缩效果 hermes config get compression.last_run 14.6 实用技巧（来自官方文档和社区经验） **技巧 1：提问时一次性给足上下文** 与其分三轮说明问题，不如一开始就把文件路径、错误信息、预期行为全写上。Agent 能直接解析 traceback，不用你解释格式。 # 好的提问 帮我修 api/handlers.py 第 47 行的 TypeError——process_request() 从 parse_body() 收到了 None。 完整的 traceback 是： Traceback (most recent call last): File "api/handlers.py", line 47, in process_request body = parse_body() TypeError: ... 预期行为：当请求体为空时返回 400 Bad Request，而不是抛出异常。

差的提问 我的代码报错了，帮我看看。

**技巧 2：让 Agent 用自己的工具** 不要试图在对话中帮 Agent 读文件——直接让它用工具。你说"这个文件在 src/auth/auth.py"，它会去读；你贴内容，它只能看到你选的那部分。 **技巧 3：用 AGENTS.md 代替重复说明** 如果你每次都在说"用 pytest"、“我们跑 black”、“API 在 /api/v2”——写进 AGENTS.md，零额外成本。 **技巧 4：Skill 的渐进式加载** Skills 不是一次性加载全部内容。先通过 skills_list() 看到元数据，再 skill_view(name) 按需加载。这比把所有技能说明塞进 system prompt 省得多。 **技巧 5：Skill 的自进化** Reddit 上一个 Hermes 资深用户的经验：每次做完一件事，让 Agent 把它保存为 skill。 “一旦你成功走通一次，它就能变成可复用的 skill。之后这个能力就是你的了，不用每次重新教。” **技巧 6：每月审查 Skill 库** Agent 自己生成的 skill 存在 ~/.hermes/skills/。定期看看： # 看最近创建的 ls -lt ~/.hermes/skills/ | head -20

审查具体 skill cat ~/.hermes/skills/my-skill/SKILL.md

归档低质量 skill hermes skills archive my-skill

**技巧 7：本地模型也能用** Hermes 支持连接 Ollama、LM Studio 等本地模型。适合不需要联网、对隐私要求高的场景。 # 配置本地模型 hermes config set model.default ollama/llama3.1:8b

启动 Ollama 服务 ollama run llama3.1:8b

验证连接 hermes chat -q "你好" -m ollama/llama3.1:8b

**技巧 8：用 execute_code 压缩多步骤流程** execute_code 工具可以把多步骤工具调用链条压缩成单次推理调用。比如"搜索 → 下载 → 分析 → 生成报告"可以写成一个 Python 脚本，一次推理搞定。 # 多步骤压缩为单次执行 execute_code(""" import requests from bs4 import BeautifulSoup

1. 搜索 results = search("Python 性能优化 2026")

2. 下载前 3 个结果 articles = [] for url in results[:3]: resp = requests.get(url) articles.append(resp.text)

3. 分析 summary = analyze(articles, focus="performance")

4. 生成报告 report = generate_report(summary, template="tech-article") save(report, "~/articles/python-performance-2026.md") """) 十五、生产环境部署（VPS / Docker）15.1 VPS 部署方案 如果你打算让 Hermes 7×24 在线，跑在 VPS 上比本地机器靠谱得多。 **方案 A：Docker 容器部署（推荐生产环境）** # 拉取官方镜像 docker pull nousresearch/hermes-agent:latest

生产环境运行（带健康检查和自动重启） docker run -d \ --name hermes \ --restart unless-stopped \ -v ~/.hermes:/root/.hermes \ -v /opt/data:/opt/data \ -e DASHSCOPE_API_KEY=your_key \ -e ANTHROPIC_API_KEY=your_key \ -e HERMES_PROFILE=production \ -p 8080:8080 \ nousresearch/hermes-agent

查看日志 docker logs -f hermes

进入容器调试 docker exec -it hermes hermes

**方案 B：VPS 一键部署** 部分 VPS 提供商（如 Hostinger）支持一键部署 Hermes Agent。选 Ubuntu 24.04 LTS，安装脚本自动拉取最新版本、创建虚拟环境、生成 starter config.yaml。 # 手动一键部署（Ubuntu 24.04） curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash hermes setup hermes gateway install sudo systemctl start hermes-gateway

**方案 C：systemd 服务（长期运行）** # 创建 systemd 服务文件 sudotee /etc/systemd/system/hermes-gateway.service 15.2 Redis 调优（持久化记忆场景） 如果记忆使用 Redis 后端（高并发或多实例共享），建议： # redis.conf 推荐配置 appendonly yes appendfsync everysec maxmemory 2gb maxmemory-policy allkeys-lru 15.3 外部监控 用 UptimeRobot 等免费服务监控 Gateway： 配置项 值 URLhttp://your-server:8080/health Method GET Interval 5 minutes Alert Email or webhook on downtime # 测试健康端点 curl http://your-server:8080/health # 预期输出：{"status": "ok", "version": "2.1.0", "uptime": "3d 12h"} 15.4 防火墙配置 # 开放网关端口（按需修改） sudo ufw allow 8080/tcp

生产环境建议限制 IP（如仅允许公司内网） sudo ufw allow from 192.168.1.0/24 to any port 8080

拒绝其他来源 sudo ufw deny 8080/tcp 十六、推荐配置清单 以下是一份经过验证的推荐配置，融合了三篇研究报告的最佳实践： # ~/.hermes/config.yaml 推荐配置

模型配置 model: default:"anthropic/claude-sonnet-4"# 日常主力模型，性价比最优 fallback:"kimi-k2"# 中文场景备选 context_length:128000# 128K 上下文 temperature:0.3# 任务执行稳定性优先

Agent 行为 agent: max_turns:90# 单轮最大交互次数 reasoning:false# 默认不显示推理过程，减少噪音 show_cost:true# 显示成本，控制开销

压缩配置 compression: enabled:true threshold:0.50# 50% 触发 Agent 层压缩 target_ratio:0.20# 压缩到 20% gateway_threshold:0.85# 85% 触发 Gateway 安全网

显示配置 display: skin:"default" tool_progress:true# 显示工具执行进度 show_reasoning:false# 默认不显示推理过程 show_cost:true# 显示成本 language:"zh"# 中文输出

安全配置 security: redact_secrets:true# 开启密钥脱敏 website_blocklist:# 屏蔽危险网站 -"bad-site.com" -"malicious.org" tirith_enabled:false# 按需开启高级安全扫描

记忆配置 memory: memory_enabled:true user_profile_enabled:true backend:"sqlite"# 可选 sqlite / redis sync_interval:300# 每 5 分钟同步一次

审批配置 approvals: mode:"smart"# 智能审批，低风险自动放行 auto_approve:# 自动放行的命令白名单 -"ls" -"cat" -"grep" -"git status" -"pytest"

网关配置 gateway: enabled:true port:8080 platforms: -telegram -slack home_channel:"telegram"# 主消息通道

日志配置 logging: level:"info" file:"~/.hermes/logs/hermes.log" max_size:"100MB" max_backups:7 十七、常见问题与避坑指南Q1：改了配置/安装了新工具/新技能，但没生效？ **原因**：Hermes 在会话启动时加载配置和工具集。 **解决**： # 对话内：输入 /reset 或 /new 重新开始会话 /new

网关：重启服务 hermes gateway restart

CLI：退出后重新启动 exit hermes Q2：Gateway 频繁崩溃？ # 查看日志定位问题 grep -i "failed to send\|error\|panic" ~/.hermes/logs/gateway.log | tail -20

重置崩溃状态 systemctl --user reset-failed hermes-gateway

检查内存使用 free -h

如果内存不足，限制 Agent 最大上下文 hermes config set model.context_length 64000 Q3：Discord Bot 收不到消息？ **必须启用 Message Content Intent**： Discord Developer Portal → Bot → Privileged Gateway Intents → 开启 **Message Content Intent**Q4：Slack Bot 只在 DM 里工作？ 需要订阅 message.channels 事件。否则 Bot 会忽略公共频道的消息。 # Slack API 配置 # OAuth & Permissions → Event Subscriptions → Subscribe to bot events # 添加：message.channels, message.groups, message.im Q5：辅助模型（vision/compression/session_search）不工作？ auto 模式找不到后端。需要设置 OPENROUTER_API_KEY 或 GOOGLE_API_KEY，或者显式配置： # 显式配置辅助模型 hermes config set auxiliary.vision.provider "anthropic" hermes config set auxiliary.vision.model "claude-sonnet-4" hermes config set auxiliary.compression.provider "openai" hermes config set auxiliary.compression.model "gpt-4o-mini" Q6：技能安装后看不到？ # 确认已安装 hermes skills list | grep my-skill

检查平台启用状态 hermes skills config

对话内显式加载 /skill my-skill

如果仍不生效，检查 skill 目录权限 ls -la ~/.hermes/skills/my-skill/ Q7：YOLO 模式（跳过所有确认）怎么用？ # 命令行参数 hermes --yolo

环境变量 export HERMES_YOLO_MODE=1

对话内 /yolo

**注意**：YOLO 模式不会关闭密钥脱敏，两者是独立的。redact_secrets 始终生效。Q8：如何迁移记忆到另一台机器？ # 源机器：打包记忆 tar -czf hermes-backup.tar.gz ~/.hermes/

传输到目标机器 scp hermes-backup.tar.gz user@new-server:~/

目标机器：解压 tar -xzf hermes-backup.tar.gz -C ~/

验证 hermes memory status Q9：如何清理过期的记忆？ # 查看记忆大小 du -sh ~/.hermes/memory.db

清理 30 天前的记忆 hermes memory prune --older-than 30

归档旧记忆（保留但不再加载） hermes memory archive --older-than 90 Q10：Skill 创建失败怎么办？ # 检查 skill 目录权限 chmod -R 755 ~/.hermes/skills/

查看创建日志 cat ~/.hermes/logs/skill-create.log

手动创建 skill 框架 mkdir -p ~/.hermes/skills/my-skill cat > ~/.hermes/skills/my-skill/SKILL.md EOF

---

十八、工作流示例

示例 1：用 Hermes 写技术文章

```bash # 1. 启动对话，预加载相关技能 hermes -s tavily-search -s tech-article-writing -s humanizer

2. 搜索素材 > 帮我搜索关于 "Rust vs Go 性能对比" 的最新资料，重点找 2026 年的基准测试数据

3. 撰写文章 > 根据搜索结果，写一篇技术对比文章，要求： > - 结构：背景 → 性能对比 → 内存管理 → 并发模型 → 选型建议 > - 字数：3000 字左右 > - 包含数据表格

4. 去 AI 味 > 用 humanizer 润色一下这篇文章，让语气更像资深工程师的技术博客，减少"首先/其次/综上所述"等 AI 常见表达

5. 保存 > 保存到 ~/articles/rust-vs-go-2026.md，并生成一个配套的架构图保存到 ~/articles/rust-vs-go-diagram.svg 示例 2：用 Hermes 做代码审查 # 1. 启动对话，预加载审查技能 hermes -s github-code-review -s systematic-debugging

2. 指定要审查的 PR > 帮我审查这个 PR：https://github.com/myorg/myrepo/pull/123 > 重点关注：安全性、性能、边界条件处理

3. 生成审查报告 > 列出所有安全问题、性能问题和可能的 bug，按严重程度分类 > 对每个问题给出：位置、问题描述、修复建议、参考链接

4. 自动修复（可选） > 对标记为"minor"的问题，直接提交修复 commit 示例 3：定时日报自动化 # 创建每天早上 9 点的日报任务 hermes cron create "0 9 * * *"

任务内容配置 hermes cron edit daily-report

输入任务内容： """ 1. 搜索昨天的会话记录（session_search query="completed" date=yesterday） 2. 生成工作总结（tech-article-writing 格式） 3. 发送到飞书（gateway 平台已配置） 4. 保存到 ~/reports/daily/YYYY-MM-DD.md """

启用任务 hermes cron resume daily-report 示例 4：多 Agent 协作完成复杂项目 # 1. 初始化看板 hermes kanban init

2. 创建任务（使用 Python API） hermes chat -q """ kanban_create(title="需求分析：用户认证系统重构", assignee="product-manager", priority="high") kanban_create(title="技术方案设计", assignee="architect", priority="high", parents=["需求分析"]) kanban_create(title="后端实现：JWT + OAuth2", assignee="backend-dev", priority="high", parents=["技术方案"]) kanban_create(title="前端实现：登录/注册页面", assignee="frontend-dev", priority="medium", parents=["技术方案"]) kanban_create(title="安全审计：渗透测试", assignee="security-reviewer", priority="high", parents=["后端实现", "前端实现"]) kanban_create(title="文档更新：API 文档 + 用户手册", assignee="technical-writer", priority="medium", parents=["安全审计"]) """

3. 监控进度 hermes kanban list --status running

4. 任务完成后自动归档 hermes kanban archive --status done --older-than 7 十九、总结与行动建议19.1 核心结论 根据解数咨询 × D17 品牌研究报告、清华大学清新研究团队深度报告、以及花叔橙皮书的三方交叉验证： **“技能自动沉淀 + 持久化记忆 + 可审计性的组合在 2026 年仍是 Hermes 的独有能力，构成 1-2 年的窗口期优势。”** 这不是功能清单的竞争，是**进化能力**的竞争。19.2 五条实在建议 1. **用 Profile 把工作场景隔开** 内容创作、开发、研究各搞一个，别混在一起。每个 Profile 有自己的记忆和技能，避免交叉污染。 2. **解决过一次的问题，保存为 Skill** 这个习惯越早养成越省事。Reddit 资深用户经验：“一旦你成功走通一次，它就能变成可复用的 skill。之后这个能力就是你的了。” 3. **记忆系统开着就好** Agent 会自己学你的偏好和环境，不用你主动喂。但记得定期审查，删除过时信息。 4. **Cron 定时任务值得认真搞** 日报、监控、维护、数据收集，这些放 cron 比手动靠谱得多。7×24 小时在线是 Hermes 区别于 Claude Code 的核心优势。 5. **安全配置别跳过** approvals.mode: smart + security.redact_secrets 就够用了。模型随时能换，别死守一个——简单查询用便宜的，复杂任务上强的，成本差很多。19.3 三个立即执行的动作 如果你已经在用 AI Agent，或者正打算选一个开源框架—— **动作 1：48 小时内体验 Hermes Agent 的自学习循环** 单行 curl 安装，3 分钟搞定。跑一个复杂任务，观察它是否自动沉淀技能到 Skill Registry。验证"自我进化"是否真实存在。 **动作 2：本周内对比你的 Agent 迁移成本** 你的 Agent 锁定在哪个模型？哪个云平台？Hermes 的模型无关架构意味着你可以随时切换，无云端锁定。2027 年起，本地部署 + 数据主权将成为企业采购的硬性要求。 **动作 3：30 天内关注 Skill Marketplace 社区** Hermes 的 T+6 月里程碑是 Skill Marketplace 商用。早期贡献者更容易在 awesome-hermes-agent 社区中建立影响力。如果你在做垂直行业 Agent，现在布局技能市场，可能比做通用 Agent 更有价值。二十、参考资料与来源 本文档基于 **Hermes Agent v2.1+** 编写，融合以下来源：官方文档 • Hermes Agent 官方文档：https://hermes-agent.nousresearch.com/docs/ • Tips & Best Practices：https://hermes-agent.nousresearch.com/docs/guides/tips • Context Files：https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files • Context Compression and Caching：https://hermes-agent.nousresearch.com/docs/developer-guide/context-compression-and-caching • Skills System：https://hermes-agent.nousresearch.com/docs/user-guide/features/skills • Working with Skills：https://hermes-agent.nousresearch.com/docs/guides/work-with-skills • Features Overview：https://hermes-agent.nousresearch.com/docs/user-guide/features/overview研究报告 • **解数咨询 × D17**：《Hermes Agent 品牌研究报告》（2026 年 5 月，21 页）—— 核心数据：95.6K Stars、7 周破 9 万、40+ 内置工具、200+ 模型 • **清华大学清新研究团队**：《Hermes Agent 深度研究报告》（2026 年 4 月，60 页）—— 核心判断：从"会说"走向"会做"的可执行型 Agent • **花叔橙皮书**：《Hermes Agent 从入门到精通实战指南》（v260407）—— Harness Engineering 五组件映射、三层记忆详解GitHub 仓库 • NousResearch/hermes-agent：https://github.com/NousResearch/hermes-agent — 源码及 Release Notes • Issue #499: Context Compaction Quality Overhaul：https://github.com/NousResearch/hermes-agent/issues/499 • awesome-hermes-agent：社区技能聚合仓库社区讨论 • Reddit: Looking for Hermes best practices from serious users (r/hermesagent) • Reddit: Has anyone explored Hermes Agent by Nous (r/LocalLLM) • Reddit: I Used Hermes Agent Setup Guide To Build A Better Agent技术博客 • How Hermes Agent Solves the Context Window Problem — Medium • Hermes Agent Guide for PMs: Setup + Workflows (2026) • Hermes Agent Tips: Configuration, Best Practices & Security — DreamSAICanBuy • How to Build a Self-Hosted AI Agent (2026 Stack Guide — PetronellaTech) • Context Compression in AI Agents: Hermes vs Claude Code — Mem0 • Hermes Agent Deep Dive & Build-Your-Own Guide — Dev.to部署指南 • How to Deploy Hermes Agent on a VPS in Under an Hour — MindStudio • 3 Ways to Deploy Hermes Agent on the Cloud — Tencent Cloud • Your Complete Hermes Agent Deployment Roadmap — Tencent Cloud视频教程 • Hermes Agent Full Tutorial for Beginners — Tech With Tim (YouTube) • Full Hermes Agent Setup Tutorial: Step-by-Step Walkthrough (YouTube) • Hermes Agent: The Ultimate Beginner’s Guide (YouTube) • Full Hermes Agent Set-Up For Beginners in 2026 (YouTube)内部源码 • Hermes Agent 107+ 内置技能库（~/.hermes/profiles/ /skills/），包括 hermes-agent、kanban-worker、kanban-orchestrator、humanizer、tech-article-writing 等技能的 SKILL.md 文件 **写在最后**：现在大多数人的 Agent 使用，还在拼功能清单。问题是——你的 Agent 能记住你上周的工作习惯吗？如果每次对话都是"第一次见面"，你的 AI 助理和搜索引擎有什么区别？Hermes 给了答案，但你的倒计时，从今天开始。

点击下载PDF版本

Hermes Agent 完全技术参考手册：从入门到生产部署

更多内容，可访问

往期推荐

万字雄文：Agent Skills：规范 + 实战 + 原理 8个人108亿估值：Lovable给所有创业者上了一课 阿里云103页手册把 100 多个金融 Skill 全量开源了 921页Agent白皮书只讲一件事：怎么让AI真正替你干活 Claude Code 手册：10000+ 字 | 15+架构图 | 完整实战案例