OpenClaw Gateway 設定指南：管理連接埠與遠端存取模式

很多開發者在部署服務時，最怕遇到的就是連接埠衝突或是遠端存取權限設定錯誤，這些瑣碎的網路配置問題往往會浪費掉大把除錯時間。如果你正在處理 OpenClaw Gateway 的遠端連線與網路配置，這份指南能幫你快速釐清常見的設定盲點。

OpenClaw Gateway 預設連接埠有哪些？

了解 Gateway 預設使用的連接埠，能幫助你正確設定防火牆與網路規則。

連接埠	用途
18789	HTTP/WS (主要連接埠)
18790	gRPC (內部 RPC)

在遠端模式下，你會使用連接埠 18789（或是你自訂的連接埠）來同時處理 Control UI 與 Gateway 的 WebSocket 連線。

為什麼系統顯示 Gateway 已經在執行中？

這通常是因為有另一個行程，或是之前殘留的殭屍行程佔用了 18789 或 18790 連接埠。

# Check if the daemon is alive
openclaw gateway status

# Stop the service
openclaw gateway stop

# If you forcibly need the port
lsof -i :18789
kill -9 <pid>

如何在遠端模式下使用 CLI？

你可以透過在 CLI 指令中加入 --remote <gateway-url>，或是設定 OPENCLAW_GATEWAY_URL 環境變數與設定檔選項來達成。

範例：

openclaw status --remote http://my-vps-tailnet:18789

如果你的 Gateway 使用 token 驗證，記得同時設定 OPENCLAW_GATEWAY_TOKEN 或使用 --token 參數。

可以將 Gateway 綁定到 Tailnet 位址嗎？

沒問題，只要設定 gateway.bind: "tailnet"，OpenClaw 就會自動偵測你的 Tailscale 100.x.x.x 位址並進行綁定，但你必須同時設定 gateway.auth。

如果 Tailscale 沒有執行或是沒有取得 IP，Gateway 將無法啟動，並通常會出現以下錯誤：

Failed to bind to tailnet: no Tailscale IP found

修正方式：

1. 在該主機上啟動 Tailscale（確保它擁有 100.x 開頭的位址）。
2. 將設定改為 gateway.bind: "loopback" 或 "lan"。

可以在同一台主機上執行多個 Gateway 嗎？

通常不建議這樣做，因為一個 Gateway 本身就能處理多個訊息頻道與代理程式。只有在需要備援機制（例如救援機器人）或嚴格隔離環境時，才考慮執行多個 Gateway。

如果你必須這麼做，請務必進行以下隔離：

1. 為每個 Gateway 設定不同的連接埠。
2. 使用不同的狀態目錄 (OPENCLAW_STATE_DIR)。
3. 使用不同的服務名稱（自訂 unit file）。
4. 使用不同的憑證路徑以避免衝突。

如何啟用遠端管理（非 Loopback）？

非 Loopback 的綁定需要進行驗證，請務必正確設定 gateway.bind 與 gateway.auth。

{
  gateway: {
    bind: "lan",     // or "tailnet" for Tailscale-only
    port: 18789,
    auth: {
      mode: "token",
      token: "replace-me-with-a-strong-token"
    }
  }
}

另一種選擇是使用 Tailscale Serve：

openclaw gateway --tailscale serve

為什麼 Gateway 有在監聽但 Control UI 無法載入？

請檢查以下幾點：

1. 確認你使用的是 http:// 以及正確的主機名稱與連接埠。
2. 確認瀏覽器可以連線到該位址（檢查防火牆、Tailscale 或 VPN 設定）。
3. 確認 Gateway 驗證已設定，且你擁有正確的 token。

在 Gateway 主機上執行 openclaw gateway status 確認服務是否正常運作。如果服務正常，請嘗試使用 curl 測試健康檢查端點：

curl http://localhost:18789/health

---

下一步

如果你在設定過程中遇到困難，或是需要進一步的技術支援，歡迎使用 AI Setup Assistant 進行諮詢。

相關文件

• Gateway Ports & Remote Mode
• Configuration Guide