佛系程序员_ OpenClaw 多 Telegram 机器人两种架构

学习笔记

发布日期: 2026-04-19 13:09:25

喜欢量: 5 个

阅读次数: 38

推荐第二种做类似openteam的，多角色岗位机器人+同群协作+多项目隔离，所有 Telegram 子机器人，共用同一个主 Agent / 共享工作空间

### 一、核心原理
OpenClaw 多 Telegram 机器人 = **多账号（accounts）+ 多Agent + 路由绑定（bindings）**：每个 bot 对应一个独立 `accountId`、独立 Agent（独立 workspace/记忆），通过 bindings 把消息精准路由到对应 Agent。

### 二、步骤1：创建多个 Telegram Bot（获取Token）
1. 打开 Telegram，搜索 @BotFather
2. 依次发送 `/newbot`，按提示给每个 bot 起**名称**和**用户名（必须以bot结尾）**
3. 复制每个 bot 生成的 **Bot Token**（格式：`123456:ABCdef...`）
4. （可选）对每个 bot 发送 `/setprivacy` → 选 bot → 选 `Disable`，让 bot 能读取群消息

### 三、步骤2：配置 OpenClaw（修改 openclaw.json）
配置文件路径：`~/.openclaw/openclaw.json`（Windows：`C:\Users\你的用户名\.openclaw\openclaw.json`）

#### 2.1 定义多个 Agent（独立工作区）
在 `agents.list` 里添加多个 Agent，每个有唯一 `id`、独立 `workspace`：
```json
"agents": {
  "list": [
    {
      "id": "main",
      "name": "主助手",
      "workspace": "~/.openclaw/workspace-main",
      "identity": {"name": "主Bot", "emoji": "🤖"}
    },
    {
      "id": "work",
      "name": "工作助手",
      "workspace": "~/.openclaw/workspace-work",
      "identity": {"name": "工作Bot", "emoji": "💼"}
    },
    {
      "id": "dev",
      "name": "开发助手",
      "workspace": "~/.openclaw/workspace-dev",
      "identity": {"name": "开发Bot", "emoji": "💻"}
    }
  ]
}
```

#### 2.2 配置 Telegram 多账号（accounts）
把原来的单 `botToken` 改成 `accounts` 对象，每个 key 是 **accountId**（自定义，如 main_bot、work_bot），填入对应 Token、权限策略：
```json
"channels": {
  "telegram": {
    "enabled": true,
    "accounts": {
      "main_bot": {
        "botToken": "你的主Bot Token",
        "dmPolicy": "allowlist",  // 私聊仅允许列表用户
        "allowfrom": [123456789],  // 你的Telegram用户ID（@userinfobot获取）
        "groupPolicy": "allowlist",
        "streamMode": "partial"
      },
      "work_bot": {
        "botToken": "你的工作Bot Token",
        "dmPolicy": "allowlist",
        "allowfrom": [123456789],
        "groupPolicy": "allowlist",
        "streamMode": "partial"
      },
      "dev_bot": {
        "botToken": "你的开发Bot Token",
        "dmPolicy": "allowlist",
        "allowfrom": [123456789],
        "groupPolicy": "allowlist",
        "streamMode": "partial"
      }
    }
  }
}
```
- dmPolicy：`pairing`（默认，需配对）/ `allowlist`（仅允许指定用户）/ `open`（所有人可聊）
- allowfrom：填入你的 Telegram 用户 ID（@userinfobot 查）

#### 2.3 绑定路由（bindings，核心）
添加 `bindings` 数组，把每个 `accountId` 绑定到对应 `agentId`，实现消息分流：
```json
"bindings": [
  {
    "agentId": "main",
    "match": {"channel": "telegram", "accountId": "main_bot"}
  },
  {
    "agentId": "work",
    "match": {"channel": "telegram", "accountId": "work_bot"}
  },
  {
    "agentId": "dev",
    "match": {"channel": "telegram", "accountId": "dev_bot"}
  }
]
```

### 四、步骤3：重启 Gateway 生效
1. 保存 openclaw.json
2. 终端执行：
```bash
openclaw gateway restart
# 或先停再启
openclaw gateway stop
openclaw gateway start
```
3. 查看日志确认多账号启动成功：`openclaw gateway logs`

