coollabsio/openclaw

解決する課題

OpenClaw エージェントゲートウェイを本番環境で実行するのは手間がかかります。リバースプロキシ、Web インターフェース、ブラウザセッションを共有する方法、永続ストレージ、そして安全なサンドボックス環境が必要です。このプロジェクトは、これらすべてを単一の Docker イメージと compose ファイルにパッケージ化しているため、ゲートウェイを立ち上げ、ブラウザや Mac アプリをペアリングし、更新後もデータを保持することができます。

仕組み

このイメージは、環境変数を読み取り、openclaw.json 設定を書き込み、doctor --fix を実行し、8080 ポートで nginx をリバースプロキシとして起動し、ゲートウェイプロセス（内部で 18789 ポートをリッスン）を起動するエントリーポイントスクリプトを実行します。nginx は UI と WebSocket の HTTP 基本認証を処理し、認証なしで /healthz を転送します。/data の永続ボリュームには、設定、チャット履歴、ペアリングされたデバイス、ワークスペースが保存されます。docker compose で起動可能なオプションのブラウザサイドカー (CDP + VNC) を使用すると、OAuth/2FA が必要なサイトにログインでき、ゲートウェイは CDP を介してそのセッションを再利用します。ツール実行は、ホストの Docker ソケットをマウントしてゲートウェイが兄弟コンテナを作成できるようにすることでサンドボックス化できます。README では、これがコンテナにホストの root 権限を与えることに注意するよう強調されています。

対象ユーザー

OpenClaw AI エージェントゲートウェイをセルフホストしたいすべての方。単純な docker run による単一コンテナ構成、ブラウザサイドカーと webhook を含む完全な docker compose セットアップ、または Coolify デプロイのいずれにも対応しています。また、接続先のリモートゲートウェイを必要とする OpenClaw Mac アプリユーザーにも最適です。

ハイライト

• 単一コンテナの docker run による最小構成。docker compose でブラウザサイドカーと webhook フックを追加可能。
• 基本認証、ヘルスチェックエンドポイント、許可されたオリジンの設定が可能な nginx リバースプロキシ。
• 多くの AI プロバイダー（Anthropic, OpenAI, Gemini, DeepSeek など）に対応した環境変数設定と、自動的なプライマリモデル選択。
• 永続的な /data ボリュームにより、コンテナ再作成後も認証情報、ペアリング、履歴、ワークスペースを保持。
• 初回ログイン時のデバイス承認：openclaw devices list と openclaw devices approve を使用してブラウザや Mac アプリを承認。
• ツール実行用の兄弟コンテナを起動するためのオプションの Docker ソケットサンドボックス化（セキュリティ上の影響に関する明確な警告付き）。
• GitHub Actions による自動イメージビルドと Docker Hub への新バージョン公開、および Coolify での簡単な更新手順。