Skip to content

建立 2026-09-15 更新 2026-09-15

Gateway

Gateway 是 OpenClaw 的核心行程：聊天 App、Control UI、CLI、手機節點都連到它。會話狀態、頻道外掛、要不要把訊息交給 agent，都在這裡決定。沒開閘道，其他畫面再漂亮也沒有用。

預設行為

  • 本機綁 loopback，埠 18789
  • 即使只聽 127.0.0.1，新安裝仍會產生閘道 token（token 模式），避免之後一改 bind 就變成裸奔
  • 設定寫在 ~/.openclaw/openclaw.json
openclaw gateway status
openclaw gateway restart
openclaw gateway install

status 應顯示正在聽 18789。改完設定檔通常要 restart。install 把閘道交給作業系統在登入後自動跑。

本機、遠端、操作員

角色 意義
本機閘道 助理跑在這台機器上，頻道與工具也在這台執行
遠端連線 這台筆電只連到家裡／VPS 上的閘道，不在遠端主機上重裝
操作員 能改 ~/.openclaw 或通過 Control UI 驗證的人，視為可信任的控制面，不是「多租戶帳號」

一個閘道是一個信任邊界。互相不信任的人不要共用同一個有工具的 agent；要隔離就開另一個閘道（最好換 OS 使用者或主機）。見 安全。

常見踩點

  • 終端機前景閘道被 Ctrl+C 掉，又沒 gateway install：頻道會靜音。
  • bind 改成 LAN 或 0.0.0.0 卻沒有 token／密碼：等於把控制台跟 agent 工具暴露出去。
  • 反向代理終止 TLS 後，忘了告訴閘道誰是 trusted proxy，auth 可能被繞過或誤判。

出問題時：

openclaw doctor
openclaw triage
openclaw security audit

下一步：選模型，或回頭用 Control UI 確認聊天有通。