搭建 Telegram Bot Agent：从零到自动回复

前置条件

• 已安装 OpenClaw Gateway
• 有 Telegram 账号
• 服务器有公网 IP 或域名

步骤 1：创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 按提示输入 Bot 名称和用户名
4. 记录返回的 Bot Token（格式：123456:ABC-DEF...）

步骤 2：安装 Telegram Bot Skill

clawhub install telegram-bot
export TELEGRAM_BOT_TOKEN=你的Token
openclaw gateway restart

步骤 3：设置 Webhook

OpenClaw 自动处理 Webhook 注册。确保 Gateway 有公网可达的地址：

{
  "gateway": {
    "url": "https://your-domain.com"
  }
}

验证 Webhook 状态：

检查 Telegram Bot Webhook 是否设置成功

步骤 4：测试交互

在 Telegram 中找到你的 Bot，发送：

你好

Agent 应该会自动回复。

步骤 5：配置命令菜单

在 BotFather 中设置命令列表：

/status - 查看系统状态
/report - 生成日报
/help - 帮助信息

步骤 6：高级功能

• 内联键盘：给消息添加交互按钮
• 群组管理：让 Bot 在群组中响应 @提及
• 定时推送：配合 Cron Skill 定时发消息

常见问题

Webhook 验证失败

• 确认 SSL 证书有效
• 检查防火墙是否放行 443 端口

Bot 不回复

• 检查 Gateway 日志：openclaw gateway logs
• 确认 Token 正确
• 群组中 Bot 需要关闭 Privacy Mode