OpenClaw 多 Agent 配置实战：踩坑指南与最佳实践

如果你已经用了一段时间 OpenClaw，肯定会遇到这样的需求：我需要一个专门写博客的 AI 助手，一个写小说的，一个做代码开发的……每个都有独立的角色定位、工作目录和配置。这就是多 Agent 配置要解决的问题。

本文不是理论教程，而是实战踩坑记录。我会告诉你配置过程中会遇到哪些坑，为什么会踩坑，以及怎么避免和解决。

场景隔离。不同的工作场景需要不同的 AI 助手：

• 博客助手：专注于技术写作，熟悉你的博客部署流程，有独立的文章草稿目录
• 小说助手：创意写作风格，管理小说章节和人物设定，不需要访问技术代码
• 开发助手：熟悉代码规范，可以执行敏感命令，但不应该访问私人笔记
• 家庭助手：绑定到家庭 WhatsApp 群，只能访问受限的工具集，保护隐私

独立配置。每个 Agent 有自己的：

• Workspace：独立的工作目录，互不干扰
• SOUL.md：独立的角色定位和性格设定
• Model：可以给不同 openclaw Agent 配置不同模型（Opus 做深度思考，Sonnet 做日常聊天）
• Tool Policy：限制某些 Agent 的工具权限（比如家庭助手不能执行 shell 命令）

账号路由。多个 Telegram bot 或 WhatsApp 账号，路由到不同的 Agent，一个 Gateway 管理所有账号。

举个例子，你可能会配置这样的 Agent：

• ：日常聊天，全功能
• ：工作场景，可以访问项目文档
• ：创作助手，专注于写作
• ：开发助手，执行代码相关任务

这会在配置文件中添加：

⚠️ 第一个坑：模型 ID 格式

配置模型时，要用别名，不要带日期后缀！

为什么？

带日期的 ID 会在新版本发布时失效。别名（如 ）会自动指向最新版本。

验证配置：

每个 Agent 的 workspace 下创建 ，定义它的角色：

创建 ：

⚠️ 第二个坑：不要创建 BOOTSTRAP.md

如果你手动创建了 ，Agent 会一直卡在 bootstrapping 状态！

为什么？

是 Agent 的”初始化任务清单”。Agent 启动后会执行里面的指令，执行完才会删除这个文件。如果你手动创建了这个文件但内容不完整，Agent 会不断尝试执行，永远无法进入正常状态。

解决方法：

多 Agent 的典型用法是配置多个 Telegram bot，每个 bot 路由到不同的 Agent。

在 Telegram 找 @BotFather，创建 bot：

按提示输入名称和用户名，获得 token（类似 ）。

假设你创建了两个 bot：

• → token1
• → token2

编辑 （或用 ）：

⚠️ 第三个坑：dmPolicy 默认值

如果不设置 ，默认是 ，这意味着用户必须先执行 命令才能聊天。但如果配置有问题， 可能也不会响应，消息会被静默丢弃！

解决方法：

明确设置 ，并配置 列表：

获取你的 Telegram user ID：给 @userinfobot 发消息。

添加 将不同的 Telegram 账号路由到不同的 Agent：

路由规则优先级：

1. 精确匹配（具体的 DM 或群组 ID）
2. 匹配（哪个 Telegram 账号）
3. 匹配（哪个平台）
4. 默认 Agent（ 或列表中第一个）

测试：给两个 bot 发 ，应该分别收到来自不同 Agent 的回复。

现象：

我想给 添加一个新账号，执行：

结果其他账号的配置全没了！

原因：

对嵌套对象是整体替换，不是增量修改！

如果配置是：

执行 会导致：

解决方法：

patch 时带上完整的对象：

同样适用于 、 等数组或对象。

最佳实践：

配置变更前，先导出当前配置：

现象：

给 bot 发 或任何消息，都没有回复。

可能的原因 1：dmPolicy 配置问题

检查配置：

如果是 或未设置，改成 ：

可能的原因 2：Telegram 409 冲突

症状： 日志中有 错误。

原因： 同一个 bot token 被多个实例同时使用！常见场景：

• OpenClaw.app (GUI) 和 CLI gateway 同时运行
• 两个 terminal 同时启动了 gateway

检查：

如果看到多个进程（GUI app 和 CLI gateway），说明冲突了。

解决方法：

1. 退出 OpenClaw.app (GUI)
2. 重启 CLI gateway：

教训：

同一个 Telegram bot token 只能被一个 Gateway 实例使用。如果要切换 GUI/CLI，必须先停掉其中一个。

现象：

配置了 ，但消息还是路由到了错误的 Agent。

检查绑定：

常见错误：

1. 顺序错误：更具体的规则要放在前面

2. accountId 拼写错误：检查是否与 中的 key 一致

解决方法：

Gateway 需要重启才能加载新配置：

检查 Agent 是否正常启动：

如果看到某个 Agent 状态异常，查看日志：

现象：

我在顶层配置了 ，为什么某个账号还是用了不同的策略？

原因：

配置有继承关系，account 级别的配置会覆盖顶层配置：

最佳实践：

• 如果所有账号都用相同策略，配置在顶层
• 如果某个账号需要不同策略，在 account 级别覆盖
• 明确写出每个 account 的 ，避免继承混淆

教训： 我曾因为没仔细审查 patch 命令，把所有 Telegram 账号配置冲掉，导致所有 bot 连接中断。

规则：

• 任何 、、模型变更等操作，先审查一遍
• 嵌套对象（、）必须带完整列表
• 有疑问先导出当前配置对比

输出包括：

• 每个 Agent 的状态
• Channel 连接状态
• 最近的错误日志

如果某个 Agent 或 Channel 异常，会直接显示。

常见错误关键词：

• ：Telegram bot 冲突
• ：token 错误或过期
• ：消息被访问控制策略拦截
• ：路由规则问题

不要一次性配置所有 Agent 和 Channel，容易出错且难以排查。

推荐流程：

1. 先配置一个新 Agent（不配置 Telegram），本地测试
2. Agent 正常后，添加一个 Telegram bot，测试路由
3. 验证通过后，再添加其他 Agent 和 bot
4. 每次变更后，验证所有已有功能正常

在 workspace 下创建 ，记录：

• 每个 Agent 的用途和配置
• Telegram bot 对应关系
• 特殊配置的原因

OpenClaw 多 Agent 配置不复杂，但有几个容易踩的坑：

1. config.patch 陷阱：嵌套对象是整体替换，不是增量修改
2. 模型 ID：用别名（），不要带日期
3. BOOTSTRAP.md：不要手动创建，会导致 Agent 卡住
4. dmPolicy：默认是 ，建议改成
5. Telegram 409：同一个 bot token 只能被一个 Gateway 使用
6. 配置继承：account 级别配置会覆盖顶层配置

核心原则：

• 配置前先备份
• 变更后先验证
• 出问题先看日志
• 分阶段逐步配置

希望这篇文章能帮你少走弯路。如果还有其他问题，欢迎在评论区讨论！