🤖 OpenClaw Telegram机器人完整指南

🎯 为什么选Telegram？

世界上有一种聊天叫Telegram，它比微信自由，比Slack接地气，比Discord更适合亚洲人的使用习惯。OpenClaw官方数据显示，Telegram是OpenClaw生态中最受欢迎的接入渠道——没有之一。

🛠️ 开始设置

/newbot
# 输入你想要的机器人名称，比如 "我的AI助手"
# 再输入用户名，必须以bot结尾，比如 myaihelper_bot

✅ 成功！你会收到这样的消息：
Use this token to access the HTTP API:
123456789:ABCdefGHIjklMNOpqrSTUvwxyz

# ~/.openclaw/config.yaml
channels:
  telegram:
    enabled: true
    bot_token: "123456789:ABCdefGHIjklMNOpqrSTUvwxyz"
    
    # 可选：只允许特定用户访问
    allowed_users:
      - "your_telegram_username"
    
    # 可选：启用群组模式
    group_mode: true
    
    # 长轮询超时（秒）
    polling_timeout: 30

# 重启OpenClaw Gateway
openclaw gateway restart

# 查看日志确认连接成功
openclaw logs -f | grep telegram

⚡ 高级配置技巧

Webhook模式（生产环境推荐）

如果你的OpenClaw部署在服务器上，Webhook比长轮询更高效：

channels:
  telegram:
    enabled: true
    bot_token: "YOUR_TOKEN"
    webhook_url: "https://your-domain.com/webhook/telegram"
    webhook_secret: "your-secret-key"

群组模式设置

让机器人进入群组并响应@提及：

1. 将机器人添加到群组
2. 给机器人管理员权限（至少要有读取消息、发送消息）
3. 在配置中启用 group_mode: true
4. 在群里发 @你的机器人 你好 测试

文件处理功能

OpenClaw Telegram机器人默认支持文件上传下载。用户发送的图片、文档会自动传递给Agent处理：

# 在SOUL.md中添加文件处理指令
你可以接收用户上传的文件，并：
1. 图片 → 用Canvas工具分析或修改
2. 文档 → 用feishu_doc或read工具解析
3. 音频 → 用whisper或tts工具转文字

💎 最佳实践

📝 代码示例：自定义命令

在SOUL.md中定义Telegram专属行为：

当用户通过Telegram发送消息时：

1. 如果消息以 "/start" 开头：
   - 回复："你好！我是你的AI助手，发送任何消息我都会回复。"

2. 如果消息包含图片：
   - 使用canvas工具分析图片内容
   - 给用户文字描述

3. 如果消息是语音：
   - 用STT转文字
   - 回复处理结果

🔗 相关资源