OpenClaw入门：第7讲：Telegram通道连接实战，5分钟部署你的AI Bot

github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好，我是正在实战各种AI项目的程序员晚枫。

今天我们来实战连接Telegram，这是OpenClaw最简单的入门通道。整个过程只需要5分钟，我带你一步步做。

🚀 开篇：为什么选Telegram？

我推荐Telegram作为第一个接入的通道，有这几个原因：

优势说明
免费稳定Bot API完全免费，无消息限制
国内可用相比WhatsApp更容易访问（需要代理）
功能丰富支持Markdown、按钮、文件等
生态完善文档齐全，社区活跃
配置简单只需要一个Token，不需要扫码

第一步：创建Bot 🤖

1. 找到BotFather

在Telegram中搜索 @BotFather，点击Start。

💡 BotFather是Telegram官方的Bot管理器，所有Bot都通过它创建。

2. 创建新Bot

发送命令：

1
/newbot

按提示操作：

  1. 输入Bot名称（如：我的AI助手）
  2. 输入用户名（必须以bot结尾，如：my_ai_helper_bot）

3. 获取Token 🎯

创建成功后，BotFather会发送：

1
2
3
4
5
Done! Congratulations on your new bot.
Use this token to access the HTTP API:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz123456789

 bot will be able to use HTTP requests to communicate with it.

⚠️ 重要：Token只显示一次！务必复制保存！

第二步：配置OpenClaw

编辑 ~/.openclaw/openclaw.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz123456789",
      "allowFrom": [],
      "groups": {
        "requireMention": false,
        "allowedGroups": []
      }
    }
  }
}

配置说明：
| 参数 | 说明 | 测试阶段建议 |
|------|------|------------|
| botToken | 填入刚才获得的Token | - |
| allowFrom | 空数组=允许所有人 | ✅ 先这样测试 |
| requireMention | false=私聊直接响应 | ✅ 私聊不需要@ |

第三步：连接通道 🔗

执行命令：

1
2
# 连接Telegram通道
openclaw channels connect telegram

看到以下输出表示成功：

1
2
3
4
[telegram] Connecting...
[telegram] Bot info: @my_ai_helper_bot
[telegram] Webhook set successfully
[telegram] Connected ✓

检查状态：

1
openclaw channels status telegram

第四步：测试对话 🎉

私聊测试

  1. 在Telegram中搜索你的Bot用户名（如@my_ai_helper_bot）
  2. 点击Start或发送任意消息
  3. 等待AI回复

💡 如果你没有Telegram，可以跳过这步，下一讲连接微信也能测试。

群组测试

  1. 创建一个测试群组
  2. 将Bot添加到群组
  3. @Bot并提问：
    1
    @my_ai_helper_bot 你好，请介绍一下自己

第五步：配置权限（生产环境）🔐

测试通过后，强烈建议限制访问权限：

获取你的Telegram用户ID

  1. 在Telegram中搜索 @userinfobot
  2. 发送任意消息
  3. 它会回复你的用户信息：
    1
    2
    Id: 123456789
    First: 你的名字

更新配置

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-token",
      "allowFrom": [123456789],
      "groups": {
        "requireMention": true,
        "allowedGroups": [-1001234567890]
      }
    }
  }
}

参数说明：
| 参数 | 说明 |
|------|------|
| allowFrom | 只有这个ID能私聊Bot |
| requireMention | 群组中需要@才响应 |
| allowedGroups | 只有这些群组能用 |

重载配置：

1
openclaw gateway reload

高级配置

设置Bot命令菜单

向BotFather发送 /setcommands，然后输入：

1
2
3
4
start - 开始对话
help - 获取帮助
reset - 重置会话
status - 查看状态

设置后，用户在Bot界面会看到快捷命令按钮。

自定义欢迎消息

1
2
3
4
5
6
7
8
{
  "channels": {
    "telegram": {
      "welcomeMessage": "你好！我是AI助手，有什么可以帮你的？",
      "helpMessage": "你可以：\n1. 直接提问\n2. @我获取帮助\n3. 发送 /reset 重置对话"
    }
  }
}

消息格式支持

Telegram支持丰富的消息格式：

格式语法示例
粗体**文字**加粗
斜体__文字__斜体
代码`代码`code
代码块语言\n代码\n多行代码
链接[文字](url)链接

常见问题解决 🛠️

Q1: 连接失败，提示网络错误 ❌

原因：国内访问Telegram需要代理

解决：

1
2
3
# 设置代理环境变量
export HTTPS_PROXY=http://127.0.0.1:7890
openclaw channels connect telegram

或在配置中指定：

1
2
3
4
5
6
7
{
  "channels": {
    "telegram": {
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

Q2: Bot不回复消息 ❌

排查步骤：

1
2
3
4
5
6
7
8
9
10
# 1. 检查Gateway是否运行
openclaw gateway status

# 2. 查看日志
tail -f ~/.openclaw/state/logs/channels.log | grep telegram

# 3. 确认Bot Token正确
openclaw channels test telegram

# 4. 检查用户是否在allowFrom列表

Q3: 群组中Bot不响应 ❌

原因：没有@Bot，或requireMention为true

解决：

  • 确保消息中包含 @bot用户名
  • 或将 requireMention 设为 false

Q4: 提示"chat not found" ❌

原因：Bot还没有和用户建立过对话

解决：用户必须先给Bot发一条消息，才能收到Bot的回复。

性能对比

项目TelegramWhatsAppDiscord
配置难度⭐⭐⭐⭐⭐⭐
配置速度5分钟15分钟10分钟
稳定性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
国内访问⚠️需代理⚠️较困难✅可用
功能丰富度⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐

下节预告

下一讲连接WhatsApp，全球用户量最大的即时通讯工具。

👉 继续阅读：第8讲-WhatsApp通道连接与多设备管理

💬 加入学习交流群

Telegram连接问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第6讲-通道连接概述

下一篇： 第8讲-WhatsApp通道连接与多设备管理

PS：Telegram是最适合初学者的通道，建议先把它调通，再尝试其他平台。

💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务：AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！

进群

嗨，扫码 进群

微信

扫一扫，分享到微信

微信分享二维码
本站总访问量次

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置：

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

编程博主，全网粉丝30w+，开源项目：python-office，我的微信：python-office