OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Gateway

多租戶託管

多租戶託管

OpenClaw 的預設安全模型是每個閘道各有一個受信任的操作員邊界，而不是在單一共用閘道內提供可抵禦惡意行為的多租戶隔離。因此，若要託管不共用信任邊界的使用者或組織，就必須為每個租戶執行一個獨立且完整的 OpenClaw 執行個體。

openclaw fleet 將每個隔離的執行個體稱為一個 cell。cell 是在強化容器中執行的完整閘道，擁有自己的狀態、認證資訊、工作區、頻道帳號、權杖，以及僅限回送介面的主機連接埠。

Fleet 目前為實驗性功能：在此介面趨於穩定前，其命令、旗標和容器設定檔可能在不同版本間變更，且不會提供淘汰通知期。

Fleet 已在 Linux 和 macOS 主機上測試。目前尚未測試 Windows 主機。

為何每個租戶都需要一個 cell

在單一閘道內，經過驗證的操作員具有受信任的控制平面角色。工作階段 ID 用於選擇路由；它們不會授權某個租戶存取另一個租戶。代理程式沙箱可以降低不受信任內容和工具執行所造成的影響，但無法將單一共用閘道轉變為租戶授權邊界。

每個租戶應使用一個 cell，讓每個信任網域都有獨立的閘道程序、容器、持久狀態樹和閘道認證資訊。這符合閘道安全模型：請勿在同一個 OpenClaw 程序或同一個作業系統使用者下共同託管彼此不信任的使用者。

架構

Fleet 命令列介面是主機端的生命週期監督程式。它會將 cell 記錄在 OpenClaw 狀態資料庫中，並要求本機 Docker 或 Podman 執行階段建立、檢查、啟動、停止、替換及移除其容器。Fleet 會拒絕遠端執行階段端點，因為 Fleet 的繫結路徑和回送 URL 屬於本機主機；在遠端 cell 主機具備明確的儲存空間與端點契約前，不會支援此功能。Fleet 不會代理租戶訊息，也不會在 cell 之間新增共用的應用程式層級資料路徑。

每個 cell 都會在自己的使用者定義橋接網路上執行官方 ghcr.io/openclaw/openclaw 映像。各自獨立的橋接網路可防止 cell 之間透過容器 IP 直接傳輸流量，同時保留供應商和頻道所需的對外 NAT 存取。預設不限制對外流量。Podman cell 可以使用 --network internal 阻擋對外流量，同時保留已發布的回送閘道連接埠。Docker 內部網路會導致該已發布連接埠無法運作，因此 Fleet 會拒絕這種組合；請改用主機防火牆規則（例如 DOCKER-USER 鏈）來強制執行 Docker 對外流量政策。cell 閘道在容器內監聽連接埠 18789，而執行階段只會將其發布至主機上的 127.0.0.1:<allocated-port>。需要遠端存取時，操作員可以在該回送端點前方放置經核准的反向 Proxy、SSH 通道或 tailnet。

持久閘道狀態來自 <state-dir>/fleet/cells/<tenant>/，並掛載至 /home/node/.openclaw。驗證設定檔加密金鑰來自獨立的 <state-dir>/fleet/auth-profile-secrets/<tenant>/ 主機路徑，並掛載至 /home/node/.config/openclaw，與官方的 Docker 持久化配置一致。金鑰不會巢狀存放於一般狀態掛載點下。各租戶的頻道帳號會在擁有該帳號的 cell 內終止連線，因此 Fleet MVP 中沒有共用的頻道帳號或共用的輸入訊息路由器。

官方映像預設使用 UID 1000 的非 root node 使用者。Fleet 使用與主機相容的使用者對應，讓私有繫結掛載點保持可寫入：Podman 使用 keep-id，以 root 執行的 Docker 使用叫用命令之非 root 使用者的身分，而無 root 權限的 Docker 則將容器 root 對應至不具特殊權限的常駐程式使用者。主機啟用 SELinux 時，Docker 和 Podman 會套用私有的 :Z 重新標記。容器設定檔會避開具特殊權限的主機功能，並適合無 root 權限的環境，但無 root 權限運作是主機執行階段的選擇與先決條件，Fleet 不會自動啟用此功能。

