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

ブートストラップは、新しいエージェントワークスペースの初期データを作成し、エージェントがアイデンティティを選択できるよう案内する初回実行時の手順です。オンボーディングの直後、エージェントの最初の実際のターンで一度だけ実行されます。

実行内容

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

• AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md の初期データを作成します。
• エージェントに、最大 3 段階の誕生シーケンスを実行させます。エージェントの呼び名を尋ね、短い個性や雰囲気を表す一文を伝えた後、推奨される最小限の Plugin セットと、利便性を最大限に高めるセットのどちらを希望するか尋ねます。
• 合意したアイデンティティを 2 か所に保存します。IDENTITY.md と SOUL.md（エージェントが自身について読み取る情報）、および openclaw agents set-identity（チャンネルと UI に表示される情報）です。
• オンボーディング中にすでに保存されたアプリの推奨事項を、再スキャンせずに読み取ります。公式 Plugin には openclaw plugins install <id> を使用します。サードパーティー製 ClawHub Skills は、明示的なオプトインのままです。選択の処理後、エージェントは保存された提案を確認済みにし、二度と尋ねないようにします。
• ワークスペースが設定済みと判断されると BOOTSTRAP.md を削除し、この手順が一度だけ実行されるようにします。

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

組み込みモデルおよびローカルモデルでの実行

組み込みモデルまたはローカルモデルで実行する場合、OpenClaw は BOOTSTRAP.md を特権システムコンテキストに含めません。主要な対話形式の初回実行では、引き続きユーザープロンプトを通じてファイルの内容を渡すため、read ツールを確実に呼び出せないモデルでも、この手順を完了できます。現在の実行でワークスペースに安全にアクセスできない場合、エージェントには一般的な挨拶ではなく、短い制限付きブートストラップの注記が渡されます。

ブートストラップをスキップする

事前に初期データが作成されたワークスペースでこの処理をスキップするには、次を実行します。

openclaw onboard --skip-bootstrap

実行場所

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

関連ドキュメント

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