大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

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

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

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

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

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

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

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

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

GPT plus 代充 只需 145

这会在配置文件中添加：

讯享网

⚠️ 第一个坑：模型 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 级别配置会覆盖顶层配置

核心原则：

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

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