「openclaw bootstrap pending」という状態が続いてエージェントが動かない、アップグレードしたら急にbootstrap pendingが表示されるようになった……そんな悩みを抱えている人は少なくない。本記事では、OpenClawのブートストラップ処理がなぜpending状態になるのか、その仕組みから実際のバグ事例、具体的な解決コマンドまで、情報を徹底的に調べてわかりやすくまとめた。

OpenClawは2026年に急速に普及したオープンソースのAIエージェントフレームワークで、GitHubのスター数が37万5千を超えるほどのプロジェクトだ。その内部では「BOOTSTRAP.md」と呼ばれる初回設定ファイルが、エージェントのワークスペース準備を担っている。この仕組みが正しく動作しないと、エージェントが応答しない・繰り返し初期化ループに入る・別人格で起動するといった問題が発生する。本記事を読めば、bootstrap pendingの原因を正確に把握し、状況に合った解決策をすぐに実行できるようになる。

この記事のポイント
✅ openclaw bootstrap pendingが何を意味するのか、仕組みから理解できる
✅ アップグレード後やControl UI/TUI使用時に起きるバグの内容と対処法がわかる
✅ openclaw doctorやBOOTSTRAP.md削除など、状況別の解決コマンドを把握できる
✅ Windows・WSL2環境を含むプラットフォーム別の注意点も確認できる
今日のセールをまとめてチェック！
本日のセール・タイムセールをまとめてチェックできます。
＼最大7.5%ポイントアップ！／
Amazon
＼楽天ポイント4倍セール！／
楽天市場
Yahooショッピング
メルカリ

openclaw bootstrap pendingの原因と基本知識

openclaw bootstrap pendingの原因と基本知識
  1. openclaw bootstrap pendingとは何かを解説
  2. bootstrap pendingが表示される主な原因は3つ
  3. BOOTSTRAP.mdの役割はエージェント初回設定の儀式
  4. Clawdbot bootstrap時代から続く仕組みの変遷
  5. アップグレード後にbootstrap pendingが起きやすい理由
  6. 正常なbootstrap pendingと異常なbootstrap pendingの違い

openclaw bootstrap pendingとは何かを解説

【AI】【業務効率化】【職場】openclaw bootstrap pendingとは何かを解説

「openclaw bootstrap pending」とは、OpenClawのエージェントがワークスペースの初期設定処理（ブートストラップ）を完了していない、または完了中であることを示す状態を指す。ログに「Agent bootstrap pending」と表示される場合、通常は10〜30秒で自動的に完了する初期化処理が進行中であることを意味している。

「Agent bootstrap pending — Agent is initializing. Wait for completion, usually takes 10-30 seconds」

出典: https://www.meta-intelligence.tech/en/insight-openclaw-troubleshooting

しかし、この状態が長時間続く場合や、一度解決したはずのbootstrap pendingが繰り返し発生する場合は、何らかの問題が起きていると考えてよい。特に、バージョンアップ後・サブエージェント起動時・Control UI/TUIからの接続時に問題が集中していることが、GitHub Issuesの報告から確認できた。

🔍 bootstrap pendingが発生する主な状況

状況 説明
初回起動時 正常な動作。10〜30秒で完了するのが通常
アップグレード後 BOOTSTRAP.mdの優先順位が変わりSOUL.mdより先に読まれるバグが発生することがある
サブエージェント起動時 古いBOOTSTRAP.mdが残っていると誤って実行される
Control UI / TUI使用時 完了済みでもfalseのbootstrap pendingラッパーが注入されるバグが確認されている

重要なのは、「bootstrap pending＝必ず異常」ではないという点だ。ログを見て10〜30秒待っても状況が変わらない、または特定の操作をした後にのみ再現するという場合に限り、次の診断ステップに進む必要がある。

bootstrap pendingが表示される主な原因は3つ

【AI】【業務効率化】【職場】bootstrap pendingが表示される主な原因は3つ

調査した情報をもとに整理すると、bootstrap pendingが解消しない場合の原因は大きく3つに分類できる。それぞれの原因を理解しておくことで、的外れな対処に時間を浪費することを防げる。

原因①：BOOTSTRAP.mdが残存している（削除されるべきなのに残っている）