### 五、步骤4：测试与配对
1. 分别打开 Telegram 里的 3 个 bot，发送 `/start`
2. 若 dmPolicy=pairing：在主 bot 或日志里获取配对码，发送给新 bot 完成配对
3. 分别给 3 个 bot 发消息，验证：
   - 消息路由到对应 Agent
   - 每个 bot 有独立记忆、独立 workspace

### 六、常见问题与避坑
1. 消息路由到默认 main Agent（不按 bindings）：
   - 检查 `accountId` 拼写是否完全一致（大小写敏感）
   - 确认 bindings 数组格式正确、无语法错误
   - 升级 OpenClaw 到最新版（旧版有路由bug）
2. 无法启动/Token 错误：
   - 核对每个 botToken 正确、无空格
   - 确保每个 bot 未被封禁、用户名正确
3. 权限问题：
   - allowfrom 必须填正确的用户 ID，否则收不到回复
   - 群聊需 `/setprivacy Disable` 并添加 bot 为管理员

### 完整配置示例（可直接复制修改）
```json
{
  "agents": {
    "list": [
      {"id": "main", "name": "主助手", "workspace": "~/.openclaw/workspace-main", "identity": {"name": "主Bot", "emoji": "🤖"}},
      {"id": "work", "name": "工作助手", "workspace": "~/.openclaw/workspace-work", "identity": {"name": "工作Bot", "emoji": "💼"}}
    ]
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "main_bot": {"botToken": "TOKEN1", "dmPolicy": "allowlist", "allowfrom": [123456789]},
        "work_bot": {"botToken": "TOKEN2", "dmPolicy": "allowlist", "allowfrom": [123456789]}
      }
    }
  },
  "bindings": [
    {"agentId": "main", "match": {"channel": "telegram", "accountId": "main_bot"}},
    {"agentId": "work", "match": {"channel": "telegram", "accountId": "work_bot"}}
  ]
}
```

需要我帮你生成**可直接替换的完整 openclaw.json 模板**（只需填入你的 Token 和用户 ID）吗？

先给你**直接结论**，再讲架构、适配方案、多项目隔离写法，完全贴合你说的场景：
> 场景：
> 1. 多个 Telegram 机器人 = 不同岗位角色（项目经理/产品/架构/开发/测试）
> 2. 全员在**同一个工作群**协作、互相@、对话联动
> 3. 多项目并行：不同项目组隔离，互不干扰
> 4. 共用一套项目上下文，但角色分工独立

---

## 一、先回答核心问题
### 1. 我上一条说的「一Bot绑定一独立Agent隔离记忆」适合这个场景吗？
**❌ 不适合**
- 那种方案是：每个机器人完全割裂、独立记忆、独立工作区，各干各的
- 无法共享同一个项目文档、任务、对话上下文
- 没法在同一个群里互相@协作、接力完成全栈交付

### 2. 多角色岗位机器人+同群协作+多项目隔离，用什么架构？
✅ **正确架构（OpenClaw + OpenTeams 标准团队模式）**
1. **所有 Telegram 子机器人，共用同一个主 Agent / 共享工作空间**
2. 通过**角色人设、技能分工、权限职责**做区分，不是靠隔离记忆
3. 群内支持：@指定角色Bot 触发对应岗位响应、互相追问、评审、对接
4. 靠**项目标签/会话空间/上下文隔离**，实现多项目分开管理
5. 天然对标 OpenTeams 全栈交付团队模式

---

## 二、两种架构核心区别（一眼看懂）

| 模式 | 多Bot隔离模式（上一轮方案） | 团队协作模式（你现在需要） |
|------|------------------------------|----------------------------|
| 记忆/上下文 | 完全独立，互不共享 | 全局共享项目上下文 |
| 工作区 | 独立 workspace | 统一共享 workspace |
| 协作能力 | 无法互相@、无法接力协作 | 群内互相@、跨角色评审、任务流转 |
| 适用场景 | 个人工具Bot、互不相关独立业务 | 全栈团队、多岗位协作、同一项目交付 |
| 多项目管理 | 完全割裂 | 标签/频道/会话隔离，柔性区分 |
| 角色定义 | 无角色区分 | 固定岗位人设+专属技能栈 |

---

## 三、你要的最终形态（完全匹配 OpenTeams 团队）
### 1. 机器人结构
- 多个 Telegram Bot（pm_bot、pd_bot、arch_bot、dev_bot、test_bot）
- **全部挂载到同一个 Telegram 渠道下的多账号**
- **全部绑定同一个主 Agent**，共享：
  - 项目文档
  - 需求池
  - 代码方案
  - 聊天上下文
  - 任务列表

