Docker 虛擬機器執行階段

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

​

將必要的二進位檔建置到映像檔中

在執行中的容器內安裝二進位檔是一個陷阱：執行階段安裝的任何項目都會在重新啟動後遺失。請在建置時，將 Skills 所需的每個外部二進位檔建置到映像檔中。

以下範例僅涵蓋三個二進位檔，依字母順序排列：

• gog（來自 gogcli），用於存取 Gmail
• goplaces，用於 Google Places
• wacli，用於 WhatsApp

這些只是範例，並非完整清單。請使用相同模式，安裝 Skills 所需的所有二進位檔。之後新增需要新二進位檔的 Skill 時：

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

Dockerfile 範例

FROM node:24-bookworm

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

# 範例二進位檔 1：Gmail 命令列介面（gogcli — 安裝為 `gog`）
# 從 https://github.com/steipete/gogcli/releases 複製目前的 Linux 資產 URL
RUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \
  | tar -xzO gog > /usr/local/bin/gog; \
  chmod +x /usr/local/bin/gog

# 範例二進位檔 2：Google Places 命令列介面
# 從 https://github.com/steipete/goplaces/releases 複製目前的 Linux 資產 URL
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \
  | tar -xzO goplaces > /usr/local/bin/goplaces; \
  chmod +x /usr/local/bin/goplaces

# 範例二進位檔 3：WhatsApp 命令列介面
# 從 https://github.com/steipete/wacli/releases 複製目前的 Linux 資產 URL
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \
  | tar -xzO wacli > /usr/local/bin/wacli; \
  chmod +x /usr/local/bin/wacli

# 使用相同模式在下方新增更多二進位檔

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"]

以上 URL 僅為範例。對於 ARM 架構的 VM，請選擇 arm64 資產。若要確保建置結果可重現，請釘選包含版本的發行版 URL。

​

建置並啟動

docker compose build
docker compose up -d openclaw-gateway

如果建置在 pnpm install --frozen-lockfile 期間因 Killed 或結束代碼 137 而失敗，表示 VM 記憶體不足。請改用更大的機器類別後再重試。

驗證二進位檔：

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

驗證閘道已啟動：

docker compose logs -f openclaw-gateway
curl -fsS http://127.0.0.1:18789/healthz

/healthz 傳回 200 回應，即表示閘道程序正在監聽且狀態正常；內建映像檔的 HEALTHCHECK 會輪詢相同的端點。

​

各項資料的持久化位置

OpenClaw 在 Docker 中執行，但 Docker 並非事實來源。所有長期狀態都必須在重新啟動、重新建置和重新開機後保留。

元件	位置	持久化機制	備註
閘道設定	/home/node/.openclaw/	主機磁碟區掛載	包含 openclaw.json
頻道／供應商認證資訊	/home/node/.openclaw/credentials/	主機磁碟區掛載	頻道與供應商的認證資訊資料
模型驗證設定檔	/home/node/.openclaw/agents/	主機磁碟區掛載	agents/<agentId>/agent/auth-profiles.json（OAuth、API 金鑰）
舊版 OAuth 金鑰檔案	/home/node/.config/openclaw/	主機磁碟區掛載	為移轉前的 OAuth 側載檔提供唯讀相容性；openclaw doctor --fix 會將其移轉至 auth-profiles.json
Skill 設定	/home/node/.openclaw/skills/	主機磁碟區掛載	Skill 層級狀態
代理程式工作區	/home/node/.openclaw/workspace/	主機磁碟區掛載	程式碼與代理程式成品
WhatsApp 工作階段	/home/node/.openclaw/	主機磁碟區掛載	保留 QR 登入狀態
Gmail 鑰匙圈	/home/node/.openclaw/	主機磁碟區 + 密碼	需要 GOG_KEYRING_PASSWORD
外掛套件	/home/node/.openclaw/npm、/home/node/.openclaw/git	主機磁碟區掛載	可下載的外掛套件根目錄
外部二進位檔	/usr/local/bin/	Docker 映像檔	必須在建置時建置到映像檔中
節點執行階段	容器檔案系統	Docker 映像檔	每次建置映像檔時都會重新建置
作業系統套件	容器檔案系統	Docker 映像檔	請勿在執行階段安裝
Docker 容器	暫時性	可重新啟動	可安全銷毀

​

更新

若要更新 VM 上的 OpenClaw：

git pull
docker compose build
docker compose up -d

​

相關內容

• Docker
• Podman
• ClawDock