OpenClawの仕様では、BOOTSTRAP.mdは初回起動が完了した時点で自動的に削除される。しかし、何らかの理由でこのファイルが削除されないまま残ってしまうと、次回の起動時や別のエージェント起動時に再びブートストラップ処理が走ってしまう。

原因②：バージョンアップによるブートストラップ優先順位の変更

2026年4月21日のアップデート（バージョン2026.4.21）で、ブートストラップ処理の読み込み順序が変わったことがGitHub Issue #69994として報告されている。この変更により、サブエージェントのワークスペースに残っていたBOOTSTRAP.mdがSOUL.mdより先に読まれるようになり、エージェントが誤った初期化を行うようになった。

原因③：Control UI / TUIによる誤ったbootstrap pendingラッパーの注入

GitHub Issue #70840では、ワークスペースのBOOTSTRAP.mdに「bootstrap is complete（完了）」と明記されているにもかかわらず、Control UI/TUIが新しいセッションのたびに「Bootstrap pending」ラッパーをメッセージの冒頭に付け加えてしまうバグが報告されている。

📋 原因別の症状チェックリスト

原因 症状 対象バージョン
BOOTSTRAP.mdの残存 サブエージェントが毎回初期化される バージョン問わず
アップグレードによる優先順位変更 SOUL.mdではなくBOOTSTRAP.mdが読まれる 2026.4.21以降
Control UI/TUIのバグ 毎回のターンでbootstrap pendingが表示される 2026.4.21前後

3つの原因を把握した上で、自分の環境ではどれが当てはまるかを確認してから対処に移ると効率的だ。次のH3では、そもそもBOOTSTRAP.mdとは何かをより詳しく説明する。

BOOTSTRAP.mdの役割はエージェント初回設定の儀式

【AI】【業務効率化】【職場】BOOTSTRAP.mdの役割はエージェント初回設定の儀式

BOOTSTRAP.mdは、OpenClawのエージェントが初めて起動する際に実行される「初回起動の儀式（first-run ritual）」を制御するためのファイルだ。公式ドキュメントでは、このプロセスを”bootstrapping”と呼んでいる。

「Bootstrapping is the first-run ritual that prepares an agent workspace and collects identity details. It happens after onboarding, when the agent starts for the first time.」

出典: https://docs.openclaw.ai/start/bootstrapping

ブートストラップ処理が行うことは以下の通りだ。

🚀 BOOTSTRAP.mdが初回起動時に実行すること

ステップ 内容 結果
ステップ1 AGENTS.md・BOOTSTRAP.md・IDENTITY.md・USER.mdをワークスペースに配置 エージェントのワークスペースが整備される
ステップ2 一問一答の質問（Q&Aリチュアル）を実行 ユーザーの好みや設定を収集する
ステップ3 アイデンティティと好みをIDENTITY.md・USER.md・SOUL.mdに書き込む エージェントの性格と設定が永続化される
ステップ4 BOOTSTRAP.mdを削除 次回以降は実行されない（一度きりの処理）

特筆すべきは、BOOTSTRAP.mdが完了後に自動で削除される設計になっている点だ。これは「一度しか実行しない」ことを保証するための仕組みであり、逆に言えば「BOOTSTRAP.mdが残っている＝初回設定がまだ完了していない」というサインでもある。

また、公式ドキュメントによれば、組み込み/ローカルモデルの場合はBOOTSTRAP.mdを特権システムコンテキスト（privileged system context）から除外して処理する仕様になっており、モデルが読み取りツールを確実に呼び出せない場合でも儀式が完了できるよう、ユーザープロンプト内にファイル内容を渡す工夫がされているという。

ブートストラップは常にゲートウェイホスト上で実行される。macOSアプリがリモートGatewayに接続している場合、ワークスペースとブートストラップファイルはそのリモートマシン上に存在するため、ファイル編集はゲートウェイホスト側で行う必要がある点も覚えておきたい。

Clawdbot bootstrap時代から続く仕組みの変遷

【AI】【業務効率化】【職場】Clawdbot bootstrap時代から続く仕組みの変遷

