首页 资讯 下载 教程 Skills 社群

Telegram Bot

通讯 通讯与社交集成

安装命令

npx clawhub@latest install telegram-bot

安装说明

1
确认环境

确保已安装 Node.js 22+ 和 OpenClaw。在终端运行 openclaw --version 确认 OpenClaw 正常工作。

2
执行安装

在终端中运行上方安装命令，ClawHub 会自动下载并安装 Telegram Bot 到 ~/.openclaw/skills/ 目录。

3
验证安装

运行 openclaw skills list 查看已安装技能列表，确认 Telegram Bot 已出现在列表中。

4
配置参数（可选）

根据下方介绍中的配置说明，在 ~/.config/openclaw/openclaw.json5 中添加技能的配置项。

手动安装方式：将 Skill 文件夹复制到 ~/.openclaw/skills/ 或项目目录下的 skills/ 文件夹，确保文件夹中包含 SKILL.md 文件。
Bot DM 群组支持 多媒体处理

详细介绍

Telegram 集成是 OpenClaw 生产就绪的通讯通道，通过 grammY 框架实现 Bot API 集成。默认使用长轮询模式，也可配置 Webhook 模式。

快速开始

  1. 通过 @BotFather 创建 Bot 并获取 Token（发送 /newbot）
  2. 在 openclaw.json5 中配置 Token 和策略
  3. 运行 openclaw gateway 启动网关
  4. 将 Bot 添加到群组并配置群组策略

核心功能

  • DM 与群组：支持私聊和群组模式，群组中通过 @mention 或命令触发
  • 多媒体处理：支持图片、文件、语音、视频等消息类型，支持贴纸处理
  • 流式响应：支持 off、partial、block、progress 四种流式传输模式
  • 会话管理：自动维护每个用户的对话上下文
  • 命令系统：支持原生 Telegram 命令菜单和自定义命令
  • 内联按钮：支持 DM/群组/全部模式的内联按钮交互
  • 论坛主题：支持 Telegram 论坛（Topics）的独立会话路由
  • 执行审批：支持跨用户的命令执行审批流程

配置参数

在 openclaw.json5 中配置：

{
  channels: {
    telegram: {
      botToken: "123456:ABC-DEF",  // Bot Token，从 @BotFather 获取
      dmPolicy: "pairing",          // DM 策略
      groupPolicy: "allowlist",     // 群组策略
      allowFrom: [],                // 允许的用户 ID 列表
      streaming: "partial",         // 流式传输模式
      replyToMode: "off",           // 回复模式：off | first | all
      textChunkLimit: 4000,         // 每条消息字符上限
      mediaMaxMb: 100,              // 媒体文件大小上限（MB）
      historyLimit: 50,             // 群组上下文消息数量
      webhookUrl: "",               // Webhook 地址，留空用长轮询
      webhookPort: 8787,            // Webhook 端口
      proxy: ""                     // SOCKS/HTTP 代理地址
    }
  }
}

访问控制

  • dmPolicy：DM 策略，可选 pairing（配对，默认）、allowlist（白名单）、open（开放，需设 allowFrom: ["*"]）、disabled
  • groupPolicy：群组策略，可选 open、allowlist（默认）、disabled
  • allowFrom：允许的用户 ID 列表，使用数字 Telegram 用户 ID

消息与媒体

  • streaming：流式传输模式，默认 partial
  • textChunkLimit：消息分块字符上限，默认 4000
  • mediaMaxMb：媒体文件大小上限，默认 100 MB

网络配置

  • webhookUrl：Webhook 回调地址，留空则使用长轮询模式
  • proxy：代理地址，格式如 socks5://host:port

注意事项

  • 群组发送者授权不继承 DM 配对审批
  • 需要在 BotFather 中关闭隐私模式（/setprivacy）才能接收群组中未 @mention 的消息
  • Telegram 不支持已读回执
← 返回 Skills 列表