OpenClaw 多分身实战:一台服务器运行多个 AI 助手的完整教程

本文由 SugAi 机器人 整理发布:https://sug.xyz/rj/?p=2447


什么是 OpenClaw 多分身?

OpenClaw 支持在同一个 Gateway 进程中运行多个完全隔离的 AI 助手(Agent),每个助手拥有独立的工作区、记忆、人格和会话记录。这就是所谓的「多分身」功能,官方称为 Multi-Agent Routing(多智能体路由)

举个例子:你可以同时运行一个「工作助手」和一个「生活助手」,分别绑定不同的 Telegram Bot 或 WhatsApp 号码,互不干扰,数据完全隔离。

核心概念

在开始之前,先理解三个关键概念:

  • agentId:每个分身的唯一标识,比如 mainworkcoding
  • workspace:每个分身的工作目录,存放 SOUL.md、AGENTS.md、记忆文件等
  • binding:路由规则,决定哪条消息发给哪个分身

创建多个分身的步骤

第一步:使用向导创建分身

最简单的方式是使用内置向导命令:

openclaw agents add work
openclaw agents add coding
openclaw agents add social

每个分身会自动创建独立的工作区和配置目录,路径格式为:

  • 工作区:~/.openclaw/workspace-<agentId>
  • 状态目录:~/.openclaw/agents/<agentId>/agent
  • 会话记录:~/.openclaw/agents/<agentId>/sessions

第二步:配置 openclaw.json

编辑 ~/.openclaw/openclaw.json,添加 agents 列表和 bindings 路由规则:

{
  agents: {
    list: [
      {
        id: 

原文链接:

第三步:为每个分身绑定不同的频道账号

不同平台的绑定方式:

Telegram(推荐):每个分身创建一个独立的 Bot,通过 BotFather 获取 Token:

channels: {
  telegram: {
    accounts: {
      default: { botToken: 111111:AAA... },
      work:    { botToken: 222222:BBB... }
    }
  }
}

WhatsApp:每个分身绑定一个手机号,先登录再配置:

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

Discord:每个分身创建一个独立的 Bot 账号,分别配置 Token:

channels: {
  discord: {
    accounts: {
      default: { token: DISCORD_BOT_TOKEN_MAIN },
      coding:  { token: DISCORD_BOT_TOKEN_CODING }
    }
  }
}

第四步:自定义每个分身的人格

进入每个分身的工作区,编辑 SOUL.mdAGENTS.md 文件,赋予不同的性格和行为规则。比如:

  • 工作助手:严谨、专业、注重效率
  • 生活助手:轻松、幽默、善于聊天
  • 编程助手:专注代码、擅长调试、熟悉各种框架

第五步:重启并验证

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

高级玩法:一个 WhatsApp 号路由多个分身

如果你只有一个 WhatsApp 号,也可以根据发消息的人来路由到不同分身:

bindings: [
  {
    agentId: alex,
    match: { channel: whatsapp, peer: { kind: direct, id: +8613800000001 } }
  },
  {
    agentId: mia,
    match: { channel: whatsapp, peer: { kind: direct, id: +8613800000002 } }
  }
]

这样,不同联系人发来的消息会被路由到不同的 AI 分身处理,实现「一号多脑」。

路由优先级规则

当多条 binding 规则同时匹配时,按以下优先级决定:

  1. 精确匹配 peer(具体的 DM/群组 ID)
  2. 父级 peer 匹配(线程继承)
  3. Discord 服务器 + 角色匹配
  4. Discord 服务器匹配
  5. Slack 团队匹配
  6. accountId 匹配
  7. 频道级别匹配(accountId: \*\)
  8. 默认分身(agents.list 中 default: true 的那个)

注意事项

  • 每个分身的 agentDir 必须唯一,不能共用,否则会导致认证和会话冲突
  • 技能(Skills)默认是每个分身独立的,放在各自 workspace 的 skills/ 目录下;共享技能放在 ~/.openclaw/skills/
  • 分身之间默认不能互相通信,如需开启需在配置中显式允许
  • 每次修改配置后需要重启 Gateway 才能生效

总结

OpenClaw 的多分身功能非常强大,适合以下场景:

  • 工作/生活分离,避免 AI 助手混淆两种场景
  • 多人共用一台服务器,每人拥有独立的 AI 助手
  • 针对不同任务(编程、写作、客服)部署专属助手
  • 测试不同的 AI 模型或人格配置

配置完成后,你的 OpenClaw 就变成了一个真正的「AI 助手农场」,每个分身各司其职,高效运转。

" target="_blank">home,
default: true,
name: 家庭助手,
workspace: ~/.openclaw/workspace-home,
agentDir: ~/.openclaw/agents/home/agent
},
{
id: work,
name: 工作助手,
workspace: ~/.openclaw/workspace-work,
agentDir: ~/.openclaw/agents/work/agent
}
]
},
bindings: [
{ agentId: home, match: { channel: whatsapp, accountId: personal } },
{ agentId: work, match: { channel: whatsapp, accountId: biz } }
]
}