OpenClawの前身となるプロジェクト「Clawdbot」は、2025年11月にオーストリアの開発者によって公開されたサイドプロジェクトだ。その後、2026年1月に「OpenClaw」と改名・オープンソース化され、GitHub上で爆発的な人気を集めた。

📅 OpenClawの発展タイムライン

時期 出来事 bootstrap機能への影響
2025年11月 「Clawdbot」としてプロジェクト公開 基本的なワークスペース管理の原型が登場
2026年1月 「OpenClaw」へ改名・オープンソース化 BOOTSTRAP.mdの仕組みが整備される
2026年2月 GitHubスター数247,000突破 エコシステム拡大、bootstrap関連バグが増加傾向
2026年3月 セキュリティ脆弱性（CVE）の報告が相次ぐ NanoClawなど安全重視の派生版が登場
2026年4月21日 バージョン2026.4.21リリース bootstrap優先順位のバグが混入（Issue #69994）
2026年4月22-23日 コミュニティで問題が多数報告 Issue #70840（UI誤注入バグ）も確認

Clawdbot時代から引き継がれたブートストラップの基本概念は、「エージェントに初回だけ自己紹介と設定確認をさせる」というシンプルなものだ。しかし、プロジェクトが急成長し、マルチエージェント・リモートGateway・複数チャネル対応などの機能が追加されるにつれて、ブートストラップ処理のコーナーケースが増えていった。

現在の「bootstrap pending」問題の多くは、こうした機能拡張によって複雑化したブートストラップ処理の辻褄が合わなくなる場面で発生しているとみられる。特にサブエージェントをスポーンする際の動作や、UIからの接続時のラッパー注入がバグの温床になっているようだ。

アップグレード後にbootstrap pendingが起きやすい理由

【AI】【業務効率化】【職場】アップグレード後にbootstrap pendingが起きやすい理由

バージョン2026.4.21へのアップグレード後に、bootstrap pendingの問題が急増したことがGitHubのIssueから確認できた。Issue #69994のレポートによれば、以下のような問題が再現した。

「After upgrading to 2026.4.21 (from an earlier version), subagent spawning started loading BOOTSTRAP.md from agent workspaces instead of SOUL.md. This had not occurred before the upgrade.」

出典: https://github.com/openclaw/openclaw/issues/69994

つまり、以前のバージョンでは問題なかったサブエージェントの起動が、アップグレードを境に「SOUL.mdではなくBOOTSTRAP.mdを読む」という誤った動作に切り替わってしまったということだ。

🔴 Issue #69994の詳細まとめ

項目 内容
影響バージョン 2026.4.21以降
対象OS macOS (Darwin 25.x, arm64)
使用モデル minimax2.7-highspeed
症状 SOUL.mdではなくBOOTSTRAP.mdが読み込まれる
確認された回避策 該当ワークスペースからBOOTSTRAP.mdを削除する

報告者によると、~/.openclaw/workspace-luke/にあったBOOTSTRAP.mdを削除したところ、直ちにLukeというエージェントが正常にSOUL.mdを読み込み、「Hi GT! Luke here!」という挨拶で応答するようになったとのこと。同様の問題はagent-miaのワークスペースでも確認されており、workspace-reconにも同様のBOOTSTRAP.mdが残っていて潜在的に影響する可能性があると指摘されていた。

アップグレードが原因でbootstrap pendingが発生している場合、根本原因は「ブートストラップ処理の優先順位・読み込み順序が変更されたこと」と「古いBOOTSTRAP.mdファイルが各ワークスペースに残存していること」の組み合わせだと理解しておこう。

正常なbootstrap pendingと異常なbootstrap pendingの違い

【AI】【業務効率化】【職場】正常なbootstrap pendingと異常なbootstrap pendingの違い

openclaw bootstrap pendingという表示が出た場合、まず最初に確認すべきは「それが正常な状態なのか異常な状態なのか」という判断だ。この区別ができるだけで、不必要な操作で問題を悪化させることを防げる。

✅ 正常なbootstrap pendingの特徴

特徴 詳細
表示のタイミング 初回起動時・openclaw onboard直後
継続時間 通常10〜30秒以内に自動完了
完了後の動作 BOOTSTRAP.mdが自動削除され通常動作に移行
再現性 同じワークスペースでは二度と発生しない

