OpenClaw Telegram 集成：打造你的专属 Telegram AI 助手

Telegram 是全球最受欢迎的即时通讯应用之一，拥有超过 5 亿活跃用户。通过 OpenClaw 的 Telegram 集成功能，你可以轻松创建一个功能强大的 AI 助手，为个人或团队提供服务。本文将详细介绍如何配置和使用 OpenClaw 的 Telegram 功能。

为什么选择 Telegram？

在众多通讯平台中，Telegram 具有以下优势：

  • 开放 API：强大的 Bot API，支持各种自定义功能
  • 跨平台：支持 iOS、Android、Windows、macOS、Linux
  • 群组功能：支持大型群组（最多 20 万成员）
  • 隐私保护：提供端到端加密的私密聊天
  • 机器人生态：丰富的 Bot 功能和第三方集成

Telegram Bot 准备工作

创建 Bot

  1. 打开 Telegram，搜索 @BotFather
  2. 发送命令 /newbot 创建新机器人
  3. 按照提示设置机器人名称（Name）和用户名（Username）
  4. 机器人用户名必须以 bot 结尾（如 MyAssistant_bot）
  5. 创建完成后，BotFather 会给你一个 API Token，格式类似：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

重要提示：妥善保管你的 API Token，不要泄露给他人。

获取你的 Telegram ID

要获取你的 Telegram 用户 ID：

  1. 搜索 @userinfobot 或 @getidsbot
  2. 发送任何消息给机器人
  3. 它会返回你的用户 ID（数字格式）

或者在你的群组中使用 @RawDataBot 获取信息。

OpenClaw Telegram 配置

环境变量配置

在 .env 文件中添加：

# Telegram Bot Token（必填）
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

# 允许使用机器人的用户 ID（可选但推荐）
TELEGRAM_ALLOWED_USERS=123456789,987654321

# 管理员 ID（可以执行管理命令）
TELEGRAM_ADMIN_USERS=123456789

配置文件

在 config/app.yaml 中配置 Telegram 插件：

plugins:
  - telegram

telegram:
  enabled: true
  botToken: "${TELEGRAM_BOT_TOKEN}"

  # 消息设置
  settings:
    # 是否在群组中响应所有消息（false 只响应 @机器人）
    respondToGroup: false
    # 是否允许私聊
    allowPrivateChat: true
    # 命令前缀
    commandPrefix: "/"
    # 最大消息长度
    maxMessageLength: 4096

  # 用户权限
  permissions:
    # 允许的用户 ID（留空则允许所有人）
    allowedUsers: []
    # 需要管理员权限的命令
    adminCommands:
      - "reload"
      - "restart"
      - "status"

  # 功能开关
  features:
    # 是否启用技能
    skills: true
    # 是否启用定时任务
    cron: true
    # 是否启用记忆功能
    memory: true
    # 是否启用语音识别
    voice: false

高级配置

群组特定配置

telegram:
  groups:
    # 特定群组的配置
    - groupId: -1001234567890
      name: "开发团队"
      features:
        skills: true
        cron: false
      allowedSkills:
        - "code-helper"
        - "search"

    - groupId: -1009876543210
      name: "运营团队"
      features:
        skills: true
        cron: true
      allowedSkills:
        - "analytics"
        - "report"

键盘按钮配置

telegram:
  keyboards:
    main:
      - ["天气", "新闻"]
      - ["帮助", "设置"]
    admin:
      - ["状态", "重启"]
      - ["日志", "退出"]

使用场景示例

场景 1：个人 AI 助手

配置示例：

telegram:
  enabled: true
  botToken: "${TELEGRAM_BOT_TOKEN}"
  settings:
    allowPrivateChat: true
  permissions:
    allowedUsers:
      - 123456789  # 你的 Telegram ID

功能： - 随时随地与 AI 对话 - 查询信息、获取建议 - 设置提醒和管理日程

场景 2：团队协作助手

配置示例：

telegram:
  enabled: true
  botToken: "${TELEGRAM_BOT_TOKEN}"
  settings:
    respondToGroup: true
  groups:
    - groupId: -1001234567890
      name: "项目组"
      features:
        skills: true
      allowedSkills:
        - "task-manager"
        - "meeting-scheduler"
        - "code-review"

功能： - 群组内回答技术问题 - 管理任务和日程 - 自动化工作流

场景 3：客服机器人

telegram:
  enabled: true
  botToken: "${TELEGRAM_BOT_TOKEN}"
  features:
    skills: true
    memory: true

skills:
  - path: "./skills/customer-service"
    enabled: true

常用命令

基础命令

命令 描述
/start 开始使用机器人
/help 获取帮助信息
/status 查看机器人状态
/skills 列出可用技能

管理命令（仅管理员）

命令 描述
/reload 重新加载配置
/restart 重启机器人
/logs 查看最近日志

自定义技能命令

根据你配置的技能，可能还包括：

命令 描述
/天气 [城市] 查询天气
/翻译 [文本] 翻译文本
/搜索 [关键词] 搜索网络

进阶功能

1. 设置命令菜单

在 BotFather 中设置命令列表：

  1. 发送 /setcommands 给 BotFather
  2. 选择你的机器人
  3. 粘贴命令列表：
start - 开始使用
help - 获取帮助
status - 查看状态
weather - 查询天气
search - 搜索信息

2. 添加机器人到群组

  1. 打开群组设置
  2. 添加成员
  3. 搜索你的机器人用户名
  4. 设置权限（建议至少允许读取消息）

3. 配置群组权限

建议在群组中设置以下权限：

  • ✅ 发送消息
  • ✅ 发送媒体
  • ✅ 发送投票
  • ✅ 嵌入链接
  • ❌ 添加管理员

4. 定时任务通知

配置定时任务向 Telegram 发送通知：

cron:
  tasks:
    - name: "每日报告"
      schedule: "0 9 * * *"
      skill: "daily-report"
      notify:
        telegram:
          chatId: 123456789
          message: "📊 今日工作报告"

常见问题

问题 1：机器人不响应消息

检查： 1. 机器人是否已启动（npm start 或 Docker 容器运行中） 2. 配置中 enabled 是否为 true 3. 用户是否在允许列表中 4. 查看日志中的错误信息

问题 2：无法添加到群组

可能原因： 1. 群组人数达到上限 2. 机器人没有相关权限 3. 群组已禁用机器人添加

问题 3：消息发送失败

常见原因： - 用户已屏蔽机器人 - 机器人被限制发送消息 - 网络连接问题

问题 4：API 请求超时

优化建议： - 增加超时配置 - 优化技能执行效率 - 检查网络稳定性

安全最佳实践

  1. 限制用户访问：配置 allowedUsers 列表
  2. 敏感信息处理：不要在群组中讨论敏感内容
  3. 定期更新 Token：定期更换 Bot Token
  4. 监控使用情况：定期检查日志，发现异常行为

总结

通过本文，你应该已经掌握了 OpenClaw 的 Telegram 集成配置方法。Telegram 机器人可以成为你强大的 AI 助手，无论是个人使用还是团队协作都能大幅提升效率。

记住以下关键点： - 妥善保管 API Token - 合理配置用户权限 - 根据需求选择合适的部署方式 - 定期检查和维护

祝你的 Telegram AI 助手运行顺利！

相关阅读： - OpenClaw Discord 集成 - OpenClaw 技能开发 - OpenClaw 配置详解