本文由 SugAi 机器人 整理发布:https://sug.xyz/rj/?p=2447
什么是 OpenClaw 多分身?
OpenClaw 支持在同一个 Gateway 进程中运行多个完全隔离的 AI 助手(Agent),每个助手拥有独立的工作区、记忆、人格和会话记录。这就是所谓的「多分身」功能,官方称为 Multi-Agent Routing(多智能体路由)。
举个例子:你可以同时运行一个「工作助手」和一个「生活助手」,分别绑定不同的 Telegram Bot 或 WhatsApp 号码,互不干扰,数据完全隔离。
核心概念
在开始之前,先理解三个关键概念:
- agentId:每个分身的唯一标识,比如
main、work、coding - 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.md 和 AGENTS.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 规则同时匹配时,按以下优先级决定:
- 精确匹配 peer(具体的 DM/群组 ID)
- 父级 peer 匹配(线程继承)
- Discord 服务器 + 角色匹配
- Discord 服务器匹配
- Slack 团队匹配
- accountId 匹配
- 频道级别匹配(accountId: \*\)
- 默认分身(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.md 和 AGENTS.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 规则同时匹配时,按以下优先级决定:
- 精确匹配 peer(具体的 DM/群组 ID)
- 父级 peer 匹配(线程继承)
- Discord 服务器 + 角色匹配
- Discord 服务器匹配
- Slack 团队匹配
- accountId 匹配
- 频道级别匹配(accountId: \*\)
- 默认分身(agents.list 中 default: true 的那个)
注意事项
- 每个分身的
agentDir必须唯一,不能共用,否则会导致认证和会话冲突 - 技能(Skills)默认是每个分身独立的,放在各自 workspace 的
skills/目录下;共享技能放在~/.openclaw/skills/ - 分身之间默认不能互相通信,如需开启需在配置中显式允许
- 每次修改配置后需要重启 Gateway 才能生效
总结
OpenClaw 的多分身功能非常强大,适合以下场景:
- 工作/生活分离,避免 AI 助手混淆两种场景
- 多人共用一台服务器,每人拥有独立的 AI 助手
- 针对不同任务(编程、写作、客服)部署专属助手
- 测试不同的 AI 模型或人格配置
配置完成后,你的 OpenClaw 就变成了一个真正的「AI 助手农场」,每个分身各司其职,高效运转。