❌ 異常なbootstrap pendingの特徴

特徴 詳細
表示のタイミング 複数回・毎セッション・アップグレード後
継続時間 数分以上解消しない / Gatewayを再起動しても繰り返す
完了後の動作 エージェントがSOUL.mdではなくBOOTSTRAP.mdを参照し続ける
再現性 特定の操作（サブエージェント起動・UIからのアクセス）で繰り返す

判断のポイントをシンプルにまとめると、「初めての起動で30秒以内に完了する」なら正常であり、「複数回繰り返す・完了しない・アップグレード後に突然始まった」なら何らかの問題が起きていると判断してよい。次のH2ブロックでは、それぞれの問題に対する具体的な解決策を詳しく説明していく。

【AI】【業務効率化】【職場】正常なbootstrap pendingと異常なbootstrap pendingの違い
忘れる前に！【ふるさと納税】今年もお得に！
ふるさと納税のポイント付与は2025年10月に廃止になりました。
＼最大7.5%ポイントアップ！／
Amazon
＼楽天ポイント4倍セール！／
楽天市場
Yahooショッピング
メルカリ

openclaw bootstrap pendingを解決する具体的な対処法

【AI】【業務効率化】【職場】正常なbootstrap pendingと異常なbootstrap pendingの違い
  1. まずはopenclaw doctorコマンドで自動診断を実行すること
  2. BOOTSTRAP.mdを手動削除すればサブエージェント問題が解決する
  3. openclaw onboard –skip-bootstrapでbootstrap自体をスキップできる
  4. Gatewayを再起動してもpendingが続く場合の対処法
  5. Control UI/TUIが誤ってbootstrap pendingを注入するバグへの対応
  6. Windows・WSL2環境でのbootstrap pending特有の問題と解決策
  7. 総括：openclaw bootstrap pendingのまとめ

まずはopenclaw doctorコマンドで自動診断を実行すること

【AI】【業務効率化】【職場】まずはopenclaw doctorコマンドで自動診断を実行すること

openclaw bootstrap pendingの問題が発生した際、最初に実行すべきコマンドはopenclaw doctorだ。このコマンドはOpenClawに内蔵されたワンストップ診断ツールで、設定ファイルの構文・モデル認証の状態・Gatewayの接続状況・Node.jsのバージョン互換性を自動チェックし、赤・黄・緑のインジケーターで問題箇所を報告する。

「openclaw doctor is OpenClaw’s built-in one-stop diagnostic tool that automatically checks configuration file syntax, model authentication status, Gateway connectivity, and Node.js version compatibility.」

出典: https://www.meta-intelligence.tech/en/insight-openclaw-troubleshooting

基本的な診断コマンドとその役割を以下にまとめる。

🩺 openclaw doctorコマンド一覧

コマンド 役割 使用場面
openclaw doctor 総合的なヘルスチェック まず最初に実行する
openclaw doctor --fix 自動修復（設定バックアップ付き） 問題が検出された後
openclaw doctor --generate-gateway-token GatewayトークンのリセットI生成 接続認証エラーが出ている場合
openclaw status クレデンシャルとセッション状態の確認 認証関連の問題を疑う場合
openclaw logs --follow リアルタイムログの確認 問題の詳細を把握したい場合

openclaw doctor --fixを実行すると、修正前に~/.openclaw/openclaw.json.bakとしてバックアップが自動生成される。修正後は環境変数がプレーンテキストに展開されることがあるため、実行後に設定内容を確認することを推奨する。

bootstrap pendingが繰り返し発生する場合、openclaw doctorの出力に「bootstrap関連の警告」が含まれていることがある。特に「plugin load failed: dependency tree corrupted」や「provider 401s after re-auth」といったメッセージが出ている場合は、チャネル設定の問題やOAuthトークンの期限切れが間接的にbootstrap状態に影響している可能性がある。

診断ツールでも解決しない場合は、以下のコマンドで詳細なGatewayステータスを確認するとよい。

openclaw gateway status --deep
openclaw status --all

🔍 診断コマンドの実行順序（推奨手順）

