Skip to content
OpenClaw Docs

Docker VM 執行階段

Docker VM 執行階段

Section titled “Docker VM 執行階段”

適用於基於 VM 的 Docker 安裝（例如 GCP、Hetzner 和類似的 VPS 提供商）的共用執行階段步驟。

將所需的二進位檔案內建到映像檔中

Section titled “將所需的二進位檔案內建到映像檔中”

在運行中的容器內安裝二進位檔案是個陷阱。 任何在執行階段安裝的內容都會在重啟後遺失。

技能所需的所有外部二進位檔案都必須在建構映像檔時進行安裝。

以下範例僅顯示三種常見的二進位檔案：

  • gog 用於 Gmail 存取
  • goplaces 用於 Google Places
  • wacli 用於 WhatsApp

這些只是範例，並非完整清單。 您可以使用相同的模式安裝任意數量的二進位檔案。

如果您稍後新增依賴其他二進位檔案的新技能，您必須：

  1. 更新 Dockerfile
  2. 重新建構映像檔
  3. 重新啟動容器

範例 Dockerfile

FROM node:24-bookworm


RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*


# Example binary 1: Gmail CLI
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog


# Example binary 2: Google Places CLI
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces


# Example binary 3: WhatsApp CLI
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/wacli


# Add more binaries below using the same pattern


WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts


RUN corepack enable
RUN pnpm install --frozen-lockfile


COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build


ENV NODE_ENV=production


CMD ["node","dist/index.js"]

建構與啟動

Section titled “建構與啟動”
Terminal window
docker compose build
docker compose up -d openclaw-gateway

如果在 pnpm install --frozen-lockfile 期間建構失敗並顯示 Killed 或 exit code 137，表示 VM 記憶體不足。 重試前請使用更大的機器規格。

驗證二進位檔案：

Terminal window
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli

預期輸出：

/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli

驗證 Gateway：

Terminal window
docker compose logs -f openclaw-gateway

預期輸出：

[gateway] listening on ws://0.0.0.0:18789

什麼會持續存在

Section titled “什麼會持續存在”

OpenClaw 在 Docker 中運行，但 Docker 並非事實來源 (source of truth)。 所有長期存在的狀態必須在重啟、重新建構和重新開機後仍然存在。

組件位置持續性機制備註
Gateway 設定/home/node/.openclaw/主機磁碟區掛載包含 openclaw.json、權杖
模型驗證設定檔/home/node/.openclaw/主機磁碟區掛載OAuth 權杖、API 金鑰
技能設定/home/node/.openclaw/skills/主機磁碟區掛載技能層級狀態
代理工作區/home/node/.openclaw/workspace/主機磁碟區掛載程式碼和代理產生檔案
WhatsApp 工作階段/home/node/.openclaw/主機磁碟區掛載保留 QR 登入
Gmail 鑰匙圈/home/node/.openclaw/主機卷 + 密碼需要 GOG_KEYRING_PASSWORD
外部二進位檔案/usr/local/bin/Docker 映像檔必須在建置時 baked
Node 執行環境容器檔案系統Docker 映像檔每次建置映像檔時重建
OS 套件容器檔案系統Docker 映像檔不要在執行時安裝
Docker 容器暫時性可重新啟動可安全銷毀

更新

Section titled “更新”

若要更新 VM 上的 OpenClaw：

Terminal window
git pull
docker compose build
docker compose up -d