ClawPod

OpenClaw Telegram 机器人不响应？5 个修复方案

2026/03/27

你的 OpenClaw agent 昨天还好好的。今天你在 Telegram 发了条消息，然后……什么反应都没有。OpenClaw Telegram 机器人不响应了。或者更惨 — 回复在 5-10 分钟后才姗姗来迟，那时候你早就放弃了。

这是 OpenClaw 最让人抓狂的问题之一，因为 agent 经常看起来是正常的。日志显示在运行，gateway 显示 "connected"。但消息就是延迟、丢失或被静默忽略。

以下是 5 个最常见的原因 — 以及每个的精确修复方案。

症状对照：你遇到了哪种问题？

先确认你的症状：

症状最可能的原因跳转
机器人从不回复，新安装轮询未启动原因 1
消息延迟 5-10 分钟长轮询卡住原因 2
私聊正常，群消息不回缺少权限原因 3
每 20-30 分钟崩溃一次AbortError 循环原因 4
升级后不工作了配置迁移原因 5

原因 1：轮询从未启动

症状： 全新安装，机器人从不回复任何消息。

最基本的问题：OpenClaw 的 Telegram 频道根本没有在监听消息。这种情况发生在：

  • Telegram bot token 错误或缺失
  • 频道配置存在但未启用
  • Gateway 在 Telegram 频道配置完成前就启动了

诊断：

openclaw channels status

如果 Telegram 显示 "disconnected" 或根本没列出来，说明频道没有激活。

修复：

  1. 验证 bot token：
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

如果返回错误，token 无效。去 @BotFather 重新创建。

  1. 检查 openclaw.json 中的频道配置：
{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "your-token-here"
    }
  }
}
  1. 重启 gateway：
openclaw gateway restart

原因 2：长轮询卡住（Node 22+ 问题）

症状： 消息延迟 5-10 分钟，或者一批一批到达。

这是运行 Node.js 22 及以上版本的服务器上最常见的原因。问题在于 Node 22 改变了 fetch() 中 AbortSignal 的处理方式。

OpenClaw 的 Telegram 频道使用长轮询 — 它与 Telegram 服务器保持一个打开的 HTTP 连接，等待新消息。Node 22 更严格的 AbortSignal 处理有时会导致这些连接静默失败而不触发重连。消息在 Telegram 端堆积，直到 OpenClaw 最终重新连接。

诊断：

node -v

如果是 v22.x 或更高版本，这很可能就是问题所在。

openclaw logs --follow | grep -i "telegram\|abort\|polling"

寻找 AbortError 条目或轮询活动中的空白。

修复：

方案 A — 切换到 webhook 模式（生产环境推荐）：

{
  "channels": {
    "telegram": {
      "mode": "webhook",
      "webhook_url": "https://your-domain.com/api/telegram/webhook"
    }
  }
}

Webhook 模式不使用长轮询，所以完全不受这个问题影响。而且更快 — 消息即时到达，不需要等下一次轮询。

方案 B — 如果无法使用 webhook（没有公网 URL）：

# 降级到 Node 20 LTS
nvm install 20
nvm use 20
openclaw gateway restart

原因 3：群消息被静默丢弃

症状： 机器人回复私聊消息，但忽略群聊消息。

OpenClaw 2026.2.24 之后，Telegram 频道需要显式的群消息权限。没有权限时，群消息被 gateway 接收但在到达 agent 之前就被过滤掉了。

诊断：

给机器人发私聊 — 能回复吗？然后在群里 @ 你的机器人 — 被忽略了吗？

修复：

  1. 在 BotFather 中关闭 "Group Privacy"：

    打开 @BotFather → /mybots → 选你的机器人 → "Bot Settings" → "Group Privacy" → 关闭

  2. 更新 openclaw.json：

{
  "channels": {
    "telegram": {
      "allowed_updates": ["message", "callback_query", "inline_query"],
      "group_messages": true
    }
  }
}
  1. 重启：
openclaw gateway restart

原因 4：AbortError 崩溃循环

症状： 机器人工作 20-30 分钟后停止响应。重启能临时修复。

