メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

GCP、Hetzner、および類似の VPS プロバイダーなど、VM ベースの Docker インストール向けの共有ランタイム手順。

​
必須バイナリをイメージに焼き込む

実行中のコンテナ内でバイナリをインストールするのは落とし穴です。 ランタイムでインストールされたものは、再起動時に失われます。 Skillsが必要とするすべての外部バイナリは、イメージのビルド時にインストールする必要があります。 以下の例では、一般的な 3 つのバイナリのみを示します。
  • Gmail アクセス用の gog（gogcli から）
  • Google Places 用の goplaces
  • WhatsApp 用の wacli
これらは例であり、完全な一覧ではありません。 同じパターンを使って、必要なだけバイナリをインストールできます。 後で追加のバイナリに依存する新しい Skills を追加する場合は、次を行う必要があります。
  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 (gogcli — installs as `gog`)
# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releases
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

# Example binary 2: Google Places CLI
# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releases
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

# Example binary 3: WhatsApp CLI
# Copy the current Linux asset URL from https://github.com/steipete/wacli/releases
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

# 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"]
上記の URL は例です。ARM ベースの VM では、arm64 アセットを選択してください。再現可能なビルドには、バージョン付きリリース URL を固定してください。

​
ビルドして起動する

docker compose build
docker compose up -d openclaw-gateway
pnpm install --frozen-lockfile の実行中に Killed または exit code 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
Gateway を検証します。 
docker compose logs -f openclaw-gateway
期待される出力: 
[gateway] listening on ws://0.0.0.0:18789

​
何がどこに永続化されるか

OpenClaw は Docker 内で実行されますが、Docker は信頼できる唯一の情報源ではありません。 すべての長期状態は、再起動、再ビルド、リブートをまたいで保持される必要があります。
コンポーネント場所永続化メカニズム備考
Gateway 設定/home/node/.openclaw/ホストボリュームマウントopenclaw.json、.env を含む
モデル認証プロファイル/home/node/.openclaw/agents/ホストボリュームマウントagents/<agentId>/agent/auth-profiles.json（OAuth、API キー）
認証プロファイルキー/home/node/.config/openclaw/ホストボリュームマウントOAuth 認証プロファイルのトークン素材用ローカル暗号化キー
Skill 設定/home/node/.openclaw/skills/ホストボリュームマウントSkill レベルの状態
エージェントワークスペース/home/node/.openclaw/workspace/ホストボリュームマウントコードとエージェント成果物
WhatsApp セッション/home/node/.openclaw/ホストボリュームマウントQR ログインを保持
Gmail キーリング/home/node/.openclaw/ホストボリューム + パスワードGOG_KEYRING_PASSWORD が必要
Plugin パッケージ/home/node/.openclaw/npm, /home/node/.openclaw/gitホストボリュームマウントダウンロード可能な Plugin パッケージルート
外部バイナリ/usr/local/bin/Docker イメージビルド時に焼き込む必要がある
Node ランタイムコンテナファイルシステムDocker イメージイメージビルドごとに再ビルドされる
OS パッケージコンテナファイルシステムDocker イメージランタイムでインストールしない
Docker コンテナ一時的再起動可能破棄しても安全

​
更新

VM 上の OpenClaw を更新するには: 
git pull
docker compose build
docker compose up -d

​
関連