順番 コマンド 期待する結果
1 openclaw status 認証・セッション状態の把握
2 openclaw gateway status Gateway稼働状況の確認
3 openclaw logs --follow リアルタイムエラーの特定
4 openclaw doctor 全体的な問題レポート
5 openclaw doctor --fix 自動修復の実行
6 openclaw gateway restart Gateway再起動で設定反映

公式トラブルシューティングドキュメントによると、openclaw doctor --fixは全般的な問題の80%以上を自動解決できるとされている。まずはこの手順を試してから次のステップに進むことを強く勧める。

BOOTSTRAP.mdを手動削除すればサブエージェント問題が解決する

【AI】【業務効率化】【職場】BOOTSTRAP.mdを手動削除すればサブエージェント問題が解決する

サブエージェント起動時にbootstrap pendingが繰り返し発生する場合、該当ワークスペース内のBOOTSTRAP.mdを手動削除することが最も直接的な解決策だ。この方法はGitHub Issue #69994の報告者が実際に試して即座に効果があったと確認した方法でもある。

通常、ワークスペースのパスは以下のようになっている。

デフォルトワークスペース: ~/.openclaw/workspace/
サブエージェントのワークスペース例: ~/.openclaw/workspace-luke/

📁 BOOTSTRAP.md削除の手順

ステップ コマンド / 操作 説明
1 ls ~/.openclaw/workspace-[エージェント名]/ 対象ワークスペースを確認
2 BOOTSTRAP.mdの存在を確認 ファイルが残っているか確認
3 rm ~/.openclaw/workspace-[エージェント名]/BOOTSTRAP.md ファイルを削除
4 エージェントを再起動 削除後に通常起動できるか確認
5 SOUL.mdが正常に読まれるか確認 挨拶や動作が期待通りか確認

注意点として、BOOTSTRAP.mdを削除する前に、そのワークスペースにSOUL.md・IDENTITY.md・USER.mdが正しく存在しているかを確認しておくことが重要だ。これらのファイルがない状態でBOOTSTRAP.mdだけ削除してしまうと、エージェントが起動時に参照すべきアイデンティティ情報を持てなくなる可能性がある。

⚠️ 削除前に確認すべきファイル一覧

ファイル名 役割 削除前に存在確認が必要か
SOUL.md エージェントの価値観・性格 ✅ 必須
IDENTITY.md エージェントの名前・ペルソナ ✅ 必須
USER.md ユーザーの情報・好み ✅ 推奨
MEMORY.md 長期記憶の管理 ✅ 推奨
BOOTSTRAP.md 初回設定（完了後は不要） 削除対象

また、複数のサブエージェントワークスペースに古いBOOTSTRAP.mdが残っている可能性がある場合は、一括で確認するコマンドを使うと効率的だ。ls ~/.openclaw/workspace-*/BOOTSTRAP.mdのように指定すれば、どのワークスペースにBOOTSTRAP.mdが残っているかを素早く確認できる（おそらく多くの環境でこの方法が有効と考えられるが、シェルの設定によって動作が異なることがある）。

openclaw onboard –skip-bootstrapでbootstrap自体をスキップできる

【AI】【業務効率化】【職場】openclaw onboard –skip-bootstrapでbootstrap自体をスキップできる

あらかじめSOUL.mdなどの設定ファイルを用意した「事前設定済みワークスペース（pre-seeded workspace）」を使っている場合、ブートストラップ処理自体をスキップする公式オプションが用意されている。

openclaw onboard --skip-bootstrap

このオプションを使うと、初回起動時のQ&Aリチュアルを省略し、既存の設定ファイルをそのまま使って通常運用に入ることができる。CI/CDパイプラインや、あらかじめ設定を決めておきたい本番環境での利用に特に有効だ。

🚀 skip-bootstrapが有効なケース

ケース 説明
事前設定済みワークスペース SOUL.md等を手動で作成済みの場合
自動化環境（CI/CD） 対話的なQ&Aが実行できない環境
bootstrap pendingが繰り返す環境 通常のbootstrapに問題がある場合の回避策
既存ワークスペースのコピー 設定を引き継いで別環境に展開する場合

