OpenClaw Telegram 绑定教程

本文档提供 OpenClaw 与 Telegram Bot 绑定的专注教程，仅包含必要的步骤。

步骤 1：创建 Telegram Bot

1. 打开 Telegram，搜索 **@BotFather**

2. 发送 `/newbot`

3. 按照提示：

输入机器人的**显示名称**（例如：`My OpenClaw Bot`）
输入机器人的**用户名**（必须以 `bot` 结尾，例如：`my_openclaw_bot`）

4. 创建成功后，BotFather 会返回 **HTTP API Token**（格式如：`1234567890:AAxxxxxx`）

5. 保存 Token，后续步骤需要使用

步骤 2：写入 Token 到 OpenClaw

方式 A：命令行快速登录

在终端运行：

openclaw channels login --channel telegram

按提示粘贴 Token。

该命令自动完成配置写入和通道启用。

方式 B：手动配置写入

执行以下两条命令：

openclaw config set channels.telegram.botToken "你的_BotToken"
openclaw config set channels.telegram.enabled true

配置会持久化到 `openclaw.json`。

步骤 3：重启 Gateway

配置写入后，执行重启使配置生效：

openclaw gateway restart

等待网关重启完成。

步骤 4：首次私聊触发配对

此步骤仅在首次绑定时需要执行一次。

1. 在 Telegram 中找到 Bot

2. 点击 **Start** 按钮，或发送任意消息

3. Bot 会回复一个 6 位数的配对码（例如：`ABC123`）

4. 在终端执行：

openclaw pairing list telegram

查看待批准的配对请求。

openclaw pairing approve telegram ABC123

（将 `ABC123` 替换为实际配对码）

5. 配对成功后，Telegram 消息开始转发到 OpenClaw

步骤 5：测试

在 Telegram 向 Bot 发送一条消息：

如果收到回复，说明绑定成功
如果无响应，检查：
网关状态：`openclaw gateway status`
Token 是否正确
配对状态：`openclaw pairing list telegram`

可选：配置群组使用

默认情况下，Bot 不会响应群组所有消息。如需要在群组使用，需进行以下设置：

关闭隐私模式

1. 在 Telegram 中找到 `@BotFather`

2. 发送 `/setprivacy`

3. 选择机器人

4. 选择 `Disable`

5. 关闭隐私后，**必须将 Bot 从群组移除并重新添加**，设置才会生效

配置群组规则

编辑 `openclaw.json`，在 `telegram` 下添加 `groups` 配置：

{
  "channels": {
    "telegram": {
      "botToken": "你的_BotToken",
      "enabled": true,
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

`"*"`：对所有群组生效（也可指定具体群组 ID）
`"requireMention": true`：只响应 @Bot 的消息（推荐设置）

重启网关：

openclaw gateway restart

常见问题

问题	原因	解决
Bot 不回复（私聊）	Token 错误	检查 Token 是否与 BotFather 一致
	未重启 gateway	执行 `openclaw gateway restart`
	未批准配对	完成步骤 4 的配对流程
群组无响应	隐私模式未关闭	BotFather `/setprivacy` → `Disable` + 重加群
	`requireMention` 设置	临时设为 `false` 测试
命令 `channels login` 不存在	OpenClaw 版本过低	升级到最新版本
网关启动失败	JSON 配置错误	运行 `openclaw config validate` 检查语法

关键命令

openclaw version
openclaw channels login --channel telegram
openclaw config set channels.telegram.botToken "xxx"
openclaw config set channels.telegram.enabled true
openclaw gateway restart
openclaw pairing list telegram
openclaw pairing approve telegram <配对码>
openclaw gateway status
openclaw gateway logs
openclaw config validate

搜索此博客

DDD网络科技

OpenClaw 如何绑定 Telegram？完整教程