第 13 章：Telegram 通道 📱

适合人群：想用手机跟 Agent 聊天的你 本章目标：从零创建 Telegram Bot，绑定到 OpenClaw，实现手机聊天

13.1 在 BotFather 创建 Bot

Telegram 的 Bot 系统是它的王牌功能。你只需要跟一个叫 BotFather 的官方机器人聊几句，就能创建你自己的 AI Bot，全程免费。

什么是 BotFather？

BotFather 是 Telegram 官方的"机器人爸爸"——所有 Telegram Bot 都要通过它来创建和管理。在 Telegram 上搜索 @BotFather，点进去，你就找到组织了。

创建步骤

第一步：打开 BotFather

在 Telegram 中搜索 @BotFather，或者直接点击这个链接：

https://t.me/botfather

[截图：BotFather 的对话界面，显示 /start 命令后的欢迎消息]

第二步：输入 /newbot

在聊天框里输入 /newbot，BotFather 会问你几个问题。

第三步：给你的 Bot 起名字

BotFather: Alright, a new bot. How are we going to call it? Please choose a name for your bot.

输入一个人类可读的名字，比如 我的 AI 助手。这个名字会显示在 Bot 的个人资料里。

第四步：给你的 Bot 取用户名

BotFather: Good. Now let's choose a username for your bot. It must end in 'bot'. Like this, for example: TetrisBot or tetris_bot.

注意规则：

必须以 bot 结尾
只能包含字母、数字和下划线
必须是全局唯一的

例如：wode_ai_zhushou_bot 或者 myassistant_666_bot。

如果名字被占了，换个花样再试。

第五步：拿到 Token（最重要！）

成功后，BotFather 会发给你一条包含 token 的消息：

Done! Congratulations on your new bot. You will find it at:
t.me/wode_ai_zhushou_bot

Use this token to access the HTTP API:
7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

For a description of the Bot API, see this page:
https://core.telegram.org/bots/api

⚠️ 这一长串 7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw 就是你的 Bot Token，相当于密码，千万别泄露给别人！ 别人拿到这个 Token 就能冒充你的 Bot。

[截图：BotFather 返回的成功消息，token 部分打码]

13.2 配置 Bot Token

拿到 Token 后，把它告诉 OpenClaw 就行了。

方式一：命令行配置（推荐）

openclaw config set channels.telegram.botToken "7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw"

方式二：直接编辑配置文件

打开 ~/.openclaw/openclaw.json，添加或找到 Telegram 配置部分：

{
  // ... 其他配置
  channels: {
    telegram: {
      botToken: "7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
    },
  },
}

配置 Agent 绑定

默认情况下，Telegram Bot 会绑定到 default Agent。如果你想指定另一个 Agent：

openclaw config set channels.telegram.agent "my-agent"

或者通过配置文件：

{
  channels: {
    telegram: {
      botToken: "7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
      agent: "my-agent",  // 绑定到指定 Agent
    },
  },
}

重启 Gateway

改完配置一定要重启 Gateway：

openclaw gateway restart

13.3 绑定到 Agent

什么是「绑定」

配置 botToken 只是让 Telegram Bot "连上线"。要让别人能跟你 Agent 说上话，还需要一个**配对（Pairing）**步骤。这是 OpenClaw 的安全机制，避免陌生人随便用你的 AI 资源。

第一次对话（DM 配对）

第一步：找到你的 Bot

在 Telegram 搜索栏输入你 Bot 的用户名（比如 @wode_ai_zhushou_bot），点进去。

第二步：发送 /start

先发一条 /start。

这时 OpenClaw 终端会显示一个配对码：

[telegram] New pairing request from user "武彬" (123456789)
  Code: 8427
  Use: openclaw pairing approve telegram 8427

[截图：终端中出现配对请求的画面]

第三步：批准配对

在终端中执行：

openclaw pairing approve telegram 8427

看到 ✔ Pairing approved 就成功了。

第四步：开始聊天

现在在 Telegram 里发任何消息，你的 Agent 都会回答你了！

配置群组访问

想让 Bot 在群组里工作，还需要配置群组策略：

