若 openclaw gateway status 已是 Runtime: running,却在 Telegram 里发消息毫无回执、Chrome 扩展 Relay 一直灰、日志里偶发 409 Conflict——你遇到的是 2026 年部署场景里最高频的「三联症」:控制面健康,业务通道却未闭环。本文面向已跑通安装、要把 OpenClaw 推进 7×24 生产的开发者,给出 四连探针、症状对照表、六步验收 Runbook 与 FAQ;并与站内 安装半安装恢复、channels probe 专文、gateway not ready 明确分工,避免在错误阶段改配置。
很多团队把「安装成功」等同于「可以对外服务」。在 OpenClaw 2026 架构里,Gateway 进程与渠道子系统(Telegram / WhatsApp 等)、浏览器 Relay是三条独立链路:前者只保证 RPC 与控制面;后两者还依赖 Token、Webhook 模式、配对策略、扩展里的 WebSocket 地址,以及反向代理是否正确升级连接。下面六条症状任意命中两条,就应走本文路径,而不是回头重装整台机器。
Telegram 完全无回执:Bot 在线、你给 Bot 发消息,Gateway 日志无 inbound;常见于 409(多实例抢同一 Bot Token)或残留 Webhook 阻断 polling。
日志出现 409 Conflict:同一 BOT_TOKEN 被第二台 Gateway、旧容器或本地调试进程同时 long-polling。
Chrome Relay 徽章亮但无标签页:扩展连上错误端口/主机,或 Nginx 未转发 Upgrade: websocket;2026.3.22+ 部分构建调整过 relay 驱动,跨机场景需对照官方变更说明。
channels probe 失败但 gateway status 正常:多半是配对未批准或 dmPolicy 拦截,而非 Gateway 未安装——详见 channels probe 专文。
远程 CLI 报 Unauthorized:配置键已从 gateway.token 迁移到 gateway.auth.token,需 openclaw doctor --generate-gateway-token 后重启。
18789 EADDRINUSE:表面「running」实为陈旧 PID;需清端口再 gateway restart,勿先改一堆渠道配置。
| 你看到的表象 | 优先本文(部署后三联症) | 应转读的专文 |
|---|---|---|
| install.sh 成功但无 Gateway | 否 | 半安装恢复 |
| gateway status: not ready / OOM | 否 | gateway not ready |
| running + Telegram 409 / 无回执 | 是 | 配对问题叠加时 + channels probe |
| running + Relay 断连 | 是 | 公网暴露时 + Gateway 安全 / Tailscale 专题 |
| models Unauthorized | 部分(Token 键) | 鉴权排错 |
「Gateway 探针 ok」只证明控制面活着——渠道与浏览器 Relay 还要各自过一遍验收,才算部署完成。
顺序固定:先证明只有一台 Gateway 在消费 Token,再处理配对与 Relay URL。不要在 409 未消除时反复 openclaw gateway restart,否则日志只会更乱。
四连探针(约 5 分钟):openclaw status → openclaw gateway status --deep → openclaw channels status --probe → openclaw doctor --deep;另开终端 openclaw logs --follow 观察 inbound。
Telegram Token 体检:curl "https://api.telegram.org/bot<TOKEN>/getMe" 确认 Bot 有效;若曾设 Webhook,执行 deleteWebhook 恢复 polling。
消灭 409:停掉所有其他 Gateway/调试进程(含旧 Docker 栈、同事笔记本上的同名 Bot);保证全局仅一个实例持有该 Token。
配对与 dmPolicy:openclaw pairing approve telegram <CODE>;probe 仍失败时对照 channels 专文调整 dmPolicy,勿把 Gateway 暴露到 0.0.0.0 试运气。
Chrome Relay:扩展选项里的 Gateway URL 必须与真实监听一致(本机常见 ws://127.0.0.1:18789 或文档声明端口;经反代须 wss:// 且带 Upgrade 头);跨机部署要确认 2026.3+ relay 驱动变更是否影响你的拓扑。
重启与复检:openclaw doctor --fix → openclaw gateway restart → 再次 channels status --probe;macOS 常驻对照 launchd 专文,Linux 对照 Ubuntu systemd 部署。
# 部署后四连探针 + 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
提示:若 Gateway 其实未监听,请先读 半安装恢复,再回本文;否则会在错误阶段清空有效配置。
注意:为排查方便临时把 Gateway 绑到 0.0.0.0 是高风险操作;生产应维持 loopback + Tailscale/隧道,Token 轮换见鉴权专文。
gateway.auth.token;升级后若只改旧键,会出现「本地 doctor 通过、远程 CLI 401」的假象。Connection: upgrade 时,表现往往是「扩展亮、无标签」。把 Gateway 放在会睡眠的笔记本、或与 CI 抢资源的共享 Mac 上,三联症会在系统更新或端口争用后复发;而独占、长期在线的 macOS 节点更适合承载 7×24 渠道与 Relay。若你需要像租 VPS 一样快速拿到可 SSH 维护、可把「四连探针」写进标准镜像的 Mac 算力,NodeMini 的 Mac Mini 云端租赁通常是更优解:与 OpenClaw 远程模式、iOS CI 同机编排同一运维心智,减少「家里 Gateway 睡着、办公室 Bot 还在抢 Token」这类人为 409。