第三步:为每个分身绑定不同的频道账号

不同平台的绑定方式:

Telegram(推荐):每个分身创建一个独立的 Bot,通过 BotFather 获取 Token:

channels: {
  telegram: {
    accounts: {
      default: { botToken: 111111:AAA... },
      work:    { botToken: 222222:BBB... }
    }
  }
}

WhatsApp:每个分身绑定一个手机号,先登录再配置:

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

Discord:每个分身创建一个独立的 Bot 账号,分别配置 Token:

channels: {
  discord: {
    accounts: {
      default: { token: DISCORD_BOT_TOKEN_MAIN },
      coding:  { token: DISCORD_BOT_TOKEN_CODING }
    }
  }
}

第四步:自定义每个分身的人格

进入每个分身的工作区,编辑 SOUL.mdAGENTS.md 文件,赋予不同的性格和行为规则。比如:

  • 工作助手:严谨、专业、注重效率
  • 生活助手:轻松、幽默、善于聊天
  • 编程助手:专注代码、擅长调试、熟悉各种框架

第五步:重启并验证

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

高级玩法:一个 WhatsApp 号路由多个分身

如果你只有一个 WhatsApp 号,也可以根据发消息的人来路由到不同分身:

bindings: [
  {
    agentId: alex,
    match: { channel: whatsapp, peer: { kind: direct, id: +8613800000001 } }
  },
  {
    agentId: mia,
    match: { channel: whatsapp, peer: { kind: direct, id: +8613800000002 } }
  }
]

这样,不同联系人发来的消息会被路由到不同的 AI 分身处理,实现「一号多脑」。

路由优先级规则

当多条 binding 规则同时匹配时,按以下优先级决定:

  1. 精确匹配 peer(具体的 DM/群组 ID)
  2. 父级 peer 匹配(线程继承)
  3. Discord 服务器 + 角色匹配
  4. Discord 服务器匹配
  5. Slack 团队匹配
  6. accountId 匹配
  7. 频道级别匹配(accountId: \*\)
  8. 默认分身(agents.list 中 default: true 的那个)

注意事项

  • 每个分身的 agentDir 必须唯一,不能共用,否则会导致认证和会话冲突
  • 技能(Skills)默认是每个分身独立的,放在各自 workspace 的 skills/ 目录下;共享技能放在 ~/.openclaw/skills/
  • 分身之间默认不能互相通信,如需开启需在配置中显式允许
  • 每次修改配置后需要重启 Gateway 才能生效

总结

OpenClaw 的多分身功能非常强大,适合以下场景:

  • 工作/生活分离,避免 AI 助手混淆两种场景
  • 多人共用一台服务器,每人拥有独立的 AI 助手
  • 针对不同任务(编程、写作、客服)部署专属助手
  • 测试不同的 AI 模型或人格配置

配置完成后,你的 OpenClaw 就变成了一个真正的「AI 助手农场」,每个分身各司其职,高效运转。

版权声明:SugAi 发表于 2026-04-01 10:24:04。
转载请注明:OpenClaw 多分身实战:一台服务器运行多个 AI 助手的完整教程 | SUG 软件库

暂无评论

暂无评论...