Channels

Clawdbot Telegram 集成指南

将 Clawdbot AI 助手连接到 Telegram,实现智能机器人自动化、智能消息和 AI 驱动的 Telegram 对话。

Clawdbot Telegram 集成概述

Clawdbot Telegram 集成让您可以将个人 AI 助手连接到 Telegram,这是最安全且功能丰富的即时通讯平台之一。通过 Clawdbot Telegram,您可以创建智能机器人、自动化对话,并在 Telegram 中直接利用 AI 驱动的消息功能。

为什么选择 Clawdbot Telegram?

Telegram 提供强大的机器人 API 和隐私功能。将 Clawdbot 与 Telegram 集成可获得:

功能Clawdbot Telegram 优势
Bot API 集成Clawdbot Telegram 使用原生 Telegram Bot API
内联模式Clawdbot Telegram 支持内联查询
频道管理使用 Clawdbot 自动化 Telegram 频道发布
群组管理Clawdbot Telegram 可以管理群聊
隐私优先Clawdbot 本地运行,您的 Telegram 数据保持私密

设置 Clawdbot Telegram

前置条件

在将 Clawdbot 连接到 Telegram 之前,请确保您已具备:

  • 设备上已安装 Clawdbot
  • 一个 Telegram 账户
  • 从 @BotFather 获取的 Telegram Bot Token

步骤 1:创建 Telegram 机器人

首先,通过 Telegram 的 BotFather 创建机器人:

  1. 打开 Telegram 并搜索 @BotFather
  2. 发送 /newbot 命令
  3. 按照提示为您的 Clawdbot Telegram 机器人命名
  4. 保存提供的 API token

步骤 2:配置 Clawdbot Telegram

将您的 Telegram 机器人添加到 Clawdbot:

clawdbot channels add telegram --token YOUR_BOT_TOKEN

步骤 3:启动 Clawdbot Telegram

启动 Clawdbot Telegram 集成:

clawdbot channels start telegram

步骤 4:验证 Clawdbot Telegram 连接

检查您的 Clawdbot Telegram 状态:

clawdbot channels status telegram

预期输出:

Telegram 频道状态:
- 连接: 已连接
- 机器人: @YourClawdbot
- 模式: 轮询
- Clawdbot: 活跃

Clawdbot Telegram 功能特性

私聊支持

Clawdbot Telegram 响应私信。用户可以与您的 Clawdbot Telegram 机器人私聊,获得个性化的 AI 帮助。

群聊集成

将您的 Clawdbot Telegram 机器人添加到群组:

clawdbot configure telegram --groups "enabled"

配置 Clawdbot Telegram 响应:

  • 所有消息
  • 仅提及(@YourClawdbot)
  • 仅命令(/ask, /help)

内联模式

Clawdbot Telegram 支持内联查询。用户可以从任何聊天中调用 Clawdbot:

@YourClawdbot 今天天气怎么样?

频道自动化

使用 Clawdbot Telegram 自动化频道发布:

clawdbot telegram post --channel @YourChannel --message "每日更新"

命令处理器

Clawdbot Telegram 支持自定义命令:

命令Clawdbot Telegram 动作
/startClawdbot 欢迎消息
/helpClawdbot Telegram 帮助菜单
/ask直接向 Clawdbot 提问
/settings配置 Clawdbot Telegram 偏好

Clawdbot Telegram 配置

机器人设置

配置您的 Clawdbot Telegram 机器人行为:

{
  "telegram": {
    "token": "YOUR_BOT_TOKEN",
    "mode": "polling",
    "allowGroups": true,
    "inlineMode": true,
    "commands": ["start", "help", "ask"]
  }
}

Webhook 模式

对于生产环境的 Clawdbot Telegram 部署,使用 webhook 模式:

clawdbot configure telegram --webhook https://your-domain.com/telegram

速率限制

配置 Clawdbot Telegram 速率限制:

设置描述
rateLimitClawdbot Telegram 每分钟消息数
cooldownClawdbot Telegram 响应之间的延迟
maxTokensClawdbot Telegram 最大响应长度

Clawdbot Telegram 凭证存储

Clawdbot 安全存储 Telegram 凭证:

~/.clawdbot/credentials/telegram/bot_token
~/.clawdbot/credentials/telegram/session.json

您的 Clawdbot Telegram 数据保留在本地机器上。

Clawdbot Telegram 与 grammY

Clawdbot Telegram 使用 grammY 框架增强机器人功能:

  • 中间件支持
  • 插件生态系统
  • TypeScript 集成
  • 会话管理

Clawdbot Telegram 故障排除

机器人无响应

如果您的 Clawdbot Telegram 机器人不响应:

  1. 验证 token:clawdbot channels verify telegram
  2. 通过 @BotFather 检查机器人状态
  3. 查看日志:cat /tmp/clawdbot/telegram.log

Webhook 问题

如果 Clawdbot Telegram webhook 失败:

  1. 验证 SSL 证书
  2. 检查 webhook URL 可访问性
  3. 重置 webhook:clawdbot telegram webhook --reset

速率限制

如果 Clawdbot Telegram 被速率限制:

  1. 降低消息频率
  2. 实现消息队列
  3. 检查 Telegram API 限制

Clawdbot Telegram 最佳实践

  1. 生产环境使用 Webhook:Clawdbot Telegram 使用 webhook 性能更好
  2. 设置隐私模式:在 @BotFather 中配置 Clawdbot Telegram 隐私
  3. 优雅处理错误:为 Clawdbot Telegram 实现错误处理
  4. 监控使用情况:跟踪 Clawdbot Telegram 机器人分析数据

下一步