这篇教程介绍如何获取 Telegram Bot Token,并将它配置到 OpenClaw 中完成连接。

一、获取 Telegram Bot Token

1. 打开 Telegram

在 Telegram 搜索:

@BotFather

进入官方机器人 BotFather

2. 开始创建机器人

给 BotFather 发送:

/start

然后继续发送:

/newbot

3. 设置机器人名称

BotFather 会提示你输入机器人名称。

这个名称主要用于显示,可以自由设置,例如:

OpenClaw 助手

机器人名称支持中文。

4. 设置机器人用户名

接着 BotFather 会要求你输入机器人的 username

要求如下:

必须以 bot 结尾

例如:

openclaw_xianyu_bot

或者:

my_openclaw_helper_bot

需要注意:这个用户名必须是全局唯一的,不能与其他人重复。

5. 复制 Token

创建成功后,BotFather 会返回一段 Token,格式类似:

1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

这一整串就是你的 Telegram Bot Token

复制时要确保完整,包括中间的冒号 :

二、配置到 OpenClaw

回到 OpenClaw 后台,进入:

设置 → Channels → Telegram → Connect

然后将刚刚复制的 Token 粘贴进去即可。

如果你使用命令行方式配置,一般类似这样:

openclaw channels add --channel telegram --token "你的Telegram Bot Token"

示例:

openclaw channels add --channel telegram --token "1234567890:AAHxxxxxxxxxxxxxxxx"

三、测试是否成功

1. 打开你的机器人

在 Telegram 中搜索你刚才设置的机器人用户名,例如:

@openclaw_xianyu_bot

点击进入。

2. 发送启动命令

给机器人发送:

/start

3. 回到 OpenClaw 检查状态

如果连接成功,OpenClaw 中的 Telegram 渠道通常会显示为已连接,或者你的机器人已经可以正常回复消息。

四、注意事项

1. 不要泄露 Token

Telegram Bot Token 相当于机器人的控制凭证,不要随意发给别人,也不要公开贴到截图、文档或代码仓库中。

2. Token 泄露后立即重置

如果 Token 已经泄露,可以回到 BotFather,发送:

/revoke

然后选择对应机器人,重新生成新的 Token。

3. 服务器网络要求

如果你的 OpenClaw 部署在国内服务器上,可能会出现无法连接 Telegram 的情况。

这通常不是 Token 本身的问题,而是服务器无法访问 Telegram 网络。遇到这种情况,需要先确认服务器具备访问 Telegram 的网络条件。

总结

整个流程可以概括为四步:

  1. 在 Telegram 中通过 @BotFather 创建机器人。
  2. 获取机器人返回的 Token。
  3. 将 Token 填入 OpenClaw 的 Telegram 渠道配置中。
  4. 通过 /start 测试机器人是否连接成功。

如果你只是卡在“Token 从哪里来”这一步,按本文操作一次基本就能完成配置。