佛系程序员_ OpenClaw 多Agent（main/pm/coder）+ Telegram单群配置踩坑笔记

学习笔记

网站开发

发布日期: 2026-04-21 01:32:55

喜欢量: 7 个

阅读次数: 80

# OpenClaw 多Agent（main/pm/coder）+ Telegram单群配置踩坑笔...

# OpenClaw 多Agent（main/pm/coder）+ Telegram单群配置踩坑笔记

核心目标：配置3个独立Agent（main核心助手、pm项目经理、coder开发工程师），共用1个Telegram群，实现多Bot独立响应、无串号、权限正常，解决所有报错和无响应问题。

今日踩坑全记录\+解决方案，按操作顺序整理，重点标注坑点和关键步骤，避免后续重复踩坑。

## 一、前期准备（基础配置，无坑）

- 创建3个OpenClaw Agent：main（默认）、pm、coder
```
openclaw agents add pm
openclaw agents add coder
```

- 创建3个Telegram Bot（通过@BotFather），获取各自Token

- 将3个Bot全部拉进同一个Telegram群（后续群升级为超级群，引发坑点）
设置某个admin后，升级为超级群。群ID更新了。

## 二、核心踩坑点\+解决方案（按报错/问题出现顺序）

### 坑点1：创建Agent时，不小心选了“Copy auth profiles from "main"? ”（Yes），导致多Agent授权不隔离

问题表现：pm、coder的auth\-profiles\.json和main一模一样，包含Kimi、Z\.ai的API Key，无法实现独立隔离。

原因：OpenClaw机制——无论创建Agent时选Yes/No，都会默认继承main的授权模板（隐藏坑）。

解决方案：

1. 打开路径：C:\\Users\\Administrator\\\.openclaw\\agents\\pm\\ 和 C:\\Users\\Administrator\\\.openclaw\\agents\\coder\\

2. 找到auth\-profiles\.json，全部清空，替换为空JSON：\{\}

3. main的auth\-profiles\.json可保留API Key，实现“main有权限，pm/coder纯净隔离”

```
Copy auth profiles from "main"? → N
Configure model/auth for this agent now? → N
Configure DM access policies now? → N
```

### 坑点2：疑问“多Agent能否共用1个Telegram群？peer.id是否可填同一个”

问题困惑：担心多个Agent绑定同一个群ID会冲突、串消息。

解答：完全可以！OpenClaw区分Agent靠“Bot的accountId（Token）”，而非群ID，同群多Bot可独立响应。

关键配置：bindings中，3个Agent的peer.id全部填同一个群ID，accountId对应各自Bot的标识（bot-main、bot-pm、bot-coder）。

### 坑点3：Telegram私聊Bot出现“配对请求”，配对后不知道在哪里查看，且群聊无响应

问题表现：私聊Bot弹出配对码（如 ABC123DE），批准后群聊@Bot仍无反应，命令行显示待配对请求。

原因1：未批准配对请求，Bot无法响应任何消息；原因2：未给群聊开白名单，群内消息被拦截。

解决方案：

1. 批准配对：运行命令 openclaw pairing approve telegram 配对码（如openclaw pairing approve telegram ABC123DE）

2. 查看配对记录：命令行运行 openclaw pairing list telegram（查看已批准用户）

3. 给群聊开白名单（初期错误操作，后续修正）

### 坑点4：配置群白名单时，命令报错“Config validation failed: channels.telegram.groupAllowFrom: invalid config: must be array”

问题表现：。

~~原因：groupAllowFrom的格式错误，需用数组格式填写，且新版OpenClaw对群ID和用户ID的配置字段有区分。~~

~~临时解决方案（后续被修正~~）：

1. 运行正确命令：

2. 重启网关：openclaw gateway 是自动重启的

### 坑点5：继续报错“Invalid allowFrom entry: ; - allowFrom/groupAllowFrom authorization expects numeric Telegram sender user IDs only”

问题表现：群白名单配置仍报错，提示groupAllowFrom只能填用户ID（正数），不能填群ID（负数）。

原因：字段用错——groupAllowFrom用于配置“用户白名单”，群ID（负数）需用“groups”字段配置。

正确解决方案：

1. 配置群白名单：

2. 清空错误的 groupAllowFrom：

3. 重启网关：openclaw gateway

### 坑点6：配置全对，但Bot私聊/群聊均无响应，命令行报错“user declined directory sharing C:\\Users\\Administrator\\\.openclaw\\sandboxes\\agent\-main\-f331f052”

问题表现：Bot收到消息但不回复，命令行显示模型启动失败，提示Docker无权限访问沙箱目录。

原因：OpenClaw默认开启Docker沙箱，Docker未获得OpenClaw沙箱目录的访问权限，导致模型无法运行。

