夜雨聆风🤖 第24课：多Agent配置
① 人话解释
一个OpenCLAW = 多个AI分身，各干各的
翻译成人话：
这课教你创建多个AI分身：工作一个、生活一个、学习一个，互不干扰，各司其职。
你现在只有一个AI。学了这节课，你可以有：
工作Agent：只处理工作问题，用DeepSeek（便宜） 生活Agent：陪你聊天，用GPT（友好） 编程Agent：专门写代码，用Claude（代码强）
一句话：1个OpenCLAW = N个独立AI，各自有不同的性格、不同的模型、不同的工作空间。
② 为什么学
为什么多Agent是第24课？
因为——
一个AI干所有事 = 什么都会，什么都不精。多Agent = 每个都精。
学会后你能：
给公司团队每人分配一个独立AI（数据不串） 飞书群里放一个客服Agent，QQ群里放一个技术Agent 同一个OpenCLAW服务，不同人用不同AI，互不串数据
多Agent = 一台服务器，多个完全独立的AI，各干各的。
（3） 一个Agent是什么？
┌─────────────────────────────────────────┐
│ 一个Agent的组成 │
├─────────────────────────────────────────┤
│ │
│ Workspace（工作空间） │
│ ├── AGENTS.md（行为规则） │
│ ├── SOUL.md （个性定义） │
│ ├── USER.md （用户信息） │
│ └── MEMORY.md（长期记忆） │
│ │
│ 状态目录 │
│ └── ~/.openclaw/agents/<agentId>/ │
│ ├── agent/（认证配置） │
│ └── sessions/（会话历史） │
│ │
│ 每个Agent有： │
│ ✅ 自己的文件 │
│ ✅ 自己的记忆 │
│ ✅ 自己的认证 │
│ ✅ 自己的模型选择 │
│ │
└─────────────────────────────────────────┘
（4） 实战：创建多个Agent
步骤1：创建Agent
# 创建3个Agent
openclaw agents add work # 工作Agent
openclaw agents add life # 生活Agent
openclaw agents add coding # 编程Agent
每个命令会自动创建独立的工作空间：
~/.openclaw/workspace-work/~/.openclaw/workspace-life/~/.openclaw/workspace-coding/
Step 2：给每个Agent设定性格
# 进入工作Agent的工作空间
cd ~/.openclaw/workspace-work/
# SOUL.md 写工作Agent的性格
echo"你是一个专业的工作助手，回答简洁高效。" > SOUL.md
# 生活Agent
cd ~/.openclaw/workspace-life/
echo"你是一个温暖的生活伙伴，幽默风趣。" > SOUL.md
# 编程Agent
cd ~/.openclaw/workspace-coding/
echo"你是一个资深程序员，专注代码质量。" > SOUL.md
⑤ 实战：配置多Agent路由
编辑 ：~/.openclaw/openclaw.json
{
"agents": {
"list": [
{
"id": "main",
"name": "通用助手",
"workspace": "~/.openclaw/workspace",
"model": "deepseek/deepseek-v4-flash"
},
{
"id": "work",
"name": "工作助手",
"workspace": "~/.openclaw/workspace-work",
"model": "deepseek/deepseek-v4-pro"
},
{
"id": "coding",
"name": "编程助手",
"workspace": "~/.openclaw/workspace-coding",
"model": "anthropic/claude-sonnet-4-6"
}
]
},
"bindings": [
{
"agentId": "work",
"match": { "channel": "feishu" }
},
{
"agentId": "coding",
"match": { "channel": "qqbot" }
}
]
}
效果：
飞书上发的消息 → 工作Agent回复（用DeepSeek Pro） QQ上发的消息 → 编程Agent回复（用Claude） 其他渠道 → 通用Agent回复
⑥ 国内平台实战：飞书 + QQ 多Agent
场景：一个公司用飞书，一个技术群用QQ
{
"agents": {
"list": [
{
"id": "office",
"name": "公司助手",
"workspace": "~/.openclaw/workspace-office",
"model": "deepseek/deepseek-v4-flash"
},
{
"id": "tech",
"name": "技术助手",
"workspace": "~/.openclaw/workspace-tech",
"model": "deepseek/deepseek-v4-pro"
}
]
},
"bindings": [
{
"agentId": "office",
"match": { "channel": "feishu" }
},
{
"agentId": "tech",
"match": { "channel": "qqbot" }
}
],
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxx",
"appSecret": "xxx",
"groupPolicy": "allowlist",
"requireMention": true
},
"qqbot": {
"enabled": true,
"appId": "你的QQ AppID",
"clientSecret": "你的QQ AppSecret",
"groupPolicy": "allowlist"
}
}
}
效果：
飞书群里@机器人 → 公司助手回答（普通话术，用便宜模型） QQ群里@机器人 → 技术助手回答（专业术语，用Pro模型）
⑦ 消息路由规则
消息来了怎么决定给哪个Agent？
路由优先级（从上到下）：
1. 精确匹配某个群/私聊ID
↓
2. 频道+账号匹配（如飞书 → work Agent）
↓
3. 频道匹配（如QQ → tech Agent）
↓
4. 默认Agent（main）
规则：第一个匹配到的Agent处理消息
匹配规则是"与"关系（AND）
例如：channel=feishu AND accountId=default → work
⑧ 给Agent限制权限
给家庭/团队用的Agent，限制它只能做安全的事：
{
"agents": {
"list": [
{
"id": "family",
"name": "家庭助手",
"workspace": "~/.openclaw/workspace-family",
"tools": {
"allow": ["read", "sessions_history"],
"deny": ["write", "edit", "exec", "browser", "cron"]
}
}
]
}
}
解释：
allow：只能读文件、查历史deny：不能写文件、不能执行命令、不能动浏览器、不能设定时任务这样家庭群里的AI就不会乱搞你的电脑
⑨ 管理命令速查
# 查看所有Agent
openclaw agents list
# 查看Agent绑定关系
openclaw agents list --bindings
# 添加新Agent
openclaw agents add <名称>
# 重新配置Agent
openclaw configure
# 验证配置
openclaw channels status --probe
⑩ 避坑说明
❌ 误区1：多个Agent可以共用工作空间
危险！每个Agent必须有独立的工作空间。 共用会导致认证和会话冲突，Agent行为混乱。
❌ 误区2：Agent越多越好
不一定。2-3个Agent是最佳数量。 太多Agent管理麻烦，配置也复杂。 推荐：通用(main) + 工作(work) + 一个专项。
❌ 误区3：不同Agent可以用同一个API Key
可以，但不推荐。 每个Agent有自己的认证配置目录。 如果要限制用量，最好用不同的Key。
❌ 误区4：绑定(bindings)顺序不重要
很重要！路由是从上到下匹配的。 精确匹配放前面，通用匹配放最后。 顺序错了，消息可能发到错误的Agent。
⑪ 小总结
本课核心：
✅ 多Agent = 多个独立AI分身
✅ 每个Agent有独立的workspace、记忆、认证
✅ 创建Agent：openclaw agents add <名称>
✅ 路由binding：飞书→work Agent，QQ→tech Agent
✅ 可限制Agent权限（家庭Agent不能执行命令）
✅ 消息路由优先级：精确匹配 > 频道+账号 > 频道 > 默认
【推荐配置】
main（通用，默认模型）
work（工作，飞书，DeepSeek便宜模型）
coding（编程，QQ，Claude强模型）
⑫ 小作业
作业1： 用 创建2个Agent，设定不同的SOUL.md。openclaw agents add
作业2： 配置binding，让飞书和QQ各对应一个Agent。
作业3： 给其中一个Agent限制权限，测试不能执行exec命令。
📋 本课收获
下一课：第25课——不会写代码也能给AI"装技能"，Skills系统入门。
💡 下节课你将学会给AI装各种技能：处理文档、生成图片、查日历、发邮件……像装App一样给AI装能力。
