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 驅動,跨機場景需對照發行說明;接入與稽核問題見 說明中心