CI 利用者・リモート Mac で OpenClaw を動かしたい開発者向けに、Docker の前提条件、クローン・docker-setup、.env と openclaw.json の設定、起動・検証、GitHub Actions 等の CI 連携まで再現可能な手順でまとめます。
前提条件と環境
以下を満たしていることを確認してください。
- Mac： Apple Silicon または Intel、macOS 12 以上推奨。
- メモリ： 8GB 以上（16GB 推奨）。
- ディスク： 20GB 以上の空き。
- Docker： Docker Desktop を入れ、
docker/docker composeが使える状態に。
Docker デプロイ手順
リポジトリをクローンし、docker-setup でコンテナを構築します。
-
1
クローン。
git clone https://github.com/your-org/openclaw.gitでリポジトリを取得し、cd openclawでディレクトリへ移動します。 -
2
docker-setup 実行。 プロジェクト付属の
./docker-setup（またはdocker compose build）を実行し、イメージをビルドします。 -
3
.env。 ルートに
.envを作成し、OPENAI_API_KEY=sk-...、OPENCLAW_GATEWAY_URL=http://localhost:8080等を記述。 -
4
openclaw.json。 モデル・エンドポイントを記載。Kilo Gateway の場合は gateway URL とモデル ID を合わせる。
-
5
起動・検証。
docker compose up -dで起動し、openclaw status/openclaw doctorで確認。必要なら curl でヘルスチェック。
ゲートウェイとモデル設定
openclaw.json ではゲートウェイ URL とモデル ID を正しく指定してください。Kilo Gateway なら複数モデル切り替えやレート制限緩和が可能です。
- gateway の base URL を .env と一致させる
- model フィールドに gpt-4o 等を指定。CI からは同一ネットワークか公開 URL でアクセス可能に
CI から OpenClaw を呼び出す
GitHub Actions や自前スクリプトから OpenClaw を呼び出す方法です。
- GitHub Actions： リモート Mac を self-hosted runner にし、ジョブで
openclaw run ...や API を呼びます。Secrets に API キー、OPENCLAW_GATEWAY_URLを runner の URL に設定。 - スクリプト：
curl -X POST ...や CLI をシェルで実行し、CI の一ステップに。タイムアウト・リトライを入れると安定します。
よくあるエラーとトラブルシュート
- 接続拒否： コンテナが起動しているか
docker compose psで確認し、ポートがホストにバインドされているか確認してください。 - 429 / レート制限： ゲートウェイ側の制限か、API キーの上限です。Kilo Gateway で複数キーをローテーションするか、minDelay を増やしてください。
- モデルが見つからない： openclaw.json の model ID がゲートウェイでサポートされているか、ドキュメントで確認してください。
まとめと次の一歩
前提条件から Docker デプロイ・設定・起動・検証・CI 連携まで押さえると、リモート Mac 上で OpenClaw を再現可能に運用できます。