llm_wiki/tools/docs/homewiki/Hermes多Agent协作机制官方文档解析.md

Hermes 多 Agent 协作机制官方文档解析

来源：Hermes Agent 官方文档（hermesagent.org.cn） 整理时间：2026-05-20 用途：Hermes（二休）建立独立于 OpenClaw 的多 Agent 协作闭环

---

核心发现：Hermes 有三套独立的 Multi-Agent 机制

这和 OpenClaw 的持久 Agent（main/news/assistant/research）模式完全不同。Hermes 的多 Agent 是可组合的三层架构：

机制	OpenClaw 对应	用途	特点
Profiles	配置文件	同一机器运行多个独立 Agent	完全隔离的配置/记忆/技能/网关
delegate_task	agentToAgent	临时委派子 Agent	最多 3 并发，隔离上下文，父 Agent 只收摘要
cron jobs	定时任务	autonomous Agent	后台自动运行，可链式编排

---

1. Profiles（配置文件）

核心概念

在同一台机器上运行多个独立的 Hermes Agent —— 每个 Agent 拥有自己的配置、API 密钥、记忆、会话、技能和网关。

关键特点

• 创建 Profile 后自动获得命令别名（如 hermes profile create coder → coder chat）
• 完全隔离：每个 Profile 有独立的 config.yaml、.env、SOUL.md、记忆、会话、技能、定时任务
• 不同用途可运行不同 Profile：代码助手、个人机器人、研究 Agent
• 不会相互干扰

命令示例

hermes profile create research   # 创建 research Profile
research setup                   # 配置 API 密钥和模型
research chat                    # 开始聊天

hermes profile list              # 列出所有 Profile
hermes profile use research       # 切换默认 Profile

适用场景

• 需要长期运行的专用 Agent（如专门的代码 Agent、研究 Agent）
• 不同 Agent 需要不同模型或 API 密钥
• 需要完全隔离的记忆和上下文

---

2. delegate_task（子 Agent 委派）

官方文档核心要点

delegate_task 工具会启动具有隔离上下文、受限工具集和独立终端会话的子 AIAgent 实例。每个子 Agent 都会获得一个全新的对话，并独立工作——只有其最终摘要才会进入父 Agent 的上下文。

重要约束

:::warning 子 Agent 一无所知 子 Agent 从一个完全全新的对话开始。它们对父 Agent 的对话历史、之前的工具调用或任何先前讨论的内容都一无所知。唯一上下文来自 goal 和 context 字段。 :::

正确传递上下文：

# BAD - subagent 不知道 "the error" 是什么
delegate_task(goal="Fix the error")

# GOOD - subagent 拥有所需的所有内容
delegate_task(
    goal="Fix the TypeError in api/handlers.py",
    context="""The file api/handlers.py has a TypeError on line 47:
    'NoneType' object has no attribute 'get'.
    The function process_request() receives a dict from parse_body(),
    but parse_body() returns None when Content-Type is missing.
    The project is at /home/user/myproject and uses Python 3.11."""
)

单个任务

delegate_task(
    goal="Debug why tests fail",
    context="Error: assertion in test_foo.py line 42",
    toolsets=["terminal", "file"]
)

并行批量任务（最多 3 并发）

delegate_task(tasks=[
    {"goal": "Research topic A", "toolsets": ["web"]},
    {"goal": "Research topic B", "toolsets": ["web"]},
    {"goal": "Fix the build", "toolsets": ["terminal", "file"]}
])

工具集选择建议

任务类型	工具集
代码审查 / 重构	["terminal", "file"]
网络研究	["web"]
浏览器自动化	["browser"]
定时任务管理	["cronjob"]
文件操作	["file"]
混合任务	["terminal", "file", "web"]

最大并发数

默认最多 3 个并发子 Agent。超出则排队等待。

深度限制

子 Agent（leaf role）不能进一步委派。Orchestrator role 可以委派，但 nesting depth 有限制。

---

3. cron jobs（定时 Autonomous Agent）

官方文档要点

