跳转到内容
最近更新

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 正常运行

Command
openclaw gateway status || trueopenclaw gateway --detach

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

Step 1：通过 BotFather 创建机器人

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

Step 2：写入 Telegram Bot Token 配置

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

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

Step 3：重启 gateway

Command
openclaw gateway restart

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

Step 4：在 Telegram 中测试

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

Step 5：如有配对码则批准

Command
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、运行时和网络排查步骤

代理问题（国内常见）

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

相关链接