首页 教程 分类 Skills下载 关于
ZH EN JA KO
✈️

Telegram

通讯 通讯与社交集成

安装命令

npx clawhub@latest install telegram

安装说明

1
确认环境

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

2
执行安装

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

3
验证安装

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

4
配置参数(可选)

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

手动安装方式:将 Skill 文件夹复制到 ~/.openclaw/skills/ 或项目目录下的 skills/ 文件夹,确保文件夹中包含 SKILL.md 文件。
Bot运行 群聊支持 文件传输

详细介绍

Telegram 技能是 OpenClaw 最常用的频道对接之一,让你通过 Telegram 随时随地与 AI 助手对话。

核心功能

  • 私聊对话:与 Bot 一对一对话,享受完整的 AI 助手体验
  • 群聊集成:将 Bot 加入群组,通过 @mention 或关键词触发回复
  • 内联模式:在任意聊天中通过 @botname 调用 Bot,无需切换对话
  • 文件收发:接收用户发送的文件(图片、文档、音频),并可发送文件作为回复
  • 键盘按钮:使用 Inline Keyboard 和 Reply Keyboard 创建交互式菜单

配置说明

通过 @BotFather 创建 Bot 并获取 Token。

{
  skills: {
    telegram: {
      botToken: "123456:ABC-xxx",
      allowedUsers: [],       // 空=所有用户, 填 Telegram user ID 限制访问
      groupMode: "mention",   // mention=@时回复, always=总是回复
      maxMessageLength: 4096
    }
  }
}

使用场景

  • 个人 AI 助手:随时通过 Telegram 提问或让 AI 帮忙处理任务
  • 群组助手:在技术讨论群中提供实时解答
  • 文件处理:发送 PDF 让 Bot 总结内容,发送图片让 Bot 分析
  • 定时推送:结合其他技能(如 RSS)定时向你推送信息