OpenClaw 接入 Telegram 教程 - 5 分钟快速配置

本文详细介绍如何将 OpenClaw 接入 Telegram，实现通过 Telegram 机器人与 AI 助手对话。

📋 为什么选择 Telegram？

• ✅ 配置简单 – 只需一个 Bot Token
• ✅ 完全免费 – 无使用限制
• ✅ 功能完整 – 支持文本、媒体、文件、语音
• ✅ 隐私安全 – 端到端加密
• ✅ 跨平台 – 手机、电脑、网页版全覆盖

🚀 快速开始

步骤 1：创建 Telegram 机器人

1. 打开 Telegram，搜索并关注 @BotFather
2. 发送命令 /newbot
3. 按提示输入机器人名称（如 “OpenClaw Assistant”）
4. 设置机器人用户名（必须以 bot 结尾，如 “MyOpenClawBot”）
5. 保存 BotFather 返回的 Token（格式类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

步骤 2：配置 OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "dmPolicy": "pairing",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

或使用环境变量：

export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

步骤 3：启动 Gateway

# 启动网关
openclaw gateway

# 或重启已运行的网关
openclaw gateway restart

步骤 4：配对机器人

1. 在 Telegram 中搜索你的机器人用户名并打开对话
2. 发送任意消息，机器人会回复一个配对码
3. 在 OpenClaw 中批准配对：

# 查看配对请求
openclaw pairing list telegram

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

配对码 1 小时后过期。

⚙️ 高级配置

访问控制

DM 策略

{
  "channels": {
    "telegram": {
      "dmPolicy": "allowlist",  // pairing | allowlist | open | disabled
      "allowFrom": ["123456789", "987654321"]  // Telegram 用户 ID
    }
  }
}

群组策略

{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",  // open | allowlist | disabled
      "groupAllowFrom": ["123456789"],  // 允许的用户 ID
      "groups": {
        "-1001234567890": {  // 群组 ID（负数）
          "requireMention": true,
          "allowFrom": ["123456789", "987654321"]
        }
      }
    }
  }
}

获取用户/群组 ID

方法 1：查看日志（推荐）

openclaw logs --follow

发送消息后，在日志中查找 from.id（用户 ID）或 chat.id（群组 ID）。

方法 2：使用 Bot API

curl "https://api.telegram.org/bot<BOT_TOKEN>/getUpdates"

方法 3：第三方机器人

关注 @userinfobot 或 @getidsbot，发送消息获取 ID。

隐私模式配置

Telegram 机器人默认开启隐私模式，限制接收群组消息：

1. 在 BotFather 中发送 /setprivacy
2. 选择你的机器人
3. 选择 Disable 关闭隐私模式
4. 从群组中移除并重新添加机器人

或者将机器人设置为群组管理员。

🎯 功能特性

支持的媒体类型

• ✅ 文本消息
• ✅ 图片（自动优化）
• ✅ 视频
• ✅ 音频/语音
• ✅ 文档/文件
• ✅ 贴纸
• ✅ 位置信息

流式回复

支持实时显示 AI 回复进度：

{
  "channels": {
    "telegram": {
      "streaming": "partial"  // off | partial | block | progress
    }
  }
}

内联按钮

支持交互式按钮：

{
  "channels": {
    "telegram": {
      "capabilities": {
        "inlineButtons": "all"  // off | dm | group | all | allowlist
      }
    }
  }
}

自定义命令

注册 Telegram 命令菜单：

{
  "channels": {
    "telegram": {
      "customCommands": [
        { "command": "backup", "description": "Git 备份" },
        { "command": "generate", "description": "生成图片" }
      ]
    }
  }
}

🔧 故障排除

机器人无法接收消息

1. 检查 Bot Token 是否正确
2. 确认网关已启动：openclaw gateway status
3. 查看日志：openclaw logs --follow
4. 检查隐私模式设置

配对失败

# 查看配对请求
openclaw pairing list telegram

# 检查是否过期（1 小时）
# 重新发送消息获取新配对码

群组中无响应

1. 确认机器人已添加到群组
2. 检查是否需要 @提及：requireMention: true
3. 验证群组 ID 配置正确
4. 关闭隐私模式或设置管理员

媒体发送失败

{
  "channels": {
    "telegram": {
      "mediaMaxMb": 50  // 调整媒体大小限制
    }
  }
}

📚 相关资源

• Telegram 官方文档
• Telegram Bot API
• 配对机制说明

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月