OpenClaw 多智能体路由完全指南

OpenClaw 支持在一个 Gateway 中运行多个隔离的智能体（独立的 workspace + agentDir + sessions），以及多个渠道账号（如两个 WhatsApp）。

什么是”一个智能体”？

一个智能体是一个完整的作用域，包含：

• Workspace（文件、AGENTS.md/SOUL.md/USER.md、本地笔记、角色规则）
• 状态目录（agentDir）— 用于认证配置、模型注册和每个智能体的配置
• 会话存储（聊天历史 + 路由状态）在 ~/.openclaw/agents/<agentId>/sessions

路径映射

• 配置：~/.openclaw/openclaw.json（或 OPENCLAW_CONFIG_PATH）
• 状态目录：~/.openclaw（或 OPENCLAW_STATE_DIR）
• Workspace：~/.openclaw/workspace
• 智能体目录：~/.openclaw/agents/<agentId>/agent
• 会话：~/.openclaw/agents/<agentId>/sessions

单智能体模式（默认）

默认情况下，OpenClaw 运行单个智能体：

• agentId 默认为 main
• 会话键为 agent:main:<mainKey>
• Workspace 默认为 ~/.openclaw/workspace
• 状态默认为 ~/.openclaw/agents/main/agent

快速开始

第一步：创建每个智能体的 Workspace

openclaw agents add coding
openclaw agents add social

每个智能体获得自己的 Workspace，包含 SOUL.md、AGENTS.md 和可选的 USER.md，以及专门的 agentDir 和会话存储。

第二步：创建渠道账号

为每个智能体创建一个账号：

• Discord：每个智能体一个机器人
• Telegram：通过 BotFather 为每个智能体创建一个机器人
• WhatsApp：链接每个手机号

openclaw channels login --channel whatsapp --account work

第三步：添加智能体、账号和绑定

在 agents.list 下添加智能体，在 channels.<channel>.accounts 下添加渠道账号，用 bindings 连接它们。

第四步：重启并验证

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

使用智能体向导

使用向导添加新的隔离智能体：

openclaw agents add work

然后添加 bindings（或让向导处理）来路由入站消息。

验证：

openclaw agents list --bindings

认证配置

认证配置是每个智能体独立的。每个智能体从自己的文件读取：

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

主智能体凭证不会自动共享。切勿在不同智能体之间重用 agentDir（会导致认证/会话冲突）。如果需要共享凭证，将 auth-profiles.json 复制到其他智能体的 agentDir。

相关资源

• Gateway 配置
• Skills 指南
• 会话管理

更多详细信息请访问：OpenClaw 官方多智能体文档