Telegram Bot 部署
通过 Bot API 和 grammY 将 OpenClaw AI Agent 部署为 Telegram 机器人。
概述
OpenClaw 通过 Bot API 使用 grammY 库与 Telegram 集成。支持私聊和群聊。
快速设置
1. 创建 Bot Token
- 打开 Telegram 搜索
@BotFather - 发送
/newbot并按提示操作 - 复制 bot token（格式：
123:abc...）
2. 配置 OpenClaw
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "123:abc...",
"dmPolicy": "pairing",
"groups": {
"*": {
"requireMention": true
}
}
}
}
}或使用环境变量：
export TELEGRAM_BOT_TOKEN="123:abc..."3. 登录并启动
openclaw channels login telegram
openclaw gateway4. 批准首次私聊
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>私聊访问控制
| 策略 | 说明 |
|---|---|
pairing（默认） | 新发送者需通过配对码批准 |
allowlist | 仅允许特定发送者 ID |
open | 允许所有发送者（设置 allowFrom: ["*"]） |
disabled | 拒绝所有私聊 |
{
"channels": {
"telegram": {
"dmPolicy": "allowlist",
"allowFrom": ["tg:123456789"]
}
}
}群聊设置
- 将机器人添加到 Telegram 群组
- 禁用隐私模式：向
@BotFather发送/setprivacy - 或将机器人设为群管理员
BotFather 设置
/setjoingroups— 允许/禁止加入群组/setprivacy— 控制群消息可见性
功能支持
- ✅ 带配对的私聊
- ✅ 带@提及激活的群聊
- ✅ 图片和媒体支持
- ✅ 语音消息
- ✅ 贴纸处理
- ✅ 视频消息
故障排除
机器人无响应
- 验证
botToken是否正确 - 检查
openclaw gateway status - 运行
openclaw doctor --fix
群聊中收不到消息
- 通过
/setprivacy禁用隐私模式 - 或将机器人设为群管理员
下一步
- WhatsApp 部署 — WhatsApp 设置
- AI Agent — 配置 Agent 行为
- Clawdbot — 机器人配置