Hetzner

佈建 VPS

在 Hetzner 建立 Ubuntu 或 Debian VPS。

以 root 連線：

ssh root@YOUR_VPS_IP

本指南假設 VPS 是有狀態的。 不要把它視為可拋棄的基礎設施。

安裝 Docker（在 VPS 上）

apt-get update
apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sh

驗證：

docker --version
docker compose version

複製 OpenClaw 儲存庫

git clone https://github.com/openclaw/openclaw.git
cd openclaw

本指南假設你會建置自訂映像檔，以確保二進位檔持久存在。

建立持久化主機目錄

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

mkdir -p /root/.openclaw/workspace

# Set ownership to the container user (uid 1000):
chown -R 1000:1000 /root/.openclaw

設定環境變數

在儲存庫根目錄建立 .env。

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/root/.openclaw
OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw

當你想透過 .env 管理穩定的 gateway 權杖時，請設定 OPENCLAW_GATEWAY_TOKEN；否則請先設定 gateway.auth.token，再依賴用戶端跨重新啟動使用。若兩個來源都不存在，OpenClaw 會在該次啟動使用僅限執行階段的權杖。產生 keyring 密碼並貼到 GOG_KEYRING_PASSWORD：

openssl rand -hex 32

不要提交此檔案。

這個 .env 檔案用於容器/執行環境環境變數，例如 OPENCLAW_GATEWAY_TOKEN。 已儲存的提供者 OAuth/API 金鑰驗證資訊位於掛載的 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json。

Docker Compose 設定

建立或更新 docker-compose.yml。

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # Recommended: keep the Gateway loopback-only on the VPS; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]

--allow-unconfigured 只為了方便初始啟動，不能取代正確的 gateway 設定。仍請設定驗證（gateway.auth.token 或密碼），並為你的部署使用安全的綁定位址設定。

共用 Docker VM 執行環境步驟

使用共用執行環境指南完成一般 Docker 主機流程：

• 將必要二進位檔內建到映像檔
• 建置並啟動
• 哪些內容會在哪裡保留
• 更新

Hetzner 專用存取方式

完成共用建置與啟動步驟後，請完成以下設定以開啟通道：

先決條件： 確保你的 VPS sshd 設定允許 TCP 轉送。如果你 已強化 SSH 設定，請檢查 /etc/ssh/sshd_config 並設定：

AllowTcpForwarding local

local 允許從你的筆電使用 ssh -L 進行本機轉送，同時阻擋 來自伺服器的遠端轉送。將其設為 no 會導致通道失敗，並顯示： channel 3: open failed: administratively prohibited: open failed

確認已啟用 TCP 轉送後，重新啟動 SSH 服務 (systemctl restart ssh)，並從你的筆電執行通道：

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

開啟：

http://127.0.0.1:18789/

貼上已設定的共享密鑰。本指南預設使用 gateway 權杖；如果你改用密碼驗證，請改用該密碼。