OpenClawSkills
GitHub
デプロイ • 6分で読める

Docker デプロイ

サーバーおよびローカルマシン上で OpenClaw をコンテナ化するためのプロフェッショナルなデプロイガイド。

公式イメージ

公式イメージは <code>ghcr.io/openclaw/openclaw:latest</code> で入手できます。ブラウザ自動化とゲートウェイサービスに必要なすべての依存関係が含まれています。
Tutorial.step

クイックスタート

クイックな一時セッションの場合、最小限のフラグでコンテナを直接実行します：

Terminal
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest \
  openclaw gateway
Tutorial.step

Docker Compose (Recommended)

本番環境と長期使用の場合、Docker Compose は OpenClaw インスタンスを管理する標準的な方法です。

docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789" # Gateway
      - "18793:18793" # Canvas Host (Optional)
    volumes:
      - ~/.openclaw:/root/.openclaw # Configuration & Workspace
    environment:
      - NODE_ENV=production
    command: openclaw gateway
Tutorial.step

ボリュームの永続化

重要：データ損失の防止

これらのボリュームをマウントしない場合、エージェントはコンテナが再起動するたびに個性、設定、記憶を失います。
~/.openclaw

openclaw.json、暗号化キー、チャネル認証情報を保存します。

~/.openclaw/workspace

ワークスペース。Markdown 記憶、SOUL、カスタムスキルが含まれます。

Tutorial.step

高度な環境変数

  • PORT：内部ゲートウェイポートを上書きします。
  • OPENCLAW_CONFIG_PATH：コンテナ内の設定へのパス。
  • OPENCLAW_GATEWAY_TOKEN：ゲートウェイの静的認証トークンを強制します。
Tutorial.step

Unraid および NAS 設定

Unraid または Synology にデプロイする場合、パスを appdata 共有にマップしてください：

  • 設定パス：/mnt/user/appdata/openclaw/config は /root/.openclaw にマップされます
  • データパス：/mnt/user/appdata/openclaw/workspace は /root/.openclaw/workspace にマップされます
Tutorial.step

トラブルシューティング

ログとヘルス

Terminal
docker logs -f openclaw

Error: listen EADDRINUSE が表示される場合、別のプロセスがポート 18789 を使用しています。compose ファイルのホストポートマッピングを "18790:18789" に変更してください。

アーキテクチャの深さ

Docker がエージェントループとどのように対話するかを学びます。

次へ：アーキテクチャ