这是原因 2 的加重版。轮询进程直接崩溃并且不自动重连。

诊断：

openclaw logs --follow

观察是否出现：

AbortError: The operation was aborted
  at fetch (/app/node_modules/...
Telegram channel disconnected

如果每 20-30 分钟出现一次，你在崩溃循环里。

修复：

最可靠的方案是切换到 webhook 模式（见原因 2，方案 A）。如果做不到：

  1. 用进程管理器自动重启：
# 使用 pm2
pm2 start "openclaw gateway start" --name openclaw --restart-delay=5000
  1. 或添加健康检查定时任务：
# 添加到 crontab：每 5 分钟检查，挂了就重启
*/5 * * * * openclaw channels status --probe | grep -q "telegram.*connected" || openclaw gateway restart

这些都是临时方案。Webhook 模式才是根本解决办法。

原因 5：升级后配置不兼容

症状： 之前好好的，openclaw update 之后不工作了。

2026 年 OpenClaw 的 Telegram 频道配置改了好几次：

版本破坏性变更
2026.2.24新增 group_messages 字段（默认 false）
2026.3.8telegram.token 改名为 telegram.bot_token
2026.3.13废弃 MOLTBOT_TELEGRAM_TOKEN 环境变量

升级后旧的配置键可能不被识别。

修复：

openclaw doctor --fix
openclaw gateway restart

如果 openclaw doctor 没检测到，手动对照当前配置规范检查你的 Telegram 配置。

完整的升级安全指南请看我们的 OpenClaw 升级指南。

什么时候该切换到 Webhook 模式？

如果你遇到了原因 2 或 4，webhook 模式是终极解决方案：

长轮询Webhook
需要公网 URL？不需要需要
消息送达有延迟即时
Node 22+ 兼容？有 Bug没问题
服务器资源较高（持续连接）较低
适合本地开发、无域名生产环境

如果你的服务器有域名和 SSL（生产环境必须有），就用 webhook 模式。

跳过这一切

这个页面上的每个问题都有一个共同点：你在维护基础设施，而不是在使用 AI 助手。

ClawPod 默认使用 webhook 模式、自动健康监控，Telegram 配置只需要粘贴 bot token：

  • Webhook 模式 — 消息即时送达，没有轮询 bug
  • 24/7 健康检查 — 出问题自动重启
  • 不用操心 Node.js 版本
  • 不会有配置迁移意外
  • 30 秒搞定：粘贴 token，点击部署

立即开始 →

常见问题

为什么 OpenClaw Telegram 机器人几小时后就不响应了？

最可能是 AbortError 崩溃循环（原因 4），Node.js 22+ 的长轮询连接处理有 bug。机器人一开始正常，但轮询连接每 20-30 分钟就静默断开。切换到 webhook 模式可以根治。

怎么检查 OpenClaw Telegram 机器人是否在接收消息？

运行 openclaw channels status --probe 验证 Telegram 频道是否连接且活跃。然后用 openclaw logs --follow 查看日志，发一条测试消息——几秒内应该能在日志中看到。

OpenClaw 的轮询模式和 webhook 模式有什么区别？

长轮询模式不断问 Telegram "有新消息吗？"——不需要公网 URL 但更慢且在 Node 22+ 上有 bug。Webhook 模式让 Telegram 主动把消息推到你的服务器——更快更可靠，但需要有 SSL 的公网 URL。

OpenClaw Telegram 机器人在私聊能回复但群里不行，为什么？

OpenClaw 2026.2.24 之后，群消息需要显式授权。在 BotFather 里关闭 "Group Privacy" 并在 Telegram 频道配置中添加 "group_messages": true。具体步骤见上面的原因 3。

遇到 gateway 连接问题？查看修复 Gateway Disconnected 1008。完整的托管方案对比请看 VPS 托管费用对比。刚接触 OpenClaw？从什么是 OpenClaw？开始。

最后更新：2026 年 3 月

ClawPod

ClawPod

OpenClaw Telegram 机器人不响应？5 个修复方案 | ClawPod 博客