1. なぜ Docker で OpenClaw をデプロイするか
本番では再現性、スケール、ロールバックが求められます。Docker イメージで OpenClaw と依存関係を固め、Compose で一括起動・ネット・ストレージを統一できます。ホスト直接実行よりリソース制限・ヘルスチェック・ログ収集が容易で、2026 年の運用慣行に合います。
2. ワンクリックスクリプトと Docker Compose の 5 ステップ
ステップ 1: Docker と Docker Compose をインストール。Mac は Docker Desktop または Colima、Linux は Docker Engine と compose プラグイン。
ステップ 2: 公式またはコミュニティの OpenClaw Docker イメージと compose サンプルを取得、または公式ドキュメントに従いワンクリックスクリプトを実行。
ステップ 3: 環境変数(API キー、ポート、データディレクトリ)を .env または compose の environment に設定。シークレットはリポジトリにコミットしないこと。
ステップ 4: docker compose up -d で起動し、docker compose ps と docker compose logs -f で確認。
ステップ 5: 設定したポート(例 18789)でコンソールにアクセスし、本番向けに監視とセキュリティを追加。
3. 本番設定の要点(リソース・ネット・ストレージ)
| 項目 | 推奨 |
|---|---|
| メモリ/CPU | compose で OpenClaw サービスに mem_limit、cpus を設定 |
| 再起動 | restart: unless-stopped または always |
| データ | 設定・データディレクトリを volume でマウント |
| ネットワーク | リバースプロキシ(Nginx/Caddy)の背後に配置し、443 のみ公開 |
4. 監視とアラート
compose で healthcheck を設定(例:コンソールポートへの HTTP プローブ)。ログは docker compose logs または集中ログへ。Prometheus や簡易死活・ポート監視で異常時にアラート。
5. セキュリティ強化
| 項目 | 対応 |
|---|---|
| シークレット | 環境変数またはシークレット管理で注入、イメージ・compose に平文で書かない |
| ユーザ | コンテナ内は非 root で実行(イメージが対応している場合) |
| ネットワーク | 不要なポートを公開しない。本番はリバースプロキシ + HTTPS、必要に応じて IP 制限 |
| イメージ | タグを固定し、Trivy 等でスキャン、定期更新 |
6. バックアップとリストア
マウントした volume と .env(マスク済み)を cron で定期バックアップ。リストア時は新ホストに Docker/Compose を入れ、volume と設定を復元して docker compose up -d。
7. よくある本番トラブルと対処
| 症状 | 想定原因 | 対処 |
|---|---|---|
| コンテナが繰り返し再起動 | OOM、ヘルスチェック失敗、依存未就緒 | ログ確認、メモリ増やすか healthcheck タイムアウト緩和 |
| コンソールに到達できない | ファイアウォール、プロキシ設定、ポート未リッスン | ポートとセキュリティグループ、プロキシ設定を確認 |
| タイムアウトや遅延 | リソース不足、ネットまたは API 制限 | メトリクスとログを確認し、スケールまたは制限調整 |
参照パラメータ(2026 年):
- OpenClaw 単体は少なくとも 2GB メモリ・1 CPU。高負荷時は水平スケール + ロードバランサ。
- 本番ではイメージをバージョンタグで固定し、latest は避ける。
- バックアップは少なくとも日次、7 日分保持。重要環境は頻度・保持期間を増やす。
8. 本番 OpenClaw がリモート Mac に向く理由
Docker 化した OpenClaw は Docker が動く Linux や Mac で動作します。リモート Mac にデプロイすれば、同じ Metal/統一メモリ環境を共有でき、データセンターの電源・冷却で 24/7 安定稼働が期待できます。本番級の安定性と Mac エコシステムを両立したいチームは、MACGPU のリモート Mac で同じ Docker Compose を動かせば、物理ホストの運用を減らしつつ従量課金でスケールできます。
すでにローカルや Linux で OpenClaw Docker を動かしているが、可用性を高め運用を減らしたい場合は、本番インスタンスを MACGPU のリモート Mac に移行してください。同じ Compose とイメージで、Mac 上で 24/7 安定稼働できます。
