概述


一、为什么选择 Telegram

Telegram 配置最简单,适合:

  • 有国际业务需要和海外用户沟通
  • 想体验 Telegram Bot 的开发者
  • 作为测试渠道使用

优势:不需要企业认证,个人即可使用


二、整体流程

第一步:创建 Telegram Bot
    ↓
第二步:获取 Bot Token
    ↓
第三步:在 OpenClaw 中配置
    ↓
第四步:验证连接

三、Step 1:创建 Telegram Bot

3.1 找 BotFather

1. 在 Telegram 搜索 @BotFather 2. 点击 Start 开始对话

3.2 创建新 Bot

发送命令:

/newbot

BotFather 会要求你: 1. 输入 Bot 名称(如"我的AI助手") 2. 输入用户名(必须以 bot 结尾,如 myai_bot

创建成功后,BotFather 会给你一个 Bot Token

Use this token to access the HTTP API:
123456789:ABCDefGhIJKlmNoPQRsTUVwxyz1234567890

⚠️ 妥善保存这个 Token,等于 Bot 的密码。


四、Step 2:在 OpenClaw 中配置

openclaw configure

选择 Telegram 渠道,输入:

Telegram Bot Token:123456789:ABCDefGhIJKlmNoPQRsTUVwxyz1234567890

五、Step 3:验证连接

1. 在 Telegram 搜索你的 Bot 名称 2. 点击 Start 或发送:

/start

3. 给 Bot 发消息:

你好

4. 验证 AI 回复成功


六、配置文件示例

"channels": {
  "telegram": {
    "enabled": true,
    "token": "123456789:ABCDefGhIJKlmNoPQRsTUVwxyz1234567890",
    "dmPolicy": "allowlist",
    "allowFrom": ["你的Telegram UserId"]
  }
}

七、获取 Telegram UserId

如果你设置了 dmPolicy: allowlist,需要添加你的 UserId。

获取方式: 1. 在 Telegram 搜索 @userinfobot 2. 给它发消息,它会返回你的 UserId


八、常见问题

Q: Bot 收不到消息
A: 检查:
  • Bot Token 是否正确
  • Bot 是否已被拉入群
  • 网络是否能访问 Telegram(需要代理)

问题:需要代理吗? 答:如果服务器在国内,需要配置代理才能访问 Telegram API。

Q: Telegram Bot API Token 泄露了?
A: 立即在 @BotFather 处撤销并重新生成 Token,同时更新 OpenClaw 配置。
Q: Telegram 消息格式不支持?
A: Telegram 支持 MarkdownV2 和 HTML,配置 messageFormat 参数选择格式。
Q: Telegram BotFather 在哪?
A: 在 Telegram 中搜索 @BotFather,这是官方机器人创建入口。

九、下一步学什么

  • 3.5 Discord 配置全攻略 → Discord 渠道配置
  • 3.6 多渠道同时运行配置 → 同时运行多个渠道
  • 3.7 渠道权限管理 → 控制谁能访问

Telegram 是最容易配置的渠道,门槛最低!