学了个寂寞

Appearance

多 Agent 路由 ​

目标：在一个运行中的 Gateway 内，运行多个完全隔离的 agent（独立工作空间 + agentDir + session），以及多个渠道账号（例如两个 WhatsApp 号），通过 binding 将入站消息路由到对应 agent。

什么是"一个 Agent"？ ​

Agent 是一个完整的独立"大脑"，拥有自己的：

  • 工作空间（文件、AGENTS.md/SOUL.md/USER.md、本地笔记、人格规则）。
  • 状态目录（agentDir）存放 auth profile、模型注册表和 per-agent 配置。
  • Session 存储（聊天历史 + 路由状态）位于 ~/.openclaw/agents/<agentId>/sessions。

Auth profile 是 per-agent 的。每个 agent 从自己的路径读取：

text
~/.openclaw/agents/<agentId>/agent/auth-profiles.json

主 agent 凭据不会自动共享。切勿跨 agent 复用 agentDir（会导致认证/session 冲突）。若需共享凭据，将 auth-profiles.json 复制到另一个 agent 的 agentDir。

Skills 通过各工作空间的 skills/ 文件夹实现 per-agent，共享 skill 可放在 ~/.openclaw/skills。

Gateway 可以只托管一个 agent（默认），也可以同时托管多个 agent。

工作空间说明：每个 agent 的工作空间是默认 cwd，不是硬沙箱。相对路径在工作空间内解析，但绝对路径可以访问主机其他位置，除非启用了沙箱。参见 Sandboxing。

路径速查 ​

  • 配置：~/.openclaw/openclaw.json（或 OPENCLAW_CONFIG_PATH）
  • 状态目录：~/.openclaw（或 OPENCLAW_STATE_DIR）
  • 工作空间：~/.openclaw/workspace（或 ~/.openclaw/workspace-<agentId>）
  • Agent 目录：~/.openclaw/agents/<agentId>/agent（或 agents.list[].agentDir）
  • Sessions：~/.openclaw/agents/<agentId>/sessions

单 Agent 模式（默认） ​

不做任何配置时，OpenClaw 运行单个 agent：

  • agentId 默认为 main。
  • Session 键格式：agent:main:<mainKey>。
  • 工作空间默认为 ~/.openclaw/workspace（设置了 OPENCLAW_PROFILE 时为 ~/.openclaw/workspace-<profile>）。
  • 状态默认为 ~/.openclaw/agents/main/agent。

Agent 助手 ​

使用 agent wizard 添加新的隔离 agent：

bash
openclaw agents add work

然后添加 bindings（或让 wizard 自动完成）以路由入站消息。

验证：

bash
openclaw agents list --bindings

快速开始 ​

第一步：创建各 agent 工作空间

使用 wizard 或手动创建：

bash
openclaw agents add coding
openclaw agents add social

每个 agent 获得独立工作空间（含 SOUL.md、AGENTS.md、可选 USER.md），以及专用 agentDir 和 ~/.openclaw/agents/<agentId> 下的 session 存储。

第二步：创建渠道账号

在首选渠道为每个 agent 创建一个账号：

  • Discord：每个 agent 一个 bot，启用 Message Content Intent，复制各自 token。
  • Telegram：通过 BotFather 为每个 agent 创建一个 bot，复制各自 token。
  • WhatsApp：为每个账号关联一个手机号。
bash
openclaw channels login --channel whatsapp --account work

第三步：添加 Agent、账号和 Binding

在 agents.list 下添加 agent，在 channels.<channel>.accounts 下添加渠道账号，用 bindings 连接它们（见下方示例）。

第四步：重启并验证

bash
openclaw gateway restart
openclaw agents list --bindings
openclaw channels status --probe

多 Agent = 多人、多性格 ​

使用多 Agent 时，每个 agentId 成为一个完全隔离的角色：

  • 不同手机号/账号（每个渠道 accountId）。
  • 不同性格（per-agent 工作空间文件，如 AGENTS.md 和 SOUL.md）。
  • 独立认证 + session（除非明确启用，否则不互通）。