信任邊界

多租戶架構可保護各租戶不受其他租戶影響。每個租戶都信任 Fleet 操作員和主機。抵禦主機遭入侵不在設計目標之內。

這表示主機管理員可以檢查容器設定與環境、讀取已掛載的 cell 資料、替換映像或進入容器。管理員可透過 Docker 或 Podman 檢查功能查看閘道權杖和以 --env 傳入的值。因此，請搭配使用主機控制措施、管理存取政策、監控、備份及經核准的秘密管理工具。

基準設定可防止意外的萬用字元網路暴露，並移除常見的容器權限提升機制，但無法使不受信任的主機變得安全。

隔離層級

請選擇符合所託管租戶需求的邊界：

  1. 強化容器基準。 Fleet 會移除所有 Linux 權能、啟用 no-new-privileges、套用 PID、記憶體、CPU，以及選用的可寫入層磁碟限制、使用獨立的持久掛載點和各 cell 專屬網路，並且只發布至主機回送介面。橋接網路不會限制對外流量；當 cell 不得主動建立對外連線時，請使用 Podman 的 --network internal 或 Docker 主機防火牆政策。這是適用於信任操作員和主機之租戶的 MVP 設定檔。
  2. 更強的容器或 VM 隔離。 對於風險較高的工作負載，請設定 Docker 或 Podman 使用更強的 OCI 隔離執行階段，例如 gVisor 或 Kata Containers，或將 cell 放入 microVM。這是執行階段或基礎架構設定；Fleet 的 --runtime docker|podman 選項只會選擇容器命令列介面，而不會選擇 OCI 隔離後端。請參閱 Docker 的替代容器執行階段和 Docker VM 執行階段指南。
  3. 為惡意租戶使用獨立機器。 請勿在同一個 OpenClaw 程序或作業系統使用者下共同託管彼此敵對的租戶。若租戶不信任同一位主機操作員，或需要更強的管理邊界，請使用具備獨立執行階段管理的不同 VM 或實體主機。

此隔離層級中的任何一層都不會改變 OpenClaw 應用程式的信任模型：一個閘道仍然是一個受信任的操作員網域。

快速開始

建立一個 cell。此命令只會顯示產生的閘道權杖一次，因此請立即儲存：

bash
openclaw fleet create acme

在 Fleet 主機上開啟回報的 http://127.0.0.1:<port> URL，使用該租戶的權杖進行驗證，並在 cell 內設定供應商認證資訊和頻道帳號。

檢查容器狀態和閘道是否正常運作：

bash
openclaw fleet status acme

升級時保留主機連接埠、已掛載資料、資源設定檔、使用者提供的環境和閘道權杖：

bash
openclaw fleet upgrade acme

移除容器和登錄資料列，但保留租戶資料：

bash
openclaw fleet rm acme --force

若也要刪除持久租戶資料，請加上 --purge-data。清除操作需要 --force、無法復原，且在刪除任何內容前會執行解析路徑的包含範圍檢查：

bash
openclaw fleet rm acme --purge-data --force

請參閱 openclaw fleet 命令列介面參考，以瞭解所有命令和選項。

MVP 暫緩項目

Fleet 的第一個版本刻意將下列介面留待後續設計：

  • 共用頻道帳號或共用輸入路由器
  • 使用精簡的各租戶主機程序，而非完整的 OpenClaw 執行個體
  • 由單一監督程式管理的遠端 cell 主機
  • 租戶自助服務入口網站、計費平面或委派管理使用者介面

這些功能需要明確的身分、路由、授權和故障網域契約。不應透過讓租戶共用單一閘道或其認證資訊來模擬這些功能。這些功能也不屬於 Fleet 的範疇：Fleet 會維持為單一主機的生命週期監督程式，而多機器且受身分控管的 Fleet 應由其上層的專用控制平面負責。

相關內容

Was this useful?
On this page

On this page