O
OpenClaw

Telegram 接入

Telegram 是 OpenClaw 支持最完善的频道之一,支持私聊、群组、命令等多种功能。

创建 Bot

1. 与 BotFather 对话

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 命令
  3. 输入 Bot 名称(如:My AI Assistant)
  4. 输入 Bot 用户名(必须以 bot 结尾,如:my_ai_clawbot)
  5. 保存获得的 API Token

2. 获取你的 Telegram ID

搜索 @userinfobot,它会告诉你自己的 ID。

配置 OpenClaw

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

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrSTUvwxyz",
      "allowFrom": ["123456789"],
      "webhook": {
        "enabled": false
      }
    }
  }
}

配置说明

选项说明
botToken从 BotFather 获得的 API Token
allowFrom允许访问的 Telegram ID 列表
webhook.enabled是否使用 Webhook 模式(默认 Polling)

高级功能

群组支持

将 Bot 添加到群组:

  1. 先私聊 Bot 发送 /start
  2. 将 Bot 添加到群组
  3. 在群组中发送 /start@your_bot_name

配置群组权限:

"telegram": {
  "groups": {
    "*": {
      "requireMention": true,
      "mentionPatterns": ["@my_bot", "AI"]
    }
  }
}

Webhook 模式(生产环境推荐)

如果你将 OpenClaw 部署在服务器上,建议使用 Webhook 模式:

"telegram": {
  "webhook": {
    "enabled": true,
    "url": "https://your-domain.com/webhook/telegram",
    "secret": "your_webhook_secret"
  }
}

测试

重启 Gateway 后,私聊你的 Bot 发送消息测试:

openclaw gateway restart