openclaw bootstrap pendingが解決しない！原因と対処法を徹底的に調べてまとめた完全ガイド

「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とは何かを解説
bootstrap pendingが表示される主な原因は3つ
BOOTSTRAP.mdの役割はエージェント初回設定の儀式
Clawdbot bootstrap時代から続く仕組みの変遷
アップグレード後にbootstrap pendingが起きやすい理由
正常なbootstrap pendingと異常なbootstrap pendingの違い

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つ

調査した情報をもとに整理すると、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の役割はエージェント初回設定の儀式

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時代から続く仕組みの変遷

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が起きやすい理由

バージョン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の違い

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

✅ 正常なbootstrap pendingの特徴

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

❌ 異常なbootstrap pendingの特徴

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

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

忘れる前に！【ふるさと納税】今年もお得に！

ふるさと納税のポイント付与は2025年10月に廃止になりました。

＼最大7.5%ポイントアップ！／

Amazon

＼楽天ポイント4倍セール！／

楽天市場

Yahooショッピング

メルカリ

ポチップ

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

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

まずは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を手動削除すればサブエージェント問題が解決する

サブエージェント起動時に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自体をスキップできる

あらかじめ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が続く場合の対処法

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を注入するバグへの対応

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特有の問題と解決策

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のまとめ

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

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

記事作成にあたり参考にさせて頂いたサイト

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

AI 業務効率化職場

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。迅速に対応をさせていただきます。その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応することができますのでそちらもご協力いただけますと大変幸いでございます。今後とも当サイトをよろしくお願いいたします。