这让多个人共享一台 Gateway 服务器，同时保持各自的 AI"大脑"和数据隔离。

一个 WhatsApp 号，多个人（DM 分流） ​

你可以将不同 WhatsApp DM 路由到不同 agent，同时只用一个 WhatsApp 账号。用 peer.kind: "direct" 按发送者 E.164 号码（如 +15551234567）匹配。回复仍来自同一个 WhatsApp 号（无 per-agent 发送者身份）。

重要细节：直接聊天会折叠到 agent 的主 session 键，真正的隔离需要每人一个 agent。

示例：

json5
{
  agents: {
    list: [
      { id: "alex", workspace: "~/.openclaw/workspace-alex" },
      { id: "mia", workspace: "~/.openclaw/workspace-mia" },
    ],
  },
  bindings: [
    {
      agentId: "alex",
      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } },
    },
    {
      agentId: "mia",
      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } },
    },
  ],
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551230001", "+15551230002"],
    },
  },
}

说明：

  • DM 访问控制是全局 per WhatsApp 账号的（配对/允许列表），不是 per agent 的。
  • 对于共享群组，将群组绑定到一个 agent 或使用广播群组。

路由规则（消息如何选择 Agent） ​

Binding 是确定性的，最精确的优先：

  1. peer 匹配（精确 DM/群组/渠道 id）
  2. parentPeer 匹配（线程继承）
  3. guildId + roles（Discord 角色路由）
  4. guildId（Discord）
  5. teamId（Slack）
  6. 渠道 accountId 匹配
  7. 渠道级匹配（accountId: "*"）
  8. 回退到默认 agent（agents.list[].default，否则列表第一个，默认 main）

同一层级有多个 binding 匹配时，配置顺序中第一个优先。若 binding 同时设置了多个匹配字段（如 peer + guildId），所有字段均须满足（AND 语义）。

账号作用域重要细节：

  • 省略 accountId 的 binding 仅匹配默认账号。
  • 使用 accountId: "*" 作为跨所有账号的渠道级兜底。
  • 若之后为同一 agent 添加了含显式 accountId 的相同 binding，OpenClaw 会将现有的渠道级 binding 升级为账号范围，而不是重复添加。

多账号 / 多手机号 ​

支持多账号的渠道（如 WhatsApp）使用 accountId 标识每次登录。每个 accountId 可路由到不同 agent，从而在一台服务器上托管多个手机号而不混淆 session。

若想在省略 accountId 时有渠道默认账号，设置 channels.<channel>.defaultAccount（可选）。未设置时，OpenClaw 回退到 default（若存在），否则使用排序后的第一个已配置账号 id。

支持此模式的常见渠道：

  • whatsapp、telegram、discord、slack、signal、imessage
  • irc、line、googlechat、mattermost、matrix、nextcloud-talk
  • bluebubbles、zalo、zalouser、nostr、feishu

概念解释 ​

  • agentId：一个"大脑"（工作空间、per-agent 认证、per-agent session 存储）。
  • accountId：一个渠道账号实例（如 WhatsApp 账号 "personal" 与 "biz"）。
  • binding：通过 (channel, accountId, peer) 以及可选的 guild/team id 将入站消息路由到 agentId。
  • 直接聊天折叠到 agent:<agentId>:<mainKey>（per-agent 的"主"；session.mainKey）。

平台示例 ​

Discord：每个 Agent 一个 Bot ​

每个 Discord bot 账号映射到唯一的 accountId，将每个账号绑定到一个 agent 并为每个 bot 保留允许列表。

