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

​
何が起こるか

まったく新しいワークスペース（デフォルトは ~/.openclaw/workspace）での初回実行時に、OpenClaw は次を行います。
  • AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md を配置します。
  • エージェントに BOOTSTRAP.md に従わせます。これは、名前、性格、雰囲気を決めるための自由形式の会話（固定の Q&A フォームではありません）です。
  • 学習した内容を IDENTITY.md、USER.md、SOUL.md に書き込みます。
  • ワークスペースが設定済みに見えたら BOOTSTRAP.md を削除し、この手順が一度だけ実行されるようにします。
SOUL.md、IDENTITY.md、または USER.md がスターターテンプレートから変化しているか、memory/ フォルダーが存在する場合、ワークスペースは設定済みと見なされます。
BOOTSTRAP.md はアイデンティティに関する会話全体を扱います。内容は BOOTSTRAP.md テンプレート を参照してください。

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

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

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

事前に初期化済みのワークスペースでこれをスキップするには、次を実行します。 
openclaw onboard --skip-bootstrap

​
実行場所

ブートストラップは常に Gateway ホスト上で実行されます。macOS アプリがリモート Gateway に接続している場合、ワークスペースとそのブートストラップファイルは Mac ではなく、そのリモートマシン上にあります。
Gateway が別のマシンで実行されている場合は、Gateway ホスト上でワークスペースファイルを編集してください（例: user@gateway-host:~/.openclaw/workspace）。

​
関連ドキュメント