### 2. 角色差异化怎么做？
不靠隔离，靠**系统提示词 + 技能插件 + 职责限定**
- 项目经理Bot：管控排期、风险、进度、任务拆解
- 产品经理Bot：需求梳理、PRD、原型逻辑、规则设计
- 架构师Bot：技术选型、架构设计、性能、安全、部署方案
- 开发Bot：编码、排错、接口、Flutter/后端开发
- 测试Bot：用例、测试报告、Bug 复盘

### 3. 同群协作逻辑
在同一个 Telegram 群组：
- @架构师 讨论技术方案
- @产品 确认需求边界
- @开发 写代码/改Bug
- @项目经理 同步进度、排期
Bot 之间可以互相引用上文、接续对话、反驳/评审/补充方案，**完全团队化协作**

### 4. 多项目互不干扰怎么实现？
关键：**同Agent、多会话空间隔离**
两种成熟方案任选：
1. ** Telegram 多群组隔离**
   - 项目A 专属协作群
   - 项目B 专属协作群
   同一个团队所有角色Bot 全部加入多个群，群上下文天然隔离

2. **单群内 项目标签隔离（推荐）**
   消息带指令标记：
   - `[项目A] 需求变更`
   - `[项目B] 架构优化`
   Agent 全局识别标签，自动分割项目上下文、知识库、任务

---

## 四、对应 OpenClaw 配置写法（极简可直接用）
### 1. telegram 多账号保留（多个角色Bot）
多个 botToken 保留，代表不同岗位账号
```json
"telegram": {
  "enabled": true,
  "accounts": {
    "bot_pm": {"botToken": "xxx", "nickname": "项目经理"},
    "bot_pd": {"botToken": "xxx", "nickname": "产品经理"},
    "bot_arch": {"botToken": "xxx", "nickname": "系统架构师"},
    "bot_dev": {"botToken": "xxx", "nickname": "全栈开发"},
    "bot_test": {"botToken": "xxx", "nickname": "测试工程师"}
  }
}
```

### 2. 关键点：bindings 全部绑定**同一个 Agent**
```json
"bindings": [
  {"agentId": "team_all", "match": {"channel":"telegram","accountId":"bot_pm"}},
  {"agentId": "team_all", "match": {"channel":"telegram","accountId":"bot_pd"}},
  {"agentId": "team_all", "match": {"channel":"telegram","accountId":"bot_arch"}},
  {"agentId": "team_all", "match": {"channel":"telegram","accountId":"bot_dev"}},
  {"agentId": "team_all", "match": {"channel":"telegram","accountId":"bot_test"}}
]
```

### 3. 唯一团队 Agent 配置
```json
"agents": {
  "list": [
    {
      "id": "team_all",
      "name": "全栈交付团队",
      "workspace": "~/.openclaw/workspace-team",
      "teamMode": true,
      "identity": {
        "role": "multi-role collaboration team"
      }
    }
  ]
}
```

---

## 五、补充关键细节（踩坑重点）
1. **必须开启 teamMode**
   开启后才支持：角色分流、@唤醒、多身份轮询、团队记忆共享

2. **每个Bot独立昵称&头像**
   在 BotFather 分别设置头像、名称，群里一眼区分岗位

3. **@唤醒机制**
   OpenClaw 原生支持：
   - 不@全员静默
   - @对应机器人才会响应，避免全员乱回复

4. 和 OpenTeams 对比
- OpenTeams 是**封装好的成品团队框架**
- 你现在这套 OpenClaw 多Bot同Agent，是**自建轻量化 OpenTeams 平替**
- 自定义度更高、更适合异国部署、本地模型混合调用

---

## 六、总结一句话
- 各司其职、互不关联业务 → 一Bot一独立Agent（上一轮方案）
- **同项目团队协作、互相@、岗位分工、多项目并行** →
  多 Telegram Bot 多账号 + **绑定同一个共享Agent + team团队模式 + 群/标签隔离项目**

---

需要我给你一份：
**完整可直接落地的 openclaw.json 最终配置**（含5个岗位机器人、teamMode开启、多项目兼容、群@唤醒配置）吗？直接复制改token就能跑。

yyii

https://amtb.info/show/Mzc2

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