json5
{
  agents: {
    list: [
      { id: "main", workspace: "~/.openclaw/workspace-main" },
      { id: "coding", workspace: "~/.openclaw/workspace-coding" },
    ],
  },
  bindings: [
    { agentId: "main", match: { channel: "discord", accountId: "default" } },
    { agentId: "coding", match: { channel: "discord", accountId: "coding" } },
  ],
  channels: {
    discord: {
      groupPolicy: "allowlist",
      accounts: {
        default: {
          token: "DISCORD_BOT_TOKEN_MAIN",
          guilds: {
            "123456789012345678": {
              channels: {
                "222222222222222222": { allow: true, requireMention: false },
              },
            },
          },
        },
        coding: {
          token: "DISCORD_BOT_TOKEN_CODING",
          guilds: {
            "123456789012345678": {
              channels: {
                "333333333333333333": { allow: true, requireMention: false },
              },
            },
          },
        },
      },
    },
  },
}

说明：

  • 将每个 bot 邀请到服务器并启用 Message Content Intent。
  • Token 存放在 channels.discord.accounts.<id>.token（默认账号可用 DISCORD_BOT_TOKEN）。

Telegram：每个 Agent 一个 Bot ​

json5
{
  agents: {
    list: [
      { id: "main", workspace: "~/.openclaw/workspace-main" },
      { id: "alerts", workspace: "~/.openclaw/workspace-alerts" },
    ],
  },
  bindings: [
    { agentId: "main", match: { channel: "telegram", accountId: "default" } },
    { agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },
  ],
  channels: {
    telegram: {
      accounts: {
        default: {
          botToken: "123456:ABC...",
          dmPolicy: "pairing",
        },
        alerts: {
          botToken: "987654:XYZ...",
          dmPolicy: "allowlist",
          allowFrom: ["tg:123456789"],
        },
      },
    },
  },
}

说明：

  • 通过 BotFather 为每个 agent 创建一个 bot，复制各自 token。
  • Token 存放在 channels.telegram.accounts.<id>.botToken（默认账号可用 TELEGRAM_BOT_TOKEN）。

WhatsApp：每个 Agent 一个号码 ​

在启动 gateway 前先关联每个账号：

bash
openclaw channels login --channel whatsapp --account personal
openclaw channels login --channel whatsapp --account biz

~/.openclaw/openclaw.json（JSON5）：

js
{
  agents: {
    list: [
      {
        id: "home",
        default: true,
        name: "Home",
        workspace: "~/.openclaw/workspace-home",
        agentDir: "~/.openclaw/agents/home/agent",
      },
      {
        id: "work",
        name: "Work",
        workspace: "~/.openclaw/workspace-work",
        agentDir: "~/.openclaw/agents/work/agent",
      },
    ],
  },

  // 确定性路由：最先匹配的优先（最精确的放前面）。
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },

    // 可选的 per-peer 覆盖（示例：将特定群组发送到 work agent）。
    {
      agentId: "work",
      match: {
        channel: "whatsapp",
        accountId: "personal",
        peer: { kind: "group", id: "1203630...@g.us" },
      },
    },
  ],

  // 默认关闭：agent 间消息传递必须显式启用 + 允许列表。
  tools: {
    agentToAgent: {
      enabled: false,
      allow: ["home", "work"],
    },
  },

  channels: {
    whatsapp: {
      accounts: {
        personal: {},
        biz: {},
      },
    },
  },
}

示例：WhatsApp 日常聊天 + Telegram 深度工作 ​

按渠道分流：WhatsApp 路由到快速日常 agent，Telegram 路由到 Opus agent。

这就是"养两只龙虾"的典型玩法——一只负责日常，一只专攻深度思考。

json5
{
  agents: {
    list: [
      {
        id: "chat",
        name: "Everyday",
        workspace: "~/.openclaw/workspace-chat",
        model: "anthropic/claude-sonnet-4-6",
      },
      {
        id: "opus",
        name: "Deep Work",
        workspace: "~/.openclaw/workspace-opus",
        model: "anthropic/claude-opus-4-6",
      },
    ],
  },
  bindings: [
    { agentId: "chat", match: { channel: "whatsapp" } },
    { agentId: "opus", match: { channel: "telegram" } },
  ],
}

