OpenClaw Telegram 接入指南

OpenClaw Telegram 接入指南

Telegram 仍然是验证 OpenClaw 是否安装正确、网关是否能正常回复消息、以及第一条真实通道工作流是否跑通的最快方式。本指南覆盖完整的 OpenClaw Telegram 接入流程，包括 Bot 创建、Bot Token 配置、网关重启、配对和不回复排查。

为什么建议先用 Telegram

• Telegram 往往是最容易验证的 OpenClaw 通道
• 只要拿到 Bot Token 并收到一条成功回复，就能确认网关主链路已经跑通
• 在继续接入更多通道、技能或 browser relay 之前，它是最稳妥的第一步

你将完成什么

• 创建 Telegram Bot 并拿到 Bot Token
• 在 OpenClaw 中启用 Telegram 通道
• 重启 gateway 并验证机器人能回复
• 学会处理不回复、网络受限和配对失败等常见问题

Step 0：确认 OpenClaw gateway 正常运行

openclaw gateway status || trueopenclaw gateway --detach

如果 gateway 已经在运行，这一步只是确认 OpenClaw 运行时是否可用。如果进程拉不起来，先去看 /docs/troubleshooting。

Step 1：通过 BotFather 创建机器人

• 搜索 @BotFather
• 执行 /newbot
• 复制拿到的 Telegram Bot Token

Step 2：写入 Telegram Bot Token 配置

openclaw config set channels.telegram.botToken "YOUR_TELEGRAM_BOT_TOKEN"openclaw config set channels.telegram.enabled true

这是最关键的 OpenClaw Telegram 配置。如果 token 错误或缺失，机器人可能显示在线，但普通消息不会收到回复。

Step 3：重启 gateway

openclaw gateway restart

重启后网关才会重新加载 Telegram 通道配置。如果你跳过这一步，新写入的 bot token 很可能不会生效。

Step 4：在 Telegram 中测试

• 搜索你的 bot
• 发送 /start
• 再发送一条普通文本消息，确认机器人能回复

Step 5：如有配对码则批准

openclaw pairing approve telegram <配对码>

处理不回复、网络受限或 token 异常

• 用 openclaw config get channels.telegram.botToken 再次确认 token 已保存
• 每次修改 Telegram 配置后都重启一次 gateway
• 确认服务器可以访问 https://api.telegram.org
• 如果仍然不回复，再对照 /docs/advanced-config 和 /docs/troubleshooting 中的 gateway token、运行时和网络排查步骤

代理问题（国内常见）

export https_proxy=http://127.0.0.1:7890export http_proxy=http://127.0.0.1:7890openclaw gateway restart

相关链接

• 排错：/docs/troubleshooting
• 高级配置、网关令牌与浏览器中继：/docs/advanced-config
• OpenClaw FAQ：/faq
• 技能榜单与真实案例：/skills 和 /use-cases