OpenClaw多Agent协作踩坑实录：从翻车到跑通的全记录
最近，我在折腾OpenClaw的多Agent团队协作功能，想搭建一个AI写作团队：运营主管阿强、研究员阿亮、写手阿文、审核员阿严，4个Bot协作写文章。想法很美好，现实很骨感。配置过程中踩了一堆坑，一度怀疑人生。今天把这趟"翻车-爬起-跑通"的全过程分享给你，帮你避开这些坑。
一、先说说我要做什么
简单来说，就是只跟阿强说话，让他自动协调其他三个Bot完成文章写作：
听起来很酷对吧？但配置过程让我差点放弃。
二、踩坑实录
坑1：跨Agent通信权限没开（最隐蔽的坑）
现象：
阿强收到任务后，只说"好的，我立即协调团队"，然后就没下文了。其他Bot一点反应都没有。
查日志发现报错：
需要设置 tools.sessions.visibility=all 才能向其他团队成员发送消息原因：
openclaw.json 里缺了一个关键配置。默认情况下，Agent只能看到自己的会话，看不到其他Bot的会话。
解决方案：
在 openclaw.json 的 tools 部分添加：
"tools": {
"sessions": {
"visibility": "all"
}
}经验教训：
这个配置在官方文档里有，但很多教程没强调。没有它，多Agent协作根本玩不起来。
坑2：文件路径错乱（最折腾的坑）
现象：
阿亮说大纲已经保存了，阿文却说找不到文件。
查看日志发现搞笑的一幕：
阿亮保存到：~/.openclaw/workspace/openclaw-camp-article/outline.md
阿文去读取：~/.openclaw/agents/writer/workspace/workspace/openclaw-camp-article/outline.md注意看，阿文的路径里多了个 workspace/workspace，变成嵌套路径了！
原因：
每个Agent有自己的 workspace 目录，但我让阿亮保存文件时用了相对路径 workspace/...，不同Agent解析出来路径不一致。
解决方案：
所有Agent共享的文件，必须用绝对路径：
~/.openclaw/workspace/openclaw-camp-article/outline.md而不是相对路径：
workspace/openclaw-camp-article/outline.md经验教训：
SOUL.md里所有的文件路径都要用 ~/.openclaw/workspace/... 开头，确保大家都能找到同一个文件。
坑3：agentToAgent.allow配错了（最无语的坑）
现象：
想开启Agent间直接通信，配置了 agentToAgent，但一直不生效。
错误配置：
"agentToAgent": {
"enabled": true,
"allow": ["sessions_list", "sessions_send", "sessions_history"]
}看出来问题了吗？我把工具名填进去了！
正确配置：
"agentToAgent": {
"enabled": true,
"allow": ["manager", "researcher", "writer", "reviewer"]
}allow 里应该填的是Agent的ID，不是工具名！
经验教训：
配置项的命名容易误导。allow指的是"允许哪些Agent之间通信"，不是"允许使用哪些工具"。
坑4：全局tools.deny误伤友军（最坑的坑）
现象：
我在 openclaw.json 根目录配置了全局限制：
"tools": {
"deny": ["write", "edit", "exec", "apply_patch"]
}想着限制一下阿强的写入权限，结果所有Agent都不能写文件了！阿文连文章都保存不了。
原因：
tools.deny 放在根目录会影响所有Agent。想单独限制某个Agent，要在该Agent的配置里加：
{
"id": "manager",
"name": "阿强",
"tools": {
"allow": ["sessions_list", "sessions_send", "sessions_history", "read"],
"deny": ["write", "edit", "exec", "apply_patch", "bash"]
}
}经验教训：
权限控制要精确到Agent级别，不要搞全局限制，否则连自己一起坑。
坑5：以为能看到所有Bot的回复（最天真的坑）
现象：
我傻傻地以为配置了4个Bot，就能看到4个窗口同时聊天。结果只收到阿强的回复，其他Bot好像"消失"了。
真相：
这是正常的！sessions_send 的工作方式就是后台通信。
阿强用 sessions_send 发消息给阿亮，阿亮在后台会话里处理，回复也是直接给阿强，不是给你。
你能看到的只有阿强的汇总结果，其他Bot的对话过程在后台"一闪而过"。
解决方案：
如果想要"过程清晰可见"，需要用 sessions_spawn（子智能体）方式，这个在后续教程里会讲。
经验教训：
不要以为是配置错了，这只是不同协调方式的特性差异。
三、跑通后的效果
搞定所有坑之后，效果是这样的：
我给阿强发消息：
你好，我需要写一篇介绍OpenClaw的文章
要求：
- 主题：OpenClaw是什么，为什么现在这么火
- 目标读者：零基础小白
- 字数：2000左右
- 风格：通俗易懂
请协调团队完成。阿强回复（约10分钟后）：
✅ 任务完成！
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！ 很好很强大我过来先占个楼 待编辑 前排留名，哈哈哈 新版吗？好像是停更了吧。 喜欢鼓捣这些软件，现在用得少，谢谢分享！ 感谢分享 分享、互助 让互联网精神温暖你我 分享、互助 让互联网精神温暖你我 不错，里面软件多更新就更好了 东西不错很实用谢谢分享 分享、互助 让互联网精神温暖你我
页:
[1]