教程 02 — 接入 Telegram：让 AI 助手住进你的聊天软件
目标：配置 Telegram Bot，让你能在手机上随时和 AI 对话，支持私聊和群组。
原理
OpenClaw 网关启动后会监听多个"频道"。Telegram 频道通过 Bot API 长轮询接收消息，再路由给 AI 代理处理，回复发回 Telegram。
你的手机 → Telegram 服务器 → Bot → OpenClaw 网关 → MiniMax → 回复
第一步：创建 Telegram Bot
-
打开 Telegram，搜索 @BotFather
-
发送
/newbot，按提示填写名字和用户名 -
获得 Token，格式类似：
8543054163:AAHc-yE-nfRlbGw1clvW1OwjdMZ6O_j9tWs
第二步：把 Token 写入配置
编辑 .env（项目根目录或 ~/.openclaw/.env）：
TELEGRAM_BOT_TOKEN=你的token
或者直接写进 ~/.openclaw/openclaw.json 的 env 块：
{
"env": {
"MINIMAX_API_KEY": "${MINIMAX_API_KEY}",
"TELEGRAM_BOT_TOKEN": "你的token"
}
}
第三步：启用 Telegram 频道
在 openclaw.json 中加入 channels 配置：
{
"channels": {
"telegram": {
"enabled": true,
"token": "${TELEGRAM_BOT_TOKEN}"
}
}
}
第四步：重启网关
pnpm openclaw gateway restart
查看日志确认 Telegram 频道已连接：
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram
# 应看到类似：Telegram channel connected
第五步：测试对话
-
打开 Telegram，找到你的 Bot
-
发送
/start开始配对 -
发一条消息：
"今天天气怎么样，帮我分析一下"
Bot 应该在几秒内回复。
群组中使用
-
把 Bot 加入群组并给管理员权限
-
群里用 @提及 Bot 才会响应（默认行为，防止滥用）：
@你的bot名字 帮我总结一下上面的讨论
常用斜杠命令
在 Telegram 里直接发：
| 命令 | 功能 |
|---|---|
/new | 开启新会话（清除上下文） |
/reset | 重置当前会话 |
/status | 查看当前模型和配置 |
/think | 切换深度思考模式 |
/usage | 查看 token 用量 |
常见问题
Bot 没有响应？
- 检查 Token 是否正确：
pnpm openclaw gateway status - 确认频道已启用：日志里搜
telegram - 私聊 Bot 需要先发
/start完成配对
群组里 Bot 乱回复？
- 默认配置要求 @提及，检查
replyToMode配置