说明：

  • 若某渠道有多个账号，在 binding 中添加 accountId（如 { channel: "whatsapp", accountId: "personal" }）。
  • 若要将单个 DM/群组路由到 Opus 而其余保持在 chat，为该 peer 添加 match.peer binding；peer 匹配始终优先于渠道级规则。

示例：同一渠道，将单个 Peer 路由到 Opus ​

WhatsApp 保持在快速 agent，但将某个 DM 路由到 Opus：

json5
{
  agents: {
    list: [
      {
        id: "chat",
        name: "Everyday",
        workspace: "~/.openclaw/workspace-chat",
        model: "anthropic/claude-sonnet-4-6",
      },
      {
        id: "opus",
        name: "Deep Work",
        workspace: "~/.openclaw/workspace-opus",
        model: "anthropic/claude-opus-4-6",
      },
    ],
  },
  bindings: [
    {
      agentId: "opus",
      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551234567" } },
    },
    { agentId: "chat", match: { channel: "whatsapp" } },
  ],
}

Peer binding 始终优先，保持在渠道级规则上方。

家庭 Agent 绑定到 WhatsApp 群组 ​

将专用家庭 agent 绑定到单个 WhatsApp 群组，配置 mention 门控和更严格的工具策略：

json5
{
  agents: {
    list: [
      {
        id: "family",
        name: "Family",
        workspace: "~/.openclaw/workspace-family",
        identity: { name: "Family Bot" },
        groupChat: {
          mentionPatterns: ["@family", "@familybot", "@Family Bot"],
        },
        sandbox: {
          mode: "all",
          scope: "agent",
        },
        tools: {
          allow: [
            "exec",
            "read",
            "sessions_list",
            "sessions_history",
            "sessions_send",
            "sessions_spawn",
            "session_status",
          ],
          deny: ["write", "edit", "apply_patch", "browser", "canvas", "nodes", "cron"],
        },
      },
    ],
  },
  bindings: [
    {
      agentId: "family",
      match: {
        channel: "whatsapp",
        peer: { kind: "group", id: "120363999999999999@g.us" },
      },
    },
  ],
}

说明：

  • 工具允许/拒绝列表针对的是 tools，不是 skill。若 skill 需要运行二进制文件，确保 exec 已允许且二进制存在于沙箱中。
  • 对于更严格的门控，设置 agents.list[].groupChat.mentionPatterns 并为渠道保持群组允许列表启用。

Per-Agent 沙箱与工具配置 ​

每个 agent 可以有自己的沙箱和工具限制：

js
{
  agents: {
    list: [
      {
        id: "personal",
        workspace: "~/.openclaw/workspace-personal",
        sandbox: {
          mode: "off",  // personal agent 不使用沙箱
        },
        // 无工具限制——所有工具可用
      },
      {
        id: "family",
        workspace: "~/.openclaw/workspace-family",
        sandbox: {
          mode: "all",     // 始终沙箱化
          scope: "agent",  // 每个 agent 一个容器
          docker: {
            // 可选：容器创建后的一次性配置
            setupCommand: "apt-get update && apt-get install -y git curl",
          },
        },
        tools: {
          allow: ["read"],                    // 仅 read 工具
          deny: ["exec", "write", "edit", "apply_patch"],    // 拒绝其他
        },
      },
    ],
  },
}

注意：setupCommand 位于 sandbox.docker 下，在容器创建时运行一次。当解析的 scope 为 "shared" 时，per-agent sandbox.docker.* 覆盖会被忽略。

优点：

  • 安全隔离：限制不可信 agent 的工具
  • 资源控制：对特定 agent 使用沙箱，其余保持在主机
  • 灵活策略：每个 agent 不同权限

注意：tools.elevated 是全局的，基于发送者；不可 per-agent 配置。若需要 per-agent 边界，使用 agents.list[].tools 拒绝 exec。对于群组定向，使用 agents.list[].groupChat.mentionPatterns 使 @mentions 清晰地映射到目标 agent。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策