OpenClaw 多 Agent 配置实战指南

# 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` 验证连接状态，祝你部署顺利！