Phase 6 / Ep 28: Telegram 深度集成 —— BotFather 到生产级机器人

⏱ 预计阅读 4 分钟 更新于 2026/4/13

🎯 学习目标：完整配置 Telegram 频道并达到生产质量。

1. BotFather 创建 Bot（详细步骤）

  1. Telegram 搜索 @BotFather，发送 /start
  2. /newbot → 输入 Bot 名称（如 "My OpenClaw Agent"）
  3. 输入 Bot 用户名（必须以 bot 结尾，如 my_openclaw_bot）
  4. 获得 Token：7123456789:AAHxxxxxxxxx

额外配置（推荐）

/setdescription - 设置 Bot 简介
/setabouttext - 设置"关于"信息
/setuserpic - 上传 Bot 头像
/setcommands - 设置命令菜单

推荐的命令菜单：

status - 查看 Agent 状态
clear - 清除当前会话
help - 获取帮助
logs - 查看最近日志
skills - 管理技能

2. 连接到 OpenClaw

# 添加 Telegram 频道
openclaw channels add telegram --token "7123456789:AAHxxx"

# 验证连接
openclaw channels status

3. Pairing 配对

sequenceDiagram
    participant User as 🧑 你
    participant TG as 📱 Telegram Bot
    participant GW as 🦀 Gateway

    User->>TG: 发送任意消息
    TG->>GW: 收到未配对用户消息
    GW->>TG: 返回 Pairing Code: "ABC123"
    TG->>User: "请在 CLI 中输入此配对码"
    User->>GW: openclaw channels pair ABC123
    GW->>GW: ✅ 配对成功
    User->>TG: "你好！"
    TG->>GW: 消息路由（已认证）
    GW->>User: "你好！我是你的 Agent..."

4. 私聊 vs 群组

模式 配置 Agent 行为
私聊 默认 所有消息都响应
群组 需要 @mention 仅 @bot 时响应
群组管理员 白名单 仅管理员可执行命令

5. Telegram 专属命令

命令 CLI 等价 说明
/status openclaw status 查看状态
/clear openclaw sessions clear 清除会话
/help openclaw --help 帮助
/logs openclaw logs 查看日志
/skills list openclaw skills list 列出技能
/restart openclaw gateway restart 重启（需管理员）

下节预告： Ep 29，Discord 深度集成——创建 Application、配置 OAuth2、部署 Bot 到服务器。