• Jobs 运行在新鲜 session 中，无当前聊天上下文
• Prompts 必须自包含
• 如果提供 skills，按顺序加载后执行 prompt
• 支持链式编排：Job A 收集数据 → Job B 处理 → Job C 汇总
• Delivery 可指定：origin（回当前聊天）、local（仅保存）、all（所有连接渠道）

delivery 参数

值	行为
origin	回当前聊天（默认）
local	仅保存到 ~/.hermes/cron/output/
all	广播到所有已连接渠道
platform:chat_id	指定特定渠道

关键安全规则

cron-run sessions should not recursively schedule more cron jobs.

---

Hermes Multi-Agent 协作闭环设计

基于官方文档三机制，设计 Hermes（二休）的多 Agent 协作闭环：

机制选型

任务类型	推荐机制	说明
临时性研究任务	delegate_task	Web 并行研究，1 次性
临时性编码任务	delegate_task	Terminal/File 工具集
长期专用 Agent	Profiles	独立的 research/coder Agent
定期自动任务	cron jobs	每小时/每天执行

Hermes 协作闭环架构

微信指令（老何）
    │
    ▼
┌─────────────────────────────────────┐
│  Hermes（二休）- 主 Agent           │
│  - 理解任务                         │
│  - 拆解步骤                         │
│  - 判断：直接做 / delegate / cron   │
└─────────────────────────────────────┘
    │
    ├──────────────────┬──────────────────┐
    ▼                  ▼                  ▼
delegate_task      delegate_task      cron job
    │                  │                  │
    ▼                  ▼                  ▼
┌─────────┐      ┌─────────┐      ┌─────────────┐
│Research │      │ Coding  │      │ Autonomous  │
│ Agent   │      │ Agent   │      │ Agent       │
│(临时)   │      │(临时)   │      │(定时)       │
└─────────┘      └─────────┘      └─────────────┘
    │                  │                  │
    └──────────────────┴──────────────────┘
                       │
                       ▼
              结果写 Wiki / Git push
                       │
                       ▼
              PC 端 OpenCode 读取处理

与 OpenClaw 的关键区别

维度	OpenClaw	Hermes
Agent 类型	持久 Agent（main/news/assistant/research）	Profiles（持久）+ delegate_task（临时）+ cron（定时）
上下文共享	共享对话历史	delegate_task 完全隔离，Profiles 独立隔离
委派方式	agentToAgent 配置	delegate_task 工具调用
通信机制	共享消息通道	Profile 间通过 Wiki/Git 间接协作
向量检索	embedding-3（OpenAI API）	embedding-3（OpenAI API）

Wiki 协作路径

Hermes委派子Agent → 处理结果写入Wiki → Git push到Gitee
                                        │
                                        ▼
                              PC端 OpenCode 读取Wiki
                                        │
                                        ▼
                              处理结果写回Wiki → Git push
                                        │
                                        ▼
                              Hermes 读取Wiki → 汇总结果

---

实际配置记录

Profile 创建（2026-05-20）

Profile	模型	用途	目录
research	glm-4.7	网络研究、信息收集	/home/ubuntu/.hermes/profiles/research/
coder	MiniMax-M2.7	代码审查/重构/执行	/home/ubuntu/.hermes/profiles/coder/

Wiki 协作目录

raw/
├── research/   # research profile 输出
└── coder/     # coder profile 输出

PC 端协作流程

1. Hermes 委派 research/coder 子 Agent
2. 结果写入 /home/obsidian/wiki/raw/research/ 或 raw/coder/
3. Git push 到 Gitee
4. PC 端 Obsidian Git 插件定时拉取
5. PC OpenCode 读取处理
6. PC 端处理结果写回 Wiki → Git push
7. Hermes 读取 Wiki 汇总

Profile 命令

research chat          # 进入 research profile
coder chat             # 进入 coder profile
research gateway start # 启动 research 网关（当前不需要）
coder gateway start    # 启动 coder 网关（当前不需要）

---

参考文档

• 子 Agent 委派
• 配置文件
• Agent Loop 内部机制
• 架构