OpenClaw 多 Agent 配置实战指南
简介：本文详解 OpenClaw 多 Agent 架构的完整配置流程。从创建工作区、绑定 Discord 频道，到沙箱隔离与工具权限控制，涵盖核心命令、配置文件结构与常见陷阱。适合需要为不同场景定制专属智能体的开发者参考。
如果你想为 OpenClaw 配置多个"员工"，让不同 Agent 承担不同角色、拥有独立性格、工作目录和工具权限，那么多 Agent 架构是你的必由之路。本文基于实战经验，梳理了从创建到绑定的完整流程，并记录了踩过的坑，帮你少走弯路。
配置指南
执行命令创建一个 Agent，以及使用--workspcae 命令给这个 Agent 一个工作区域。
openclaw agents add creative --workspace ~/.openclaw/workspace-creative
创建工作区域后，这个 Agent 只会在这个文件夹里执行操作。
下面是这个工作区域的几个文件功能：
kkp@kkp-GA:~/.openclaw/workspace-creative$ tree
.
├── AGENTS.md #多智能体路由表：把任务分配个哪些 agent
├── BOOTSTRAP.md #点火自举：启动时该初始化哪些文件
├── HEARTBEAT.md #心跳守护：定义后台轮询任务
├── IDENTITY.md #身份面板
├── SOUL.md #核心脑区
├── TOOLS.md #物理抓手
└── USER.md #交互网关：定义触发词，和用户交流
openclaw config get agents #验证配置
把 agent 绑定到 discord 的不同频道，其他平台也是一样的，下面的代码需要修改频道、kind、id。绑定到不同的频道和不同的 Agent 进行对话，这里的 bindings 和文件中的 Agent 是同级的！这里演示 discord，需要开启开发者模式，才能获取频道的 id！
bindings: [
{ agentId: "main", match: { channel: "discord", peer:{"kind": "channel", "id": "12312312312312312" } } },
{ agentId: "creative", match: { channel: "discord", peer:{ "kind": "channel","id": "1231231231231231" } } },
],
openclaw gateway restart #重启网关
openclaw agents list --bindings #测试链接
在 openclaw 的可视化界面也可也对这个 Agent 单独配置。
进阶操作，给每个智能体配置沙箱和工具，注意 deny 的优先级要比 allow 的高！
{
agents: {
list: [
{
id: "personal",
workspace: "~/.openclaw/workspace-personal",
sandbox: {
mode: "off", // 个人智能体无沙箱
},
// 无工具限制 - 所有工具可用
},
{
id: "family",
workspace: "~/.openclaw/workspace-family",
sandbox: {
mode: "all", // 始终沙箱隔离
scope: "agent", // 每智能体一个容器
docker: {
// 容器创建后的可选一次性设置
setupCommand: "apt-get update && apt-get install -y git curl",
},
},
tools: {
allow: ["read"], // 仅 read 工具
deny: ["exec", "write", "edit", "apply_patch"], // 拒绝其他
},
},
],
},
}
注意事项：
1、不要手动创建BOOTSTRAP.md，这个文件是 Agent 的初始化任务清单，只有 Agent 执行完里面的命令，他才会被删除，如果手动创建这个文件，可能会导致 bootstrapping 状态，一直尝试完成里面的任务。
2、注意不要再智能体之间重用 Agent Dir，会导致认证失败，会话混乱
3、在配置 bindings 时候将详细一点的配置放在前面，不然可能会出现匹配错误，下面就是错误的，带具体频道 id 的应该先放在前面
bindings: [
{ agentId: "main", match: { channel: "discord", peer:{"kind": "channel"} } },
{ agentId: "creative", match: { channel: "discord", peer:{ "kind": "channel","id": "1231231231231231" } } },
],
总结
多 Agent 配置的核心在于"隔离"与"路由"：每个智能体拥有独立的工作空间和权限边界，通过 bindings 精准分发任务。按本文步骤操作，你能快速搭建出分工明确、安全可控的多智能体系统。配置完成后，记得用 openclaw agents list --bindings 验证连接状态，祝你部署顺利！
