OpenClaw 多 Agent 架构配置指南

🔧 Step 0：先配置消息接收渠道

⚠️ 本案例需要发送通知到你的手机，先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →

这个场景解决什么问题

单个 Agent 处理所有任务会导致上下文混乱：工作记忆和私人记忆互相污染。通过多 Agent 配置，不同渠道走不同 Agent，记忆完全独立。

直接复制这段：工作/生活双 Agent 配置

在 ~/.openclaw/openclaw.json 中：

{
  "agents": {
    "list": [
      {
        "id": "work",
        "name": "工作助手",
        "workspace": "~/.openclaw/workspaces/work"
      },
      {
        "id": "life",
        "name": "生活助手",
        "workspace": "~/.openclaw/workspaces/life"
      }
    ]
  },
  "bindings": [
    {
      "match": { "channel": "feishu" },
      "agentId": "work"
    },
    {
      "match": { "channel": "telegram" },
      "agentId": "life"
    }
  ]
}

保存后重启：

openclaw gateway restart

验证配置生效

# 查看所有 Agent 状态
openclaw status --all

# 查看当前配置
openclaw config get agents

变体 A：按用户路由（不同人用不同 Agent）

{
  "agents": {
    "list": [
      { "id": "vip", "workspace": "~/.openclaw/workspaces/vip" },
      { "id": "default", "workspace": "~/.openclaw/workspace" }
    ]
  },
  "bindings": [
    {
      "match": {
        "channel": "telegram",
        "peer": { "kind": "dm", "id": "123456789" }
      },
      "agentId": "vip"
    },
    {
      "match": { "channel": "telegram" },
      "agentId": "default"
    }
  ]
}

bindings 按顺序匹配，第一条符合的规则生效，所以把更精确的规则放前面。

变体 B：按 Telegram 群组路由

{
  "bindings": [
    {
      "match": {
        "channel": "telegram",
        "peer": { "kind": "group", "id": "-1001234567890" }
      },
      "agentId": "work"
    },
    {
      "match": { "channel": "telegram" },
      "agentId": "life"
    }
  ]
}

变体 C：最简单的单 Agent 多渠道

如果只是想在多个渠道用同一个 Agent（不需要隔离），无需配置 bindings：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot Token"
    },
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}

给每个 Agent 不同的 SOUL.md

在各自的工作区目录放不同的 SOUL.md：

~/.openclaw/workspaces/work/SOUL.md    ← 工作风格：严谨、简洁
~/.openclaw/workspaces/life/SOUL.md    ← 生活风格：轻松、有趣

管理命令

# 重启所有 Agent
openclaw gateway restart

# 查看 Agent 列表
openclaw status --all

# 查看特定 Agent 的会话
openclaw sessions list --agent work

注意事项

• bindings 按顺序匹配，先写精确规则，再写兜底规则
• 每个 Agent 有独立 workspace，SOUL.md、HEARTBEAT.md 互不影响
• 多 Agent 会占用更多内存，2核2G VPS 建议最多 2 个 Agent
• Telegram 的 peer.id 是用户的数字 ID，可以在 Bot 收到消息后用 openclaw logs 查看