エージェントのブートストラップ

ブートストラップは、新しいエージェントワークスペースに初期ファイルを配置し、エージェントがアイデンティティを選択する手順を案内する初回実行時の儀式です。オンボーディングの直後、エージェントが初めて実際に応答する際に一度だけ実行されます。

実行される処理

まったく新しいワークスペース（デフォルトは ~/.openclaw/workspace）で初めて実行すると、OpenClaw は次の処理を行います。

• AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md を初期配置します。
• エージェントに BOOTSTRAP.md の手順に従わせ、自由形式の会話（固定された一問一答形式ではありません）を通じて、名前、性格、雰囲気を決定します。
• 会話から得た情報を IDENTITY.md、USER.md、SOUL.md に書き込みます。
• ワークスペースの設定が完了したと判断されると BOOTSTRAP.md を削除し、この儀式が一度だけ実行されるようにします。

SOUL.md、IDENTITY.md、USER.md のいずれかが初期テンプレートから変更されているか、memory/ フォルダーが存在すると、ワークスペースは設定済みとみなされます。

組み込みモデルとローカルモデルでの実行

組み込みモデルまたはローカルモデルで実行する場合、OpenClaw は BOOTSTRAP.md を特権システムコンテキストに含めません。ただし、主要な対話型の初回実行では、ファイルの内容をユーザープロンプト経由で渡します。そのため、read ツールを確実に呼び出せないモデルでも、この儀式を完了できます。現在の実行環境からワークスペースへ安全にアクセスできない場合、エージェントは一般的な挨拶の代わりに、短い制限付きブートストラップの注記を受け取ります。

ブートストラップのスキップ

事前に初期ファイルを配置したワークスペースでこの処理をスキップするには、次を実行します。

openclaw onboard --skip-bootstrap

実行場所

ブートストラップは常に Gateway ホスト上で実行されます。macOS アプリがリモート Gateway に接続する場合、ワークスペースとそのブートストラップファイルは Mac ではなく、そのリモートマシン上に置かれます。

関連ドキュメント

• macOS アプリのオンボーディング：オンボーディング
• ワークスペースの構成：エージェントワークスペース
• テンプレートの内容：BOOTSTRAP.md テンプレート