📱 Telegram 配置指南

← 返回首页

在 Telegram 中使用 OpenClaw AI Agent 的完整配置方法。

📋 前置要求

1. Telegram 账号
2. 一个 Telegram Bot（通过 BotFather 创建）

🔧 配置步骤

第一步：创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 按照提示设置：
   • Bot 名称（显示名称）
   • Bot 用户名（必须以 bot 结尾，如 myopenclaw_bot）
4. 保存返回的 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

第二步：获取 Chat ID（用于群组）

方法一：通过 Bot 获取

1. 将 Bot 添加到群组
2. 在群组中发送一条消息
3. 访问：https://api.telegram.org/bot<YourBOTToken>/getUpdates
4. 查找 "chat":{"id":-123456789 中的数字

方法二：使用 @userinfobot

1. 在 Telegram 搜索 @userinfobot
2. 转发一条群组消息给 Bot
3. 获取 Chat ID

第三步：OpenClaw 配置

编辑 openclaw.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "allowedGroups": ["-1001234567890"],
      "streamMode": "partial"
    }
  }
}

配置说明：

• dmPolicy: 私聊策略
  • "pairing" - 需要配对后才响应
  • "all" - 响应所有私聊
  • "none" - 不响应私聊
• groupPolicy: 群组策略
  • "allowlist" - 只响应白名单群组
  • "all" - 响应所有群组
  • "none" - 不响应群组

第四步：启动 OpenClaw

openclaw gateway restart

💡 使用方法

私聊使用

直接给 Bot 发送消息即可：

帮我写个 Python 脚本

群组使用

在群组中 @Bot 或回复 Bot 的消息：

@myopenclaw_bot 分析这个数据

🔒 权限控制

白名单模式（推荐）

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "xxx",
      "groupPolicy": "allowlist",
      "allowedGroups": [
        "-1001234567890",
        "-1009876543210"
      ]
    }
  }
}

允许所有群组

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "xxx",
      "groupPolicy": "all"
    }
  }
}

🎨 Telegram 特有功能

功能	说明
Markdown 支持	支持加粗、斜体、代码块等格式
Inline Buttons	支持内联按钮交互
Reply Keyboard	支持自定义键盘
文件传输	支持发送/接收文件（最大 20MB）

Markdown 格式示例

*斜体*
**粗体**
`代码`
```代码块```
[链接](https://example.com)

⚠️ 注意事项

1. Bot 隐私模式 - 在 BotFather 中设置 /setprivacy
2. Token 安全 - Bot Token 相当于密码，泄露后需要重置
3. 文件大小限制 - 普通文件：20MB，照片：10MB

🔗 相关链接

• BotFather
• Telegram Bot API
• OpenClaw 文档

最后更新: 2026-03-03