四大 Agent 框架指令文件体系完整版,含 Hermes 多 Agent 详细配置

四大框架的指令文件体系

叫什么名字、放在哪里、按什么顺序读取、多 Agent 怎么配

Claude Code
CLAUDE.md — 以项目为中心
~/.claude/
└── CLAUDE.md ← ① 全局默认(所有项目生效)

~/my-project/
├── CLAUDE.md ← ② 项目级(Git 提交,团队共享)
├── .claude/CLAUDE.md ← ③ 个人级(gitignore)
├── CLAUDE.local.md ← ④ 本地临时覆盖
└── src/frontend/CLAUDE.md ← ⑤ 子目录级(按需加载)
1
~/.claude/CLAUDE.md
个人偏好,所有项目生效
始终
2
./CLAUDE.md
团队规范
始终
3
子目录/CLAUDE.md
进入该目录时加载
按需
4
.claude/CLAUDE.md
个人覆盖
始终
5
CLAUDE.local.md
临时覆盖
始终
优先级:后加载 > 先加载。Claude 有 /memory 系统,会自动记住项目模式,不用全写在 CLAUDE.md 里。
Codex
AGENTS.md — 以项目为中心
~/.codex/
├── AGENTS.md ← ① 全局默认
├── AGENTS.override.md ← 临时替换(有它时忽略 AGENTS.md)
└── rules/*.md ← 规则片段

~/my-project/
├── AGENTS.md ← ② 项目根目录
└── services/api/AGENTS.md ← ③ 子目录(就近优先)
1
~/.codex/AGENTS.md
全局默认
始终
2
./AGENTS.md
项目根目录
始终
3
子目录/AGENTS.md
最近的文件优先
就近
独有:AGENTS.override.md 完全替换同层的 AGENTS.md,适合迁移期间的临时规则。验证命令:codex --ask-for-approval never "Summarize the current instructions"
OpenClaw
SOUL.md + SKILL.md — 以 Agent 为中心
配置跟着 Agent 走,不跟着项目走。SOUL.md 定义"Agent 是谁",AGENTS.md 定义"怎么做事",USER.md 定义"用户是谁"。
~/.openclaw/
├── openclaw.json ← 主配置(Agent 列表、频道绑定、工具权限)
├── workspace-main/ ← 默认 Agent 的工作空间
│ ├── SOUL.md ← 人格:名字、性格、语气、价值观
│ ├── AGENTS.md ← 行为规范
│ └── USER.md ← 关于用户的信息
├── skills/ ← 已安装技能(SKILL.md 格式)
└── memory/ ← 持久化记忆
1
SOUL.md
"我是谁、怎么说话"
最先
2
AGENTS.md + USER.md
行为规范 + 用户信息
始终
3
SKILL.md(元数据)
只加载名称和简介
元数据
4
SKILL.md(全文)
需要时加载完整内容
按需
多 Agent 配置
一个 Gateway 进程管多个完全隔离的 Agent。每个有独立的 workspace(SOUL.md / AGENTS.md / USER.md)、独立的记忆和技能。
~/.openclaw/
├── openclaw.json ← agents.list 里定义所有 Agent + 频道绑定
├── workspace-main/SOUL.md ← Agent "Echo"(主助理)
├── workspace-coding/SOUL.md ← Agent "Coder"(编程)
└── workspace-writer/SOUL.md ← Agent "Writer"(写作)
频道绑定:Echo 绑 Telegram 个人聊天、Coder 绑飞书编程群、Writer 绑飞书写作群——在不同地方发消息自动路由到对应 Agent。
Agent 间通信:通过 agentToAgent 工具互相转交任务。
添加命令:openclaw agents add --name coding 自动创建完整 workspace。
Hermes Agent
SOUL.md + 四层记忆 + 自动 SKILL.md — 以 Agent 为中心
跟 OpenClaw 类似(也用 SOUL.md),但多了四层记忆和自动技能生成——Agent 不只读你写的配置,还会自己写配置记住经验。
~/.hermes/
├── SOUL.md ← 人格基线
├── config.yaml ← 模型、工具、网关配置
├── memory/
│ ├── core.md ← 核心记忆(姓名、偏好等永久信息)
│ ├── episodic/ ← 情节记忆(重要对话快照)
│ ├── semantic/ ← 语义记忆(提炼的知识规律)
│ └── session/ ← 会话记忆
├── skills/
│ ├── auto-generated/ ← Agent 自己创建的技能!
│ └── manual/ ← 你手动装的技能
└── profiles/ ← 多 Agent 的身份档案(见下方)
1
SOUL.md
人格基线
始终
2
memory/core.md
关于你的长期信息
始终
3
memory/semantic/
提炼的知识(冻结快照)
始终
4
memory/episodic/
相关对话片段
按需
5
skills/(元数据→全文)
先名称描述,需要时加载全文
渐进
多 Agent 配置 — 三层机制
Hermes 的多 Agent 不是像 OpenClaw 那样"预配置固定团队",而是三层递进:先定义身份(Profile),再临时委派(Delegate),最后可以用看板协作(Kanban)。
第一层:Profile — 定义"有哪些 Agent"
每个 Profile 是一个独立的 Agent 身份——有自己的 SOUL.md、config.yaml、记忆和技能。
~/.hermes/profiles/
├── default/ ← 默认 Agent
│ ├── SOUL.md config.yaml .env memory/ skills/
├── researcher/ ← 研究员(只开搜索+文件工具)
│ ├── SOUL.md config.yaml .env memory/ skills/
└── writer/ ← 写手(只开文件读写工具)
├── SOUL.md config.yaml .env memory/ skills/
# 创建新 Profile
$ hermes profile create researcher --clone --description "读源码和文档,输出分析报告"

# 编辑它的性格和能力
$ vim ~/.hermes/profiles/researcher/SOUL.md
$ vim ~/.hermes/profiles/researcher/config.yaml

# 切换 Profile 使用
$ hermes --profile researcher
# profiles/researcher/config.yaml
model: claude-sonnet-4-6
toolsets: [search, file, browser] # 只给这些工具
always_load: [data-analysis] # 始终加载的技能
第二层:Delegate — 主 Agent 临时拉起子 Agent
主 Agent 在干活时自动判断"要不要拆分任务"。你不用手动调用——它自己会用 delegate_task 工具。单任务同步委派,或批量并行委派。
# config.yaml — 控制委派行为
delegation:
max_concurrent_children: 3 # 最多同时几个子 Agent
子 Agent 有独立的上下文和终端,完成后返回结果,然后消失。父 Agent 被中断时子 Agent 也会被取消。
第三层:Kanban — 多 Agent 协作看板(v0.13)
最高级的协作模式。一个真正的项目看板:有任务卡片、自动分解、自动分配、状态流转。
$ /kanban create "生成本周运营周报" # 创建任务
$ hermes kanban decompose t_abcd # 自动拆成子任务
# → 系统读取所有 Profile 的 description
# → 把"数据分析"分给 researcher,"写报告"分给 writer
$ hermes kanban list # 查看看板状态
$ /kanban comment t_abcd "用2026年数据" # 给任务加备注
# config.yaml — Kanban 相关
auxiliary:
kanban_decomposer: claude-sonnet-4-6 # 拆分任务用的模型
triage_specifier: claude-sonnet-4-6 # 细化任务描述的模型
goals:
max_turns: 20 # /goal 最多循环几轮
关键:Kanban 分解器会读所有 Profile 的 --description 来决定任务分配给谁——所以创建 Profile 时写好描述非常重要。完成的任务还会被自动沉淀成 SKILL.md,下次直接复用。
vs OpenClaw 多 Agent 的核心区别:
OpenClaw = 预配置固定团队(提前建好 3 个 Agent,各绑频道,各管一摊)
Hermes = 按需动态组队(Profile 定义能力池,Delegate/Kanban 按任务临时调度)
横向对比
Claude Code
Codex
OpenClaw
Hermes
指令文件
CLAUDE.md
AGENTS.md
SOUL.md
SOUL.md
设计思路
以项目为中心
以项目为中心
以 Agent 为中心
以 Agent 为中心
全局默认
~/.claude/
~/.codex/
~/.openclaw/
~/.hermes/
子目录级
✅ 按需加载
✅ 就近优先
❌
❌
临时覆盖
CLAUDE.local.md
AGENTS.override.md
/personality
/personality
多 Agent
Agent Teams
子代理并行
预配置固定团队
Profile + Delegate + Kanban
多Agent配置
对话中创建
自动派生
openclaw.json agents.list
~/.hermes/profiles/ + config.yaml
自动学习
有 /memory
❌
❌
✅ 自动生成 SKILL