下载Telegram后如何接入OpenClaw?

ic_date 2026-03-25
博客列表

Telegram(也叫 TG、电报、纸飞机)接入比飞书还简单,我的第一只小龙虾就是对接的TG,OpenClaw 对 Telegram 的支持是原生内置的,属于生产就绪级别,不需要装额外插件。

OpenClaw 底层用的是 grammY 框架,默认走 Long Polling 模式,这意味着:不需要服务器、不需要域名、不需要公网 IP,你家里的电脑就能跑。

话不多说,跟着截图走,10 分钟搞定。

开始之前,你需要准备

  • OpenClaw— 已经安装好并能正常运行
  • Telegram 账号— 注册并可正常使用
  • 网络环境— 需能访问 Telegram API(中国大陆需代理)

Step 1:在 Telegram 中创建 Bot

打开 Telegram,搜索 @BotFather(这是 Telegram 官方的机器人管理工具),向他发送 ​​/newbot​​ 命令。

 

 

 

PS: 注意,选ID是@BotFather这个才是对的哈,其他的都是冒牌

 

 

 

接下来 BotFather 会问你两个问题:

  1. 机器人的显示名称(Display Name),比如​​Baoxing OpenClaw Bot​
  2. 机器人的用户名(必须以​​bot​​ 结尾),比如​​baoxing_openclaw_bot​

 

 

 

创建成功后,BotFather 会返回一个 Bot Token,长这样:

 

123456789:ABCdefGhIJKlmNoPQRsTUVwxYZ

 

Bot Token 就是你机器人的”密码”,千万别泄露出去!复制保存好,下一步要用。

Step 2:在 OpenClaw 中添加 Telegram 渠道

回到你的终端,执行:

 

openclaw channels add

 

 

选择 Telegram,然后把 Step 1 中 BotFather 给你的 Bot Token 粘贴进去,根据引导完成配置即可。

 

 

 

选择 ​​Yes​

 

 

选择 ​​Telegram​

 

 

选择​​default​

 

 

 

粘贴 Bot Token

 

 

 

 

选择 DM 策略(私聊访问控制),选择​​No​

 

 

 

选择​​No​

 

 

 

选择​​No​

配置完成后,重启网关:

 

openclaw gateway restart

 

 

 

 

启动后,OpenClaw 默认使用 Long Polling 模式自动监听 Telegram 消息,不需要公网域名,不需要任何额外配置。很省心有木有???

Step 3:见证奇迹的时刻

打开 Telegram,搜索你刚创建的机器人用户名,发送 ​​/start​​ 或者直接发一条消息。

 

 

首次连接会返回一个配对码,回终端批准一下:

 

openclaw pairing approve telegram <配对码>
  • 1.
 

PS:配对码有效期为 1 小时,过期了重新发消息会生成新的。配对只需要批准一次,后续自动连接。

 

 

成了!你的 Telegram 已经变成了一个 AI 助手的入口。

直接在 TG 里跟 AI 对话,发文字、发图片都可以,就像跟朋友聊天一样自然。

 

 

 

避坑指南

❌ Bot Token 复制的时候多了空格或换行,导致连接失败

❌ 中国大陆网络无法直接访问 Telegram API,需要先配好代理

❌ 忘记批准配对码,干等着机器人回复

✅ Token 直接从 BotFather 的消息里复制,最准确

✅ Long Polling 模式不需要服务器,本地就能跑

✅ 配对码只需要批准一次,后续自动连接

✅ 获取你的 Telegram 数字 ID:查看 ​​openclaw logs --follow​​​ 日志,或者访问 ​​https://api.telegram.org/bot<TOKEN>/getUpdates​

问题解答

机器人不响应? → 检查 Bot Token 是否正确 + 网络是否能访问 ​​api.telegram.org​​ + 是否已批准配对

如何重置 Bot Token? → 在 BotFather 中发送 ​​/token​​​,选择对应机器人重新生成,然后更新配置并 ​​openclaw gateway restart​

网络不稳定,API 时断时续? → 可以在配置中设置 ​​channels.telegram.proxy​​​ 走代理,或调整 ​​autoSelectFamily​​ 强制 IPv4