ClawdBotAI LogoClawdBotAI
Home平台集成Telegram

Telegram 集成

将 ClawdBot 连接到 Telegram，创建你的私人 AI 机器人

概述

Telegram 是最适合 ClawdBot 的平台之一。它提供了强大的 Bot API， 支持丰富的消息格式，而且配置过程非常简单。

ClawdBot 使用 grammY 框架与 Telegram Bot API 交互， 支持私聊、群组消息、文件传输、语音消息等所有主要功能。

创建 Telegram Bot

首先，你需要在 Telegram 中创建一个 Bot：

步骤 1: 找到 BotFather

  1. 打开 Telegram
  2. 搜索 @BotFather
  3. 点击 Start 开始对话

步骤 2: 创建新 Bot

  1. 发送 /newbot 命令
  2. 输入你的 Bot 名称（例如：My ClawdBot）
  3. 输入 Bot 用户名（必须以 bot 结尾，例如：my_clawdbot_bot）

步骤 3: 获取 Token

创建成功后，BotFather 会给你一个 API Token，格式类似：

123456789:ABCdefGHIjklMNOpqrsTUVwxyz

请妥善保存这个 Token，不要泄露给他人！

配置 ClawdBot 连接

获取 Token 后，配置 ClawdBot：

方法 1: 使用命令行配置

clawdbot telegram setup

按照提示输入你的 Bot Token。

方法 2: 使用配置文件

编辑 ClawdBot 配置文件：

# ~/.clawdbot/config.yaml

channels:
  telegram:
    enabled: true
    token: "YOUR_BOT_TOKEN_HERE"
    # 可选：只允许特定用户使用
    allowed_users:
      - 123456789  # 你的 Telegram User ID

方法 3: 使用环境变量

export CLAWDBOT_TELEGRAM_TOKEN="YOUR_BOT_TOKEN_HERE"
clawdbot gateway

启动并验证

# 重启 Gateway
clawdbot gateway restart

# 检查连接状态
clawdbot channels list

配置成功后，在 Telegram 中找到你的 Bot，发送 /start 开始对话！

功能特性

Telegram 集成支持以下功能：

消息类型

  • 文本消息 - 普通对话和命令
  • 图片 - 发送和接收图片，支持 AI 图像分析
  • 文件 - 支持各种文件格式
  • 语音消息 - 语音转文字处理
  • 位置 - 地理位置信息

特色功能

  • 内联模式 - 在任何对话中 @你的Bot 使用
  • 按钮菜单 - 交互式按钮操作
  • 群组支持 - 在群组中使用（需 @mention）
  • 消息编辑 - ClawdBot 可以编辑已发送的消息

常用命令

在 Telegram 中可以使用以下斜杠命令：

命令说明
/start开始对话
/help显示帮助信息
/status查看 ClawdBot 状态
/skills列出可用技能
/activation设置激活模式
/clear清除对话上下文

故障排查

Bot 不响应消息

  • 检查 Gateway 是否正在运行：clawdbot doctor
  • 确认 Token 配置正确
  • 查看日志：clawdbot logs

Token 无效错误

  • 确保 Token 完整复制，没有多余空格
  • 如果 Token 泄露，在 BotFather 中重新生成

群组中无法使用

  • 确保 Bot 有群组消息权限（在 BotFather 中设置 /setprivacy）
  • 在群组中需要 @mention Bot 才会响应

获取更多帮助

# 运行诊断
clawdbot doctor --verbose

# 查看详细日志
clawdbot logs --level debug
平台集成Discord 配置