教程 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 没有响应怎么办？
按顺序排查：① 运行 pnpm openclaw gateway status 确认网关在运行；② 查看日志 tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram 确认频道已连接；③ 私聊 Bot 必须先发 /start 完成配对，未配对的消息会被忽略。
群组里 Bot 乱回复怎么办？
OpenClaw 默认只响应 @提及的消息，防止刷屏。如果 Bot 在群组中响应了不该响应的消息，检查 openclaw.json 中 channels.telegram.replyToMode 的配置，将其设为 "mention" 即可。
Telegram Bot 可以同时服务多个用户吗？
可以。OpenClaw 的 Telegram 频道默认支持多用户并发，每个用户拥有独立的会话上下文。所有人共用同一个 API Key 配额，注意控制用量。
Bot 支持发送图片和文件吗？
收发图片支持需要配置视觉模型（如 MiniMax VL-01），参见教程 07。文件发送功能取决于 OpenClaw 版本，可通过 /status 查看当前支持的能力。
如何在多台设备上使用同一个 Bot？
Bot Token 在 openclaw.json 中配置一次，所有登录了你 Telegram 账户的设备都可以与同一个 Bot 对话。Bot 会话是按 chat_id 隔离的，不会互相干扰。