Telegram 频道配置

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

第一步：创建 Telegram Bot

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

第二步：登录频道

bash

openclaw channels login telegram

系统会提示输入 Bot Token：

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

第三步：验证

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

配置选项

编辑频道配置（可选）：

bash

openclaw channels config telegram

常用配置项：

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

支持的消息类型

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

常见问题

Bot 没有回复？

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

隐私模式

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