Telegram 频道配置

Telegram 是最推荐的入门频道，配置简单，功能完整。

第一步：创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather 并打开对话
2. 发送 /newbot 命令
3. 按提示输入 Bot 名称和用户名（用户名必须以 bot 结尾）
4. BotFather 会返回你的 Bot Token，格式为 1234567890:ABCDefgh...，请妥善保存

第二步：登录频道

openclaw channels login telegram

系统会提示输入 Bot Token：

请输入 Telegram Bot Token: 1234567890:ABCDefgh...
✓ Telegram 频道已连接

第三步：验证

向你的 Bot 发送任意消息，AI 应在几秒内回复。

配置选项

编辑频道配置（可选）：

openclaw channels config telegram

常用配置项：

配置项	说明	默认值
allowedUsers	允许对话的用户 ID 白名单	所有人
systemPrompt	该频道专用的系统提示词	全局默认
model	该频道使用的 AI 模型	全局默认

支持的消息类型

• ✅ 文本消息
• ✅ 图片（附带描述）
• ✅ 文件 / 文档
• ✅ 语音消息（自动转录）
• ✅ 群组消息（需 @ Bot）

常见问题

Bot 没有回复？

1. 检查 Token 是否正确：openclaw channels list
2. 确认网关正在运行：openclaw health
3. 查看日志排查错误：openclaw logs

隐私模式

默认情况下 Telegram Bot 在群组中只能接收被 @ 的消息。如需接收所有消息，需在 BotFather 中关闭隐私模式（/setprivacy → Disable）。