解决方案（最有效，彻底解决）：

1. 打开openclaw\.json，给每个Agent添加sandbox配置，关闭沙箱：

2. 在agents\.list中每个Agent节点添加：sandox->mode->off

3. 重启网关：openclaw gateway

### 坑点7：命令行提示“Group migrated: -123456789 → -1234567891235”，群聊仍无响应

问题表现：群聊@Bot仍无反应，命令行显示群ID迁移，旧群ID失效。

原因：Telegram群升级为超级群，系统自动生成新的群ID（负数，前缀多了-100），旧群ID（-513289879）失效，所有配置中的群ID需更新。

解决方案：

1. 将openclaw.json中所有旧群ID（）替换为新群ID（）：

2. channels\.telegram\.groups 中的群ID

3. bindings中每个Agent的peer.id

4. 重启网关：openclaw gateway

### 坑点8：群聊发送/help @Bot，提示“you are not authorized to use this command”

问题表现：Bot已收到消息，但提示无权限使用命令，说明权限配置错误。

原因：allowFrom配置位置错误——将用户ID（）放在了根目录auth.allowFrom（全局权限），而Telegram渠道的权限需配置在channels\.telegram\.allowFrom中。

解决方案：

1. 删除根目录的auth节点（完全不需要）

2. 在channels.telegram内部添加allowFrom配置：

3. 重启网关：openclaw config reload \+ openclaw gateway restart

### 坑点9：疑问“$schema一行的作用”“auth必须加吗”

解答：

1. ```"$schema": "https://raw.githubusercontent.com/openclaw/openclaw/main/schemas/config.schema.json",```
 仅用于编辑器（如VS Code）自动提示、语法检查，对OpenClaw运行无任何作用，可直接删除。

2. 根目录auth节点：完全不需要添加，Telegram的权限仅需配置在channels.telegram.allowFrom中即可。

## 三、最终可用的openclaw.json（精简干净版）

仅保留核心配置，无多余内容，直接复制替换即可使用（只需填写3个Bot的Token）：

```json
{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace",
      "model": {
        "primary": "ollama/qwen3:8b"
      },
      "sandbox": {
        "mode": "none"
      }
    },
    "list": [
      { "id": "main", "default": true },
      { "id": "pm" },
      { "id": "coder" }
    ]
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "allowFrom": [123456789],  // 你的Telegram用户ID，唯一权限配置
      "dmPolicy": "allowlist",
      "groups": {
        "*": { 
          "requireMention": true  // 必须@Bot才响应，避免乱回复
        }
      },
      "accounts": {
        "bot-main": { "botToken": "填入main Bot的Token" },
        "bot-pm": { "botToken": "填入pm Bot的Token" },
        "bot-coder": { "botToken": "填入coder Bot的Token" }
      }
    }
  },
  "bindings": [
    {
      "agentId": "main",
      "match": { "channel": "telegram", "accountId": "bot-main", "peer": { "kind": "group", "id": -10023456789 } }
    },
    {
      "agentId": "pm",
      "match": { "channel": "telegram", "accountId": "bot-pm", "peer": { "kind": "group", "id": -1003995823875 } }
    },
    {
      "agentId": "coder",
      "match": { "channel": "telegram", "accountId": "bot-coder", "peer": { "kind": "group", "id": -1003995823875 } }
    }
  ]
}
```

## 四、必做的补充设置（避免后续踩坑）

1. Telegram Bot设置（每个Bot都要做）：

- 打开@BotFather，发送/setprivacy，选中对应Bot，设为Disabled（否则群内@Bot无反应）

2. 生效命令（每次修改配置后必运行）：
    现在都热重启了

3. 测试命令（验证配置是否正常）：
    - 群聊发送：@Bot昵称 /help 或 @Bot昵称 你好
		@Bot昵称 问这个群的ID是什么？
    - 正常响应即代表配置全部生效 会立即出现一个眼睛动图。

## 五、总结（核心避坑要点）

- 多Agent授权隔离：pm/coder的auth\-profiles\.json必须清空为\{\}，仅main可保留API Key。

- 同群多Bot配置：靠accountId（Bot Token）区分Agent，peer\.id可全部填同一个群ID。

- 群ID坑点：Telegram群升级为超级群会变ID，需及时更新所有配置中的群ID。

- Docker沙箱：必关！添加
        ``` "sandbox": {
          "mode": "off",
          "scope": "agent"
        } ```，否则模型无法运行。

- 权限配置：Telegram用户白名单必须写在channels.telegram.allowFrom，根目录auth可删除。

- Bot隐私设置：必须关闭Group Privacy（@BotFather设置），否则群内@无反应。

> （注：文档部分内容可能由 AI 生成）

yyii

https://amtb.info/show/Mzc5

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !