OpenClaw 如何绑定 Telegram？完整教程

让你的 AI 助手通过 Telegram 与你随时对话。本教程详细讲解如何创建 Telegram Bot、配置 OpenClaw、完成配对连接。

前置条件

✅ 已安装 OpenClaw 并运行网关
✅ 拥有一个 Telegram 账号
✅ 能访问网络（Telegram 需要连接）

🔑 步骤 1：创建 Bot 并获取 Token

1.1 打开 BotFather

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

1.2 创建新 Bot

发送命令：

/newbot

BotFather 会提示你输入：

Bot 名称（例如：My OpenClaw Assistant）

Bot 用户名（必须以 bot 结尾，例如：MyClawBot）

1.3 获取 Token

创建成功后，BotFather 会返回一个 HTTP API Token，格式类似：

1234567890:ABCdefGhIJKlmNoPQRstUvWxyz-1234567890

保存好这个 Token，后面需要用到。

---

⚙️ 步骤 2：配置 OpenClaw

2.1 打开配置文件

编辑 OpenClaw 配置文件（默认位置）：

C:Users你的用户名.openclawopenclaw.json

2.2 添加 Telegram 配置

在 channels 部分添加或修改：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的_TELEGRAM_BOT_TOKEN",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}

参数说明：

botToken: 上一步获取的 Token

dmPolicy: 私聊策略（推荐 pairing，需要配对）

groupPolicy: 群组策略（默认 allowlist）

2.3 重启网关

openclaw gateway restart

或通过服务管理器重启。

---

🔗 步骤 3：配对连接

3.1 打开 Telegram

找到你创建的 Bot（就是刚才 BotFather 创建的那个），发送任意消息（比如 "hello"）。

3.2 在 OpenClaw 中批准配对

打开命令行，运行：

openclaw pairing list

会显示待配对的会话，找到你的 Telegram 用户，复制 Session Key。

批准配对：

openclaw pairing approve --session 会话密钥

3.3 测试消息

在 Telegram 中发送消息，应该能收到回复。

---

⚠️ 常见问题

Q1: Bot 无响应？

检查 botToken 是否正确

确认网关已重启

查看日志：openclaw logs

Q2: 收不到消息？

确认 dmPolicy 设置（pairing 需要先配对）

检查是否在配对列表中批准

Q3: 群组消息无法接收？

将群组 ID 加入 groupAllowFrom 列表

或修改 groupPolicy 为 open

Q4: 绑定后如何改 Token？

直接修改配置文件，重启网关即可。

---

🎯 高级配置

仅允许特定群组

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Token",
      "groupPolicy": "allowlist",
      "groupAllowFrom": [
        "-1001234567890"
      ]
    }
  }
}

群组 ID 获取：在群组中发送 @getidsbot 或查看配对列表。

---

📝 快速命令汇总

操作命令
------------
查看配对列表openclaw pairing list
批准配对openclaw pairing approve --session <key>
拒绝配对openclaw pairing reject --session <key>
重启网关openclaw gateway restart
查看日志openclaw logs

---