2026 OpenClaw 部署后三联症排错
Gateway 已运行但 Telegram 无回执、Chrome Relay 断连与 409 冲突验收清单

openclaw gateway status 已是 Runtime: running,却在 Telegram 里发消息毫无回执、Chrome 扩展 Relay 一直灰、日志里偶发 409 Conflict——你遇到的是 2026 年部署场景里最高频的「三联症」:控制面健康,业务通道却未闭环。本文面向已跑通安装、要把 OpenClaw 推进 7×24 生产的开发者,给出 四连探针、症状对照表、六步验收 Runbook 与 FAQ;并与站内 安装半安装恢复channels probe 专文gateway not ready 明确分工,避免在错误阶段改配置。

01

部署后「三联症」:为什么 Gateway 绿了,渠道却还哑火?

很多团队把「安装成功」等同于「可以对外服务」。在 OpenClaw 2026 架构里,Gateway 进程渠道子系统(Telegram / WhatsApp 等)浏览器 Relay是三条独立链路:前者只保证 RPC 与控制面;后两者还依赖 Token、Webhook 模式、配对策略、扩展里的 WebSocket 地址,以及反向代理是否正确升级连接。下面六条症状任意命中两条,就应走本文路径,而不是回头重装整台机器。

  • 01

    Telegram 完全无回执:Bot 在线、你给 Bot 发消息,Gateway 日志无 inbound;常见于 409(多实例抢同一 Bot Token)或残留 Webhook 阻断 polling。

  • 02

    日志出现 409 Conflict:同一 BOT_TOKEN 被第二台 Gateway、旧容器或本地调试进程同时 long-polling。

  • 03

    Chrome Relay 徽章亮但无标签页:扩展连上错误端口/主机,或 Nginx 未转发 Upgrade: websocket;2026.3.22+ 部分构建调整过 relay 驱动,跨机场景需对照官方变更说明。

  • 04

    channels probe 失败但 gateway status 正常:多半是配对未批准或 dmPolicy 拦截,而非 Gateway 未安装——详见 channels probe 专文

  • 05

    远程 CLI 报 Unauthorized:配置键已从 gateway.token 迁移到 gateway.auth.token,需 openclaw doctor --generate-gateway-token 后重启。

  • 06

    18789 EADDRINUSE:表面「running」实为陈旧 PID;需清端口再 gateway restart,勿先改一堆渠道配置。

02

对照表:该读哪篇站内文?症状 → 文档分工

你看到的表象优先本文(部署后三联症)应转读的专文
install.sh 成功但无 Gateway半安装恢复
gateway status: not ready / OOMgateway not ready
running + Telegram 409 / 无回执配对问题叠加时 + channels probe
running + Relay 断连公网暴露时 + Gateway 安全 / Tailscale 专题
models Unauthorized部分(Token 键)鉴权排错

「Gateway 探针 ok」只证明控制面活着——渠道与浏览器 Relay 还要各自过一遍验收,才算部署完成。

03

六步验收 Runbook:四连探针 → 清 409 → 拉通 Relay

顺序固定:先证明只有一台 Gateway 在消费 Token,再处理配对与 Relay URL。不要在 409 未消除时反复 openclaw gateway restart,否则日志只会更乱。

  1. 01

    四连探针(约 5 分钟):openclaw statusopenclaw gateway status --deepopenclaw channels status --probeopenclaw doctor --deep;另开终端 openclaw logs --follow 观察 inbound。

  2. 02

    Telegram Token 体检:curl "https://api.telegram.org/bot<TOKEN>/getMe" 确认 Bot 有效;若曾设 Webhook,执行 deleteWebhook 恢复 polling。

  3. 03

    消灭 409:停掉所有其他 Gateway/调试进程(含旧 Docker 栈、同事笔记本上的同名 Bot);保证全局仅一个实例持有该 Token。

  4. 04

    配对与 dmPolicy:openclaw pairing approve telegram <CODE>;probe 仍失败时对照 channels 专文调整 dmPolicy,勿把 Gateway 暴露到 0.0.0.0 试运气。

  5. 05

    Chrome Relay:扩展选项里的 Gateway URL 必须与真实监听一致(本机常见 ws://127.0.0.1:18789 或文档声明端口;经反代须 wss:// 且带 Upgrade 头);跨机部署要确认 2026.3+ relay 驱动变更是否影响你的拓扑。

  6. 06

    重启与复检:openclaw doctor --fixopenclaw gateway restart → 再次 channels status --probe;macOS 常驻对照 launchd 专文,Linux 对照 Ubuntu systemd 部署

bash
# 部署后四连探针 + Telegram Webhook 清理示例
openclaw status
openclaw gateway status --deep
openclaw channels status --probe
openclaw doctor --deep

curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getMe"
curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/deleteWebhook"

openclaw pairing approve telegram YOUR_CODE
openclaw gateway restart
info

提示:若 Gateway 其实未监听,请先读 半安装恢复,再回本文;否则会在错误阶段清空有效配置。

warning

注意:为排查方便临时把 Gateway 绑到 0.0.0.0 是高风险操作;生产应维持 loopback + Tailscale/隧道,Token 轮换见鉴权专文。

04

三条可写进变更单的硬核口径 + 宿主选型

  • 单 Token 单消费者:Telegram Bot API 的 long-polling 在 2026 仍不允许同一 Token 被多进程同时消费;409 是设计层面的互斥信号,不是「多试几次就好」。
  • 配置键迁移:社区文档已统一将 Gateway 鉴权写入 gateway.auth.token;升级后若只改旧键,会出现「本地 doctor 通过、远程 CLI 401」的假象。
  • Relay 与控制面端口解耦:浏览器扩展连接的 WebSocket 端点必须与 Gateway 实际发布地址一致;反代层缺 Connection: upgrade 时,表现往往是「扩展亮、无标签」。

把 Gateway 放在会睡眠的笔记本、或与 CI 抢资源的共享 Mac 上,三联症会在系统更新或端口争用后复发;而独占、长期在线的 macOS 节点更适合承载 7×24 渠道与 Relay。若你需要像租 VPS 一样快速拿到可 SSH 维护、可把「四连探针」写进标准镜像的 Mac 算力,NodeMini 的 Mac Mini 云端租赁通常是更优解:与 OpenClaw 远程模式、iOS CI 同机编排同一运维心智,减少「家里 Gateway 睡着、办公室 Bot 还在抢 Token」这类人为 409。

FAQ

常见问题

按第三节 Runbook:先 channels status --probe,再查 409、deleteWebhookpairing approve。节点规格见 租赁价格说明

channels 专文侧重配对与 dmPolicy;本文覆盖Gateway 已起但渠道静默、Chrome Relay 与 409 的组合故障。建议两篇连读。

部分版本调整过扩展 relay 驱动,跨机场景需对照发行说明;接入与审计问题见 帮助中心