大家好，我是正在实战各种AI项目的程序员晚枫。
今天我们来实战连接Telegram，这是OpenClaw最简单的入门通道。整个过程只需要5分钟。
为什么选择Telegram？
| 优势 | 说明 |
|---|---|
| 免费稳定 | Bot API完全免费，无消息限制 |
| 国内可用 | 相比WhatsApp更容易访问 |
| 功能丰富 | 支持Markdown、按钮、文件等 |
| 生态完善 | 文档齐全，社区活跃 |
第一步：创建Bot
1. 找到BotFather
在Telegram中搜索 @BotFather，这是官方Bot管理器。
2. 创建新Bot
发送命令：
1 | /newbot |
按提示操作：
- 输入Bot名称（如：我的AI助手）
- 输入用户名（必须以bot结尾，如：my_ai_helper_bot）
3. 获取Token
创建成功后，BotFather会发送：
1 | Done! Congratulations on your new bot. |
保存好这个Token！ 它相当于Bot的密码。
第二步：配置OpenClaw
编辑 ~/.openclaw/openclaw.json：
1 | { |
配置说明：
botToken：填入刚才获得的TokenallowFrom：空数组表示允许所有人（测试阶段）requireMention：false表示私聊直接响应，不需要@Bot
第三步：连接通道
执行命令：
1 | # 连接Telegram通道 |
看到以下输出表示成功：
1 | [telegram] Connecting... |
检查状态：
1 | openclaw channels status telegram |
第四步：测试对话
私聊测试
- 在Telegram中搜索你的Bot用户名（如@my_ai_helper_bot）
- 点击Start或发送任意消息
- 等待AI回复
群组测试
- 创建一个测试群组
- 将Bot添加到群组
- @Bot并提问：
1
@my_ai_helper_bot 你好，请介绍一下自己
第五步：配置权限（生产环境）
测试通过后，建议限制访问权限：
获取你的用户ID
- 给
@userinfobot发送任意消息 - 它会回复你的用户信息：
1
2
3@yourname
Id: 123456789
First: 你的名字
更新配置
1 | { |
重载配置：
1 | openclaw gateway reload |
高级配置
设置Bot命令菜单
向BotFather发送 /setcommands，然后输入：
1 | start - 开始对话 |
用户在Bot界面会看到命令按钮。
自定义欢迎消息
1 | { |
消息格式支持
Telegram支持丰富的消息格式：
- 粗体：
**文字** - 斜体：
__文字__ 代码：`代码`代码块：用三个反引号包裹
常见问题
Q1: 连接失败，提示网络错误
解决：国内访问Telegram需要代理
1 | # 设置代理环境变量 |
或在配置中指定：
1 | { |
Q2: Bot不回复消息
排查步骤：
- 检查Gateway是否运行：
openclaw gateway status - 查看日志：
tail ~/.openclaw/state/logs/channels.log - 确认Bot Token正确
- 检查用户是否在allowFrom列表
Q3: 群组中Bot不响应
原因：没有@Bot，或requireMention为true
解决：
- 确保消息中包含
@bot用户名 - 或将
requireMention设为 false
下节预告
下一讲连接WhatsApp，这是全球使用最广泛的即时通讯工具。
💬 加入学习交流群
Telegram连接问题？加群交流：
👉 点击加入交流群
推荐：AI Python编程实战营
🎁 限时福利：送《利用Python进行数据分析》实体书
👉 点击了解详情
—## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。
课程导航
上一篇： 第6讲-通道连接概述
PS：Telegram是最适合初学者的通道，建议先把它调通，再尝试其他平台。
