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

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

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

🚀 开篇：为什么选Telegram？

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

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

第一步：创建Bot 🤖

1. 找到BotFather

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

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

2. 创建新Bot

发送命令：

/newbot

按提示操作：

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

3. 获取Token 🎯

创建成功后，BotFather会发送：

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：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz123456789",
      "allowFrom": [],
      "groups": {
        "requireMention": false,
        "allowedGroups": []
      }
    }
  }
}

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

第三步：连接通道 🔗

执行命令：

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

看到以下输出表示成功：

[telegram] Connecting...
[telegram] Bot info: @my_ai_helper_bot
[telegram] Webhook set successfully
[telegram] Connected ✓

检查状态：

1	openclaw channels status telegram

第四步：测试对话 🎉

私聊测试

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

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

群组测试

创建一个测试群组
将Bot添加到群组

@Bot并提问：

1	@my_ai_helper_bot 你好，请介绍一下自己

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

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

获取你的Telegram用户ID

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

更新配置

{
  "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，然后输入：

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

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

自定义欢迎消息

{
  "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

或在配置中指定：

{
  "channels": {
    "telegram": {
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

Q2: Bot不回复消息 ❌

排查步骤：

# 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的回复。

性能对比

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