OpenClaw 多 Agent 配置实战指南

简介：本文详解 OpenClaw 多 Agent 架构的完整配置流程。从创建工作区、绑定 Discord 频道，到沙箱隔离与工具权限控制，涵盖核心命令、配置文件结构与常见陷阱。适合需要为不同场景定制专属智能体的开发者参考。

如果你想为 OpenClaw 配置多个"员工"，让不同 Agent 承担不同角色、拥有独立性格、工作目录和工具权限，那么多 Agent 架构是你的必由之路。本文基于实战经验，梳理了从创建到绑定的完整流程，并记录了踩过的坑，帮你少走弯路。

配置指南

执行命令创建一个 Agent，以及使用--workspcae 命令给这个 Agent 一个工作区域。

javascript 复制代码

openclaw agents add creative --workspace ~/.openclaw/workspace-creative

创建工作区域后，这个 Agent 只会在这个文件夹里执行操作。下面是这个工作区域的几个文件功能：

ruby 复制代码

kkp@kkp-GA:~/.openclaw/workspace-creative$ tree
.
├── AGENTS.md     #多智能体路由表：把任务分配个哪些 agent
├── BOOTSTRAP.md   #点火自举：启动时该初始化哪些文件
├── HEARTBEAT.md   #心跳守护：定义后台轮询任务
├── IDENTITY.md  #身份面板
├── SOUL.md      #核心脑区
├── TOOLS.md     #物理抓手
└── USER.md      #交互网关：定义触发词，和用户交流

arduino 复制代码

openclaw config get agents   #验证配置

把 agent 绑定到 discord 的不同频道，其他平台也是一样的，下面的代码需要修改频道、kind、id。绑定到不同的频道和不同的 Agent 进行对话，这里的 bindings 和文件中的 Agent 是同级的！这里演示 discord，需要开启开发者模式，才能获取频道的 id！

css 复制代码

  bindings: [
    { agentId: "main", match: { channel: "discord", peer:{"kind": "channel", "id": "12312312312312312" } } },
    { agentId: "creative", match: { channel: "discord", peer:{ "kind": "channel","id": "1231231231231231" } } },
  ],

bash 复制代码

openclaw gateway restart  #重启网关
openclaw agents list --bindings  #测试链接

在 openclaw 的可视化界面也可也对这个 Agent 单独配置。

进阶操作，给每个智能体配置沙箱和工具，注意 deny 的优先级要比 allow 的高！

css 复制代码

{
  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 的应该先放在前面

css 复制代码

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