Telegram 渠道配置

创建 Telegram Bot

1. 获取 Bot Token

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 创建新机器人
3. 按提示设置机器人名称
4. 记录 Bot Token（格式：1234567890:ABCdef...）

配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的_BOT_TOKEN",
      "groupPolicy": "allowlist",
      "streaming": "partial",
      "mediaMaxMb": 20
    }
  }
}

参数说明

参数	说明	可选值
enabled	是否启用	true / false
dmPolicy	私聊策略	open / pairing / allowlist / disabled
botToken	Bot Token	从 BotFather 获取
groupPolicy	群聊策略	open / allowlist / disabled
streaming	流式输出	off / partial / block
mediaMaxMb	最大媒体文件	数字（MB）

DM 策略说明

策略	说明
open	所有人可直接对话
pairing	首次需配对验证（推荐）
allowlist	仅白名单用户
disabled	禁用私聊

重启服务

openclaw gateway restart

测试验证

1. 在 Telegram 中搜索你的 Bot
2. 发送消息测试
3. 查看 OpenClaw 日志：openclaw logs --follow

配对流程（dmPolicy: pairing）

当用户首次发送消息时：

1. 用户发送消息给 Bot
2. Bot 返回配对码
3. 管理员执行：

# 查看待配对列表
openclaw pairing list telegram

# 批准配对
openclaw pairing approve telegram <CODE>

群聊配置

添加到群组

1. 在群组设置中添加 Bot
2. 配置群组权限：

{
  "channels": {
    "telegram": {
      "groups": {
        "-1001234567890": {
          "groupPolicy": "open",
          "requireMention": false
        }
      }
    }
  }
}

获取群组 ID

# 方法 1: 转发群消息给 @userinfobot
# 方法 2: 查看日志
openclaw logs --follow

隐私模式

默认情况下，Bot 只能看到：

• @ 提及 Bot 的消息
• 回复 Bot 的消息
• Bot 发送的消息

如需 Bot 看到所有消息：

1. 向 @BotFather 发送 /setprivacy
2. 选择你的 Bot
3. 选择 Disable

常见问题

Bot 不响应

1. 检查 Token 是否正确
2. 检查服务状态：openclaw gateway status
3. 查看日志：openclaw logs --follow

配对码过期

配对码有效期为 1 小时，需重新获取。

---

相关文档：

• OpenClaw 安装指南
• 飞书渠道配置