ただし、--skip-bootstrapを使う場合はSOUL.md・IDENTITY.md・USER.mdがすべて揃っていることが前提になる。これらが存在しない状態でスキップすると、エージェントが適切な初期状態なしで起動することになり、別の問題が発生する可能性がある。公式ドキュメントでは、skip-bootstrapは「pre-seeded workspace向け」と明記されており、空のワークスペースに対して使用することは推奨されていない。

また、ブートストラップが常にGatewayホスト上で実行される点も重要だ。macOSアプリがリモートGatewayに接続している場合、--skip-bootstrapの設定はリモートホスト側で実行する必要がある。ローカルのCLIから実行しても効果がない場合は、接続先のゲートウェイホストにSSH接続して実行することを検討しよう。

📋 onboardコマンドのオプション比較

コマンド 動作 推奨ケース
openclaw onboard 通常のオンボーディング（Q&Aあり） 初回セットアップ
openclaw onboard --skip-bootstrap ブートストラップをスキップ 事前設定済みワークスペース

Gatewayを再起動してもpendingが続く場合の対処法

【AI】【業務効率化】【職場】Gatewayを再起動してもpendingが続く場合の対処法

GatewayをI再起動してもbootstrap pendingが解消されない場合、問題はGatewayのプロセス自体ではなく、設定・ワークスペースファイル・認証情報のいずれかにある可能性が高い。

まず試すべき手順を段階的に示す。

🔧 段階的な復旧手順（破壊的操作の少ない順）

段階 コマンド 説明
① openclaw gateway restart 最も穏やかな再起動
② openclaw gateway stop → openclaw gateway start 完全停止後に再起動
③ openclaw doctor --fix 設定ファイルの自動修復
④ openclaw doctor --deep より詳細な診断
⑤ BOOTSTRAP.mdの手動削除 ワークスペースのクリーンアップ
⑥ openclaw gateway install --force Gatewayサービスの再インストール

GitHub Issue #70840の報告によれば、GatewayとインスタンスをそれぞれI再起動しても問題が解消されなかったケースが存在する。この場合、問題はワークスペースファイルや設定ではなく、セッション開始・リクエスト処理のより上位の部分でbootstrap pendingラッパーが注入されている可能性が指摘されている。

「This suggests the false wrapper is being injected earlier in the session-start/request path, likely in UI/runtime bootstrap handling rather than from workspace BOOTSTRAP.md or persisted session state.」

出典: https://github.com/openclaw/openclaw/issues/70840

このような場合、一時的な回避策として新しいターミナルセッションを使ってopenclaw tuiを直接起動することが考えられる。これはControl UI/TUI経由での接続を避けることで、UIによる誤ったラッパー注入を回避するアプローチだ。

💡 Gateway関連の追加確認コマンド

コマンド 確認できる内容
openclaw gateway status --deep 詳細なGateway状態・接続クライアント情報
openclaw status --all 全体状態 + 最新ログの末尾
lsof -i :18789 ポート18789を使用しているプロセスの確認

systemdでdaemonとして動作させている場合は、以下のコマンドでの再起動も有効だ。

systemctl --user restart openclaw-gateway

なお、設定バージョンの不一致（「split brain」状態）が発生している場合、古いバイナリが新しいconfigを読もうとしてプロセス操作を拒否することがある。この場合はopenclaw config get meta.lastTouchedVersionでバージョンを確認し、パスが正しいバイナリを指しているかどうかを確認する必要がある。

Control UI/TUIが誤ってbootstrap pendingを注入するバグへの対応

【AI】【業務効率化】【職場】Control UI/TUIが誤ってbootstrap pendingを注入するバグへの対応

GitHub Issue #70840で報告されたバグは、BOOTSTRAP.mdに「bootstrap is complete（完了）」と明記されているにもかかわらず、Control UI/TUIが新しいターン/セッションのたびに「Bootstrap pending」ラッパーをメッセージ先頭に注入し続けるという内容だ。このバグはAWS Ubuntuホスト上で再現されており、GatewayおよびインスタンスのI再起動でも解消しなかったことが確認されている。

🐛 Issue #70840の詳細

項目 内容
バグの種類 動作バグ（クラッシュなし）
影響するUI openclaw-control-ui・openclaw-tui
発生条件 完了済みワークスペースでの新セッション作成時
深刻度 高（すべての新しいターンが影響を受ける）
Gatewayの再起動 効果なし
インスタンスの再起動 効果なし