# 允许所有群组中的所有人使用
openclaw config set channels.telegram.channelPolicy.open true

# 或者限制在指定群组
openclaw config set channels.telegram.channelPolicy.allowlist '["-1001234567890"]'

如何获取群组 ID？把 Bot 加入群组后，发一条消息，然后访问：

https://api.telegram.org/bot<你的TOKEN>/getUpdates

在返回的 JSON 里找 chat.id，就是群组 ID。

用户验证模式

OpenClaw Telegram 通道支持几种对话模式：

模式	说明	配置方式
配对模式（默认）	必须终端批准才能聊天	`pairing: true`
开放模式	谁都能直接聊	`pairing: false`
允许列表	只允许指定的用户	`allowFrom: ["用户ID1","用户ID2"]`
禁止列表	禁止指定用户使用	`blockFrom: ["用户ID1"]`

13.4 收发消息

基本聊天

配置好之后，直接在 Telegram 里给 Bot 发消息就行。所有功能都能用：

我：帮我查一下今天天气
Bot（Agent）：好的，我查一下。北京今天 28°C，晴转多云，适合出门哦☀️

我：帮我给张三写一封邮件，约他明天下午三点开会
Bot：好的，邮件草稿如下：
主题：明天下午三点开会
内容：张总你好，明天下午三点方便开个会吗？...
确认要发送吗？

群组中使用

把 Bot 拉进群组，然后在消息中 @Bot 即可：

张三：@wode_ai_zhushou_bot 明天的项目排期是什么？
Bot：明天的项目排期如下：
上午 10:00 - 需求评审会
下午 14:00 - 代码 review
下午 16:00 - 周报提交

[截图：Telegram 群组中 @Bot 并收到回复]

💡 小贴士：在群组中，必须 @Bot 它才会响应。如果不想 @ 也能响应，可以把 Bot 设为管理员并关闭群组隐私模式（在 BotFather 中使用 /setprivacy 设为 Disabled）。

文件收发

Telegram Bot 支持收发文件：

发图片：Bot 可以认出图片内容（取决于 AI 模型是否支持多模态）
发文档：PDF、Word、文本文件，Agent 可以读取和分析
发语音：Bot 能接收语音消息（部分模型支持语音转文字）

我：[发了一张菜单照片]
Bot：我看看菜单图片...这是王记牛肉面的菜单。推荐他们的招牌牛肉面，28 元一碗，好评最多👍

命令支持

你可以在 Telegram 中直接运行 OpenClaw 命令：

/skill     —— 列出当前可用的技能
/session   —— 查看当前会话信息
/clear     —— 清空会话历史
/help      —— 查看帮助

常见问题

Q：Bot 没反应？ 先确认 Gateway 有没有启动：openclaw gateway status。再确认 Token 配置是否正确：openclaw config get channels.telegram.botToken。最后检查防火墙：确保 OpenClaw 能访问 Telegram API（api.telegram.org）。

Q：配对成功后 Bot 还是不回复？ 检查 DM 配对列表：openclaw pairing list telegram。如果显示已配对，重启 Gateway 试试。

Q：群组里 Bot 不响应 @ ？ 确认 Bot 已被设为群组管理员，并且群组隐私模式已关闭。

本章小结

步骤	操作
1️⃣ 创建 Bot	Telegram 中找 @BotFather，发 `/newbot`
2️⃣ 获取 Token	保存 BotFather 返回的 `xxx:xxx` 格式字符串
3️⃣ 配置	`openclaw config set channels.telegram.botToken "你的Token"`
4️⃣ 重启	`openclaw gateway restart`
5️⃣ 配对	发 `/start`，然后 `openclaw pairing approve telegram 代码`
6️⃣ 开始聊	在 Telegram 中跟 Bot 聊天！

想想看——现在你在手机上就能访问你的 AI Agent 了。坐地铁时让它查资料，吃饭时让它读文档，这就是 OpenClaw 的便利之处。

下一章，我们来配置 WhatsApp，让你的 Agent 能跟微信好友沟通！

← 第 12 章 · Gateway——一切的中心第 14 章 · WhatsApp 通道 →

系统教程，帮你把工具用好，再回到任务中。浏览任务方案 →