多代理路由
在同一网关上运行多个代理——独立工作区、模型与会话。支持多个频道账户（如两个 WhatsApp）；入站通过绑定路由到代理。
什么是「一个代理」？
代理是完整作用域的大脑，拥有自己的：
- 工作区（文件、AGENTS.md/SOUL.md/USER.md、本地笔记、人设规则）。
- 状态目录（
agentDir）：认证配置、模型注册表与每代理配置。 - 会话存储（聊天历史与路由状态）：
~/.clawdbot/agents/<agentId>/sessions。
认证配置按代理。每个代理从自己的 ~/.clawdbot/agents/<agentId>/agent/auth-profiles.json 读取。主代理凭证不会自动共享。切勿在代理之间复用 agentDir（会导致认证/会话冲突）。若需共享凭证，将 auth-profiles.json 复制到另一代理的 agentDir。技能通过各工作区的 skills/ 目录按代理提供，共享技能来自 ~/.clawdbot/skills。见 技能：每代理与共享。网关可托管一个代理（默认）或多个代理。工作区说明： 每个代理的工作区是默认 cwd，不是硬沙箱；相对路径在工作区内解析，但绝对路径仍可访问主机其他位置，除非启用沙箱。见 沙箱。
路径速查
- 配置：
~/.clawdbot/moltbot.json（或CLAWDBOT_CONFIG_PATH） - 状态目录：
~/.clawdbot（或CLAWDBOT_STATE_DIR） - 工作区：
~/clawd（或~/clawd-<agentId>） - 代理目录：
~/.clawdbot/agents/<agentId>/agent（或agents.list[].agentDir） - 会话：
~/.clawdbot/agents/<agentId>/sessions
单代理模式（默认）
若不配置，Moltbot 运行单一代理：agentId 默认为 main；会话键为 agent:main:<mainKey>；工作区默认 ~/clawd（或设置 CLAWDBOT_PROFILE 时为 ~/clawd-<profile>）；状态默认 ~/.clawdbot/agents/main/agent。
代理向导
使用代理向导添加新的隔离代理：moltbot agents add work。然后添加 bindings（或由向导完成）以路由入站消息。验证：moltbot agents list --bindings。
多代理 = 多人、多角色
多代理时，每个 agentId 是完全隔离的角色：不同电话号码/账户（每频道 accountId）；不同人设（每代理工作区文件如 AGENTS.md、SOUL.md）；独立认证与会话（除非显式启用否则无交叉）。这样多人可共享同一网关服务器，同时保持各自的 AI「大脑」与数据隔离。
一个 WhatsApp 号、多人（私信分流）
可在一个 WhatsApp 账户上将不同私信路由到不同代理。使用 peer.kind: "dm" 并按发送者 E.164（如 +15551234567）匹配。回复仍来自同一 WhatsApp 号（无每代理发送者身份）。重要：直聊会折叠到代理的主会话键，因此要真正隔离需要每人一个代理。绑定示例与更多路由配置见英文文档。