注入されるラッパーは以下のような形式だ（おそらくこれに類した内容と推測できる）。

[Bootstrap pending] Please read BOOTSTRAP.md from the workspace 
and follow it before replying normally.

このラッパーが毎回注入されると、エージェントはブートストラップ処理を完了しようとして通常の応答ができなくなる。また、すでに削除済みのBOOTSTRAP.mdを読もうとして失敗を繰り返すといった「繰り返しのブートストラップハンドリングループ」に入ることもある。

🛠️ Issue #70840への対処として試せる方法

対処法 期待できる効果
TUIを直接起動する（openclaw tui） Control UIを経由しないため注入が回避される可能性がある
新規セッション（/new）を避けて既存セッションを継続 セッション開始時の注入トリガーを避けられる場合がある
OpenClawを最新バージョンに更新する バグ修正が含まれる可能性がある
BOOTSTRAP.mdの内容を明示的に「complete」と記載 一部のケースでラッパー注入を抑制できる可能性がある

このバグは「Issue #71230」として修正対応がクローズされていることがGitHubから確認できるため、最新バージョンへのアップデートが最も確実な対処法と考えられる。現在古いバージョンを使っている場合は、npm update -g openclawでアップデートを実行することを推奨する。

Windows・WSL2環境でのbootstrap pending特有の問題と解決策

【AI】【業務効率化】【職場】Windows・WSL2環境でのbootstrap pending特有の問題と解決策

OpenClawはWindowsネイティブではWSL2（Windows Subsystem for Linux 2）が必須であり、WSL2なしのネイティブWindows環境では数多くの問題が発生する。bootstrap pendingの問題もこの制約と関連していることがある。

「Windows users running outside WSL2 encounter numerous problems.」

出典: https://yingtu.ai/en/blog/openclaw-not-responding

🪟 Windows環境でのbootstrap pending関連チェックリスト

確認項目 内容
✅ WSL2が有効になっているか WindowsネイティブではなくWSL2内で実行する
✅ Dockerが正しく動作しているか Docker Desktopを使用している場合はWSL2統合が有効か確認
✅ Node.jsバージョンが22以上か node --versionで確認
✅ OpenClawのバージョンが最新か openclaw --versionで確認
✅ PATHが正しく設定されているか 複数のopenclaw installがある場合は混在しやすい

YouTubeのチュートリアル動画（「Como Resolver o Erro “Bootstrap Pending” no OpenClaw (Windows + WSL2 + Docker)」）では、Windows + WSL2 + Docker環境でのbootstrap pendingエラーの解決方法が取り上げられているほど、この組み合わせは特に問題が起きやすい環境として認識されている。

Windows環境で注意すべき点として、複数バージョンのOpenClawがインストールされている場合に、古いバイナリが新しい設定ファイルを読もうとして拒否される「split brain」状態が起きやすいことが挙げられる。この状態ではGatewayの起動・停止・再起動・強制再インストールなどの操作が軒並みブロックされる。

🔑 split brain状態の修復手順

ステップ コマンド 説明
1 which openclaw 現在使用されているopenclaw binary の場所を確認
2 openclaw --version バージョンを確認
3 openclaw config get meta.lastTouchedVersion 設定ファイルに記録されたバージョンと比較
4 PATHを修正して新しいinstallを優先させる 古いwrapperやパッケージの除去
5 openclaw gateway install --force Gatewayサービスを正しいバイナリで再インストール

WSL2環境でDockerを使用している場合、コンテナとホストの間でファイルパスの扱いが変わることがあるため、ワークスペースのパスが正しくマウント・アクセスされているかも確認ポイントだ。特に~/.openclaw/workspace/がWSL2のホームディレクトリ内に正しく配置されているかを確認してほしい。

総括：openclaw bootstrap pendingのまとめ

【AI】【業務効率化】【職場】総括：openclaw bootstrap pendingのまとめ

