1. 全体概要とアーキテクチャ

プロジェクトの全体像

OpenClawは「パーソナルAIアシスタント」を自分のデバイスで動かすためのプロダクトです。 WhatsApp、Telegram、Discord、Slack、Signal、iMessageなど複数のメッセージングプラットフォームを統合し、 単一のAIエージェントとして動作します。

コアコンセプト

• Gateway — WebSocket + HTTPサーバーとして動作するコントロールプレーン。すべてのセッション、チャンネル、ツール、イベントを管理する
• PI Agent Runtime — プロセス内で動作するAIエージェントランタイム。LLM呼び出し、ツール実行、セッション管理を担う
• Channel Plugins — 各メッセージングプラットフォームへの接続を抽象化するプラグイン
• Memory System — セマンティック検索 + キーワード検索によるハイブリッドメモリ

ディレクトリ構造

主要なソースディレクトリとその役割：

エントリポイントと起動シーケンス

OpenClawの起動は以下のフローで進みます：

Step 1: CLIエントリポイント

src/entry.ts がメインエントリポイントです。

1. process.title = "openclaw" でプロセス名を設定
2. 実験的警告の抑制チェック — 必要であればNode.jsフラグ付きで自身を再スポーン
3. CLIプロファイル引数の解析
4. import("./cli/run-main.js") で runCli() を動的インポート・実行

Step 2: CLI初期化

src/cli/run-main.ts の runCli() が次のフェーズを担います：

1. .env ファイルの読み込みと環境変数の正規化
2. 高速ルート：tryRouteCli() でコマンドが高速パスに該当するか確認
3. 通常ルート：Commander.js プログラムの構築
   • プライマリコマンドモジュールの遅延登録
   • 25以上のサブCLI（gateway, daemon, acp, cron 等）の遅延登録
   • プラグインCLIコマンドの登録
4. Commander によるコマンド解析・実行

Step 3: Gatewayサーバー起動

openclaw gateway run コマンドにより、 src/gateway/server.impl.ts の startGatewayServer() が呼ばれます。

設定システム

設定は src/config/ 以下で管理され、 主設定ファイルは ~/.openclaw/openclaw.json（JSON5形式）です。

設定の読み込みフロー

1. JSON5ファイルの読み込み
2. 環境変数の置換（${ENV_VAR}形式）
3. Config includesの適用（組み合わせ可能な設定）
4. 環境変数オーバーライド
5. マージパッチの適用
6. デフォルト値の適用
7. パス正規化
8. シェル環境からのAPIキーフォールバック
9. Zodスキーマによるバリデーション

主な設定パス

依存性注入パターン

OpenClawは createDefaultDeps()（src/cli/deps.ts） を中心とした依存性注入パターンを採用しています。

• 遅延モジュール読み込み — コマンド、チャンネル、プラグインすべてが動的 import() を使い、起動時間を最小化
• ファクトリ + DI — createDefaultDeps()、createProcessSupervisor()、createProgramContext() パターン
• マルチプラットフォーム抽象化 — GatewayService インターフェースでmacOS/Linux/Windowsを統一的に扱う

デーモン / サービスレイヤー

src/daemon/service.ts の resolveGatewayService() が プラットフォーム固有のサービス管理を提供します：

プロセス監視

src/process/supervisor/supervisor.ts の createProcessSupervisor() が プロセスの生成・監視を管理します。2つのスポーンモードがあります：

• child — 標準の child_process.spawn（非対話的コマンド用）
• pty — node-pty による擬似端末（対話的シェルコマンド用）

機能：スコープベースのキャンセル、全体タイムアウト、無出力タイムアウト、stdout/stderrキャプチャ、PID追跡、状態マシン（starting → running → exiting → finalized）。

デフォルト設定

src/agents/defaults.ts で定義されるデフォルト値：