Skip to main content

Hetzner 上的 OpenClaw(Docker,生產 VPS 指南)

目標

使用 Docker 在 Hetzner VPS 上執行具備持久狀態、內建二進位檔,且可安全重新啟動的 OpenClaw Gateway 閘道器。 如果你想要「約 ~5OpenClaw24/7」,這是最簡單且可靠的設定。如果你想要「約 5 的 OpenClaw 24/7」,這是最簡單且可靠的設定。 如果你想要「約 ~5 的 OpenClaw 24/7」,這是最簡單且可靠的設定。 Hetzner 的價格可能會變動;請選擇最小的 Debian/Ubuntu VPS,若遇到 OOM 再升級。

我們在做什麼(白話說明)?

  • 租用一台小型 Linux 伺服器(Hetzner VPS)
  • 安裝 Docker(隔離的應用程式執行環境)
  • 在 Docker 中啟動 OpenClaw Gateway 閘道器
  • 在主機上持久化 ~/.openclaw + ~/.openclaw/workspace(可跨重新啟動/重建存活)
  • 透過 SSH 通道,從你的筆電存取控制 UI
Gateway 閘道器可透過以下方式存取:
  • 從你的筆電進行 SSH 連接埠轉送
  • 如果你自行管理防火牆與權杖,可直接對外暴露連接埠
本指南假設你在 Hetzner 上使用 Ubuntu 或 Debian。
如果你使用的是其他 Linux VPS,請相應對應套件名稱。 如需通用的 Docker 流程,請參考 Docker

快速路徑(有經驗的操作人員)

  1. 建立 Hetzner VPS
  2. 安裝 Docker
  3. 複製 OpenClaw 儲存庫
  4. 建立持久化的主機目錄
  5. 設定 .envdocker-compose.yml
  6. 將所需的二進位檔案烘焙進映像檔中
  7. docker compose up -d
  8. 驗證持久性與 Gateway 存取

你需要的項目

  • 具備 root 存取權的 Hetzner VPS
  • 從你的筆電進行 SSH 連線
  • 基本的 SSH + 複製/貼上操作熟悉度
  • 約 20 分鐘
  • Docker 與 Docker Compose
  • 模型身分驗證憑證
  • 選用的提供者憑證
    • WhatsApp QR
    • Telegram 機器人權杖
    • Gmail OAuth

1. 建立 VPS

在 Hetzner 建立一台 Ubuntu 或 Debian VPS。 以 root 連線:
本指南假設該 VPS 是有狀態的。 請勿將其視為可隨意丟棄的基礎設施。 請勿將其視為一次性基礎設施。 請勿將其視為一次性基礎設施。

2. 在 VPS 上安裝 Docker

驗證:

3. 複製 OpenClaw 儲存庫

  1. 本指南假設你會建立自訂映像以保證二進位檔案的持久性。

4. 建立持久化的主機目錄

Docker 容器是短暫的。 所有長期存在的狀態都必須存放在主機上。

5. 設定環境變數

在儲存庫根目錄建立 .env
產生強式祕密:
請勿提交此檔案。

6. Docker Compose 設定

建立或更新 docker-compose.yml
--allow-unconfigured 僅用於啟動時的便利性,不能取代正確的 Gateway 設定。 13. 仍請設定驗證(gateway.auth.token 或密碼),並為你的部署使用安全的綁定設定。

7. 將必要的二進位檔烘焙進映像檔(關鍵)

在執行中的容器內安裝二進位檔案是一個陷阱。 任何在執行時安裝的內容都會在重新啟動後遺失。 技能所需的所有外部二進位檔都必須在映像建置時安裝。 以下範例僅示範三種常見的二進位檔:
  • 用於 Gmail 存取的 gog
  • 用於 Google Places 的 goplaces
  • 用於 WhatsApp 的 wacli
以下僅為範例,並非完整清單。 22. 你可以使用相同的模式安裝任意數量的二進位檔案。 若你之後新增依賴其他二進位檔的 Skills,必須:
  1. 更新 Dockerfile
  2. 重新建置映像檔
  3. 重新啟動容器
Dockerfile 範例

8. 建置並啟動

  1. 驗證二進位檔案:
  1. 預期輸出:

9. 驗證 Gateway 閘道器

成功:
在你的筆電上:
開啟: http://127.0.0.1:18789/ 貼上你的 gateway 權杖。

26. 什麼資料持久化於何處(真實來源)

OpenClaw 在 Docker 中執行,但 Docker 不是事實來源。 所有長期存在的狀態,都必須能在重新啟動、重建與重新開機後存活。 27. 所有長期存在的狀態都必須能在重新啟動、重建與重新開機後存活。

基礎設施即程式碼(Terraform)

對於偏好 infrastructure-as-code 工作流程的團隊,社群維護的 Terraform 設定提供:
  • 具備遠端 state 管理的模組化 Terraform 設定
  • 透過 cloud-init 進行自動化佈建
  • 部署腳本(bootstrap、deploy、backup/restore)
  • 安全強化(防火牆、UFW、僅限 SSH 存取)
  • 用於 gateway 存取的 SSH 通道設定
Repositories: 此方法可搭配上述 Docker 設定,提供可重現的部署、版本控制的基礎設施,以及自動化災難復原。
注意: 由社群維護。 如有問題或想貢獻,請參閱上述儲存庫連結。