最後に記事のポイントをまとめます。

  1. openclaw bootstrap pendingとは、エージェントワークスペースの初期設定処理（ブートストラップ）が未完了または進行中であることを示す状態である
  2. 通常の初回起動時は10〜30秒以内に自動完了する正常な動作であり、短時間の表示は問題ではない
  3. 問題が起きるのは「複数回繰り返す」「アップグレード後に突然発生」「サブエージェント起動時に毎回発生」「Control UIから接続するたびに発生」するケースである
  4. BOOTSTRAP.mdはエージェントの初回設定を制御するファイルで、完了後に自動削除される仕様だが、バグや設定によって削除されずに残ることがある
  5. バージョン2026.4.21のアップグレード後、サブエージェントがSOUL.mdではなくBOOTSTRAP.mdを優先して読むというバグ（Issue #69994）が報告されており、該当ワークスペースからBOOTSTRAP.mdを削除することで即座に解消された
  6. Control UI/TUI接続時に完了済みのワークスペースに対して誤ってbootstrap pendingラッパーを注入するバグ（Issue #70840）も確認されており、最新バージョンへの更新が最も有効な対処法とされる
  7. まず試すべき解決策はopenclaw doctorによる自動診断で、--fixオプションを付けると多くの問題を自動修復できる
  8. 事前設定済みワークスペースを使用している場合はopenclaw onboard --skip-bootstrapでブートストラップ処理自体をスキップできる
  9. Windows環境ではWSL2が必須であり、複数バージョンのOpenClawが混在するsplit brain状態がbootstrap pendingに関連した問題を引き起こすことがある
  10. Clawdbot時代から引き継がれたブートストラップの仕組みは、マルチエージェント・リモートGatewayなどの機能拡張により複雑化しており、コーナーケースでの問題が今後も発生する可能性がある
  11. 各ワークスペースにSOUL.md・IDENTITY.md・USER.mdが揃っているかを確認してからBOOTSTRAP.mdを削除することが重要で、設定ファイルが不足した状態での削除は別の問題を引き起こす可能性がある
  12. 定期的にopenclaw doctorを実行し、npm update -g openclawで最新バージョンを維持することが予防策として有効である

関連記事

✓gensparkでグラレコ作るなら？雑に投げても伝わる図解にする使い方まとめ
✓榊原信行の年収はいくら？億説と800万円説の差がデカすぎる理由
✓カミタケモータースの年収はぶっちゃけ高い？口コミ・求人・評判から給与事情を丸ごと整理
✓決算期変更はいつまで間に合う？届出期限と失敗しない段取りを丸ごと整理
✓zapierの時価総額はいくら？50億ドル級企業の正体と稼ぎ方を丸ごと解説
✓【使ったものを元に戻せない人】職場での対処法５選！会社員を生き抜く術
✓味方がいない職場を乗り切る！特徴や敵しかいない状況からの脱却！
✓idom 決算を見たらわりと強い？最新業績・配当・次回決算日を一気に整理
✓zapier 生成aiは何ができる？自動化で仕事をラクにする使い方ガイド
✓高額療養費制度は年収・世帯・個人でここまで違う！損しない限度額の見方
記事作成にあたり参考にさせて頂いたサイト

各サイト運営者様へ
有益な情報をご公開いただき、誠にありがとうございます。
感謝の意を込め、このリンクはSEO効果がある形で設置させていただいております。
※リンクには nofollow 属性を付与しておりませんので、一定のSEO効果が見込まれるなど、サイト運営者様にとってもメリットとなれば幸いです。
当サイトは、インターネット上に散在する有益な情報を収集し、要約・編集してわかりやすくお届けすることを目的としたメディアです。
引用や参照の方法に不備、あるいはご不快に感じられる点がございましたら、お問い合わせフォームよりご連絡ください。
今後とも、どうぞよろしくお願いいたします。

AI 業務効率化 職場
ABOUT ME
カシワギ
『エグゼクティブワーク』編集長のカシワギです。 普段はITベンチャーで執行役員の40代男です。 元コンサルタントですが、今はテクノロジー企業で日々奮闘中。 仕事では厳しい顔をしていますが、家では小学生の子供2人のやんちゃなパパ。 休日はゴルフに行ったり、妻とワインを楽しんだり。
BLOG：https://min-biz.net/
当サイトについて
当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。