Skip to main content

​
Tailscale（閘道儀表板）

OpenClaw 可以自動配置 Tailscale Serve（tailnet）或 Funnel（公開）用於閘道儀表板和 WebSocket 埠。這使閘道保持綁定到環迴，同時 Tailscale 提供 HTTPS、路由和（用於 Serve）身分標頭。

​
模式

  • serve：透過 tailscale serve 的 Tailnet 限制 Serve。閘道停留在 127.0.0.1。
  • funnel：透過 tailscale funnel 的公開 HTTPS。OpenClaw 需要共用密碼。
  • off：預設（無 Tailscale 自動化）。

​
驗證

設定 gateway.auth.mode 以控制握手：
  • token（設定 OPENCLAW_GATEWAY_TOKEN 時的預設值）
  • password（透過 OPENCLAW_GATEWAY_PASSWORD 或設定的共用密碼）
當 tailscale.mode = "serve" 且 gateway.auth.allowTailscale 為 true 時，Control UI/WebSocket 驗證可以使用 Tailscale 身分標頭（tailscale-user-login）而無需提供令牌/密碼。OpenClaw 透過本機 Tailscale 精靈（tailscale whois）解析 x-forwarded-for 位址並將其與標頭比對以驗證身份。OpenClaw 僅當請求來自環迴且帶有 Tailscale 的 x-forwarded-for、x-forwarded-proto 和 x-forwarded-host 標頭時才將請求視為 Serve。HTTP API 端點（例如 /v1/*、/tools/invoke 和 /api/channels/*）仍需要令牌/密碼驗證。此無令牌流程假設閘道主機是受信任的。如果不受信任的本機程式碼可能在同一主機上執行，請停用 gateway.auth.allowTailscale 並改為需要令牌/密碼驗證。若要需要明確認證，請設定 gateway.auth.allowTailscale: false 或強制 gateway.auth.mode: "password"。

​
設定範例

​
Tailnet-only (Serve)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}
開啟: https://<magicdns>/ (或您設定的 gateway.controlUi.basePath)

​
Tailnet-only (Bind to Tailnet IP)

當您想要 Gateway 直接在 Tailnet IP 上監聽 (無 Serve/Funnel) 時使用此項。 
{
  gateway: {
    bind: "tailnet",
    auth: { mode: "token", token: "your-token" },
  },
}
從另一台 Tailnet 裝置連線:
  • Control UI: http://<tailscale-ip>:18789/
  • WebSocket: ws://<tailscale-ip>:18789
註記: Loopback (http://127.0.0.1:18789) 在此模式下 無法 運作。

​
Public Internet (Funnel + Shared Password)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password", password: "replace-me" },
  },
}
優先使用 OPENCLAW_GATEWAY_PASSWORD 勝過將密碼提交至磁碟。

​
CLI 範例

openclaw gateway --tailscale serve
openclaw gateway --tailscale funnel --auth password

​
註記

  • Tailscale Serve/Funnel 需要已安裝 tailscale CLI 並登入。
  • tailscale.mode: "funnel" 拒絕啟動除非 Auth Mode 為 password，以避免公開暴露。
  • 設定 gateway.tailscale.resetOnExit 若您希望 OpenClaw 在關閉時復原 tailscale serve 或 tailscale funnel 設定。
  • gateway.bind: "tailnet" 是直接 Tailnet Bind (無 HTTPS, 無 Serve/Funnel)。
  • gateway.bind: "auto" 偏好 Loopback；若您想要 Tailnet-only 則使用 tailnet。
  • Serve/Funnel 僅暴露 Gateway Control UI + WS。Nodes 透過相同的 Gateway WS Endpoint 連線，因此 Serve 可用於 Node 存取。

​
瀏覽器控制 (Remote Gateway + Local Browser)

若您在一台機器運行 Gateway 但想驅動另一台機器的瀏覽器，請在瀏覽器機器上運行 Node Host 並將兩者保持在相同 Tailnet 上。Gateway 會將瀏覽器動作 Proxy 至 Node；無需分開的 Control Server 或 Serve URL。 避免使用 Funnel 進行瀏覽器控制；像 Operator Access 一樣對待 Node 配對。

​
Tailscale 先決條件與限制

  • Serve 需要您的 Tailnet 啟用 HTTPS；若遺失 CLI 會提示。
  • Serve 注入 Tailscale Identity Headers；Funnel 不會。
  • Funnel 需要 Tailscale v1.38.3+, MagicDNS, 啟用 HTTPS, 以及 Funnel Node Attribute。
  • Funnel 僅支援 Ports 443, 8443, 與 10000 over TLS。
  • macOS 上的 Funnel 需要 Open-source Tailscale App Variant。

​
了解更多