一、核心认知：无需 AGENTS.md
根据实测，OpenClaw 的多智能体协作不需要配置 AGENTS.md。只要在 openclaw.json 中正确配置 subagents.allowAgents 和 tools.agentToAgent，小智会自动识别并分派任务。
关键配置只有两处：
| 配置项 | 作用 |
|---|---|
subagents.allowAgents | 定义每个 Agent 可以调用谁 |
tools.agentToAgent | 全局开启通信能力 |
二、团队架构设计
2.1 成员清单
| Agent ID | 姓名 | 职位 | 可以调用谁 |
|---|---|---|---|
| xiaozhi | 小智 | 总经理 | 小蔡、小王、小李、小元、小张 |
| xiaocai | 小蔡 | 内容运营 | 无 |
| xiaowang | 小王 | 销售经理 | 无 |
| xiaoli | 小李 | 数据分析师 | 无 |
| xiaoyuan | 小元 | 行政主管 | 小张（人事助理） |
| xiaozhang | 小张 | 人事助理 | 无 |
2.2 协作关系图
老板（只@小智）
│
▼
┌─────────┐
│ 小智 │ ← 总经理
└────┬────┘
│ sessions_spawn
┌───────────────┼───────────────┬───────────────┐
│ │ │ │
▼ ▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ 小蔡 │ │ 小王 │ │ 小李 │ │ 小元 │
│ 内容运营 │ │ 销售经理 │ │ 数据分析 │ │ 行政主管 │
└──────────┘ └──────────┘ └──────────┘ └────┬────┘
│
sessions_spawn
│
▼
┌──────────┐
│ 小张 │
│ 人事助理 │
└──────────┘
2.3 汇报关系
小智（总经理）
├── 小蔡（内容运营）
├── 小王（销售经理）
├── 小李（数据分析师）
└── 小元（行政主管）
│
└── 小张（人事助理）
三、配置文件（完整版）
{
"gateway": {
"bind": "lan",
"port": 18789,
"auth": { "mode": "token" }
},
"agents": {
"defaults": {
"model": { "primary": "deepseek/deepseek-chat" }
},
"list": [
{
"id": "xiaozhi",
"name": "小智",
"workspace": "/home/node/.openclaw/workspace/xiaozhi",
"model": { "primary": "deepseek/deepseek-chat" },
"subagents": {
"allowAgents": ["xiaocai", "xiaowang", "xiaoli", "xiaoyuan", "xiaozhang"]
}
},
{
"id": "xiaocai",
"name": "小蔡",
"workspace": "/home/node/.openclaw/workspace/xiaocai",
"model": { "primary": "qwen-plus" }
},
{
"id": "xiaowang",
"name": "小王",
"workspace": "/home/node/.openclaw/workspace/xiaowang",
"model": { "primary": "deepseek/deepseek-chat" }
},
{
"id": "xiaoli",
"name": "小李",
"workspace": "/home/node/.openclaw/workspace/xiaoli",
"model": { "primary": "doubao-seed-2-0-mini-260215" }
},
{
"id": "xiaoyuan",
"name": "小元",
"workspace": "/home/node/.openclaw/workspace/xiaoyuan",
"model": { "primary": "deepseek/deepseek-chat" },
"subagents": {
"allowAgents": ["xiaozhang"]
}
},
{
"id": "xiaozhang",
"name": "小张",
"workspace": "/home/node/.openclaw/workspace/xiaozhang",
"model": { "primary": "qwen-plus" }
}
]
},
"tools": {
"agentToAgent": {
"enabled": true,
"allow": ["xiaozhi", "xiaocai", "xiaowang", "xiaoli", "xiaoyuan", "xiaozhang"]
}
}
}
四、使用方式
4.1 让小智自动分派
在飞书里 @小智，直接说：
“根据现在配置，你可以和小元通讯了吗？”
小智会自动检查配置，确认后就可以调用了。
4.2 小智主动调用子 Agent
小智会使用 sessions_spawn 工具启动子 Agent：
sessions_spawn({ task: "安排下周的面试", agentId: "xiaoyuan" })
4.3 小元转交任务给小张
小元收到人事行政类任务后，会自动转交给小张：
sessions_spawn({ task: "整理员工档案", agentId: "xiaozhang" })
五、常见问题
Q1：小智说“无法与其他 Agent 沟通”
检查 tools.agentToAgent.enabled 是否为 true：
docker exec -it openclaw-gateway openclaw config get tools.agentToAgent
Q2：小元无法调用小张
检查 xiaoyuan 的 subagents.allowAgents 是否包含 xiaozhang：
docker exec -it openclaw-gateway openclaw config get agents.list.4.subagents
Q3：新增员工后需要做什么？
- 在
agents.list中添加新 Agent - 在小智的
subagents.allowAgents中添加新 ID - 在
tools.agentToAgent.allow中添加新 ID - 重启容器：
docker compose restart
六、快速命令速查
| 操作 | 命令 |
|---|---|
| 查看所有员工 | docker exec -it openclaw-gateway openclaw agents list |
| 查看小智配置 | docker exec -it openclaw-gateway openclaw config get agents.list.0 |
| 查看通信配置 | docker exec -it openclaw-gateway openclaw config get tools.agentToAgent |
| 测试对话 | docker exec -it openclaw-gateway openclaw agent --agent xiaozhi --message "你好" |
| 重启服务 | cd /opt/openclaw && docker compose restart |
七、总结
多智能体协作的核心配置只有两处：
subagents.allowAgents：定义谁可以调用谁tools.agentToAgent：全局开启通信能力
不需要 AGENTS.md。配置好后，小智会自动识别并分派任务。
组织架构：
- 小智（总经理）可调用：小蔡、小王、小李、小元、小张
- 小元（行政主管）可调用：小张（人事助理）
- 其他员工：不可调用他人
一个人，也能拥有一整个团队。
