2026 OpenClaw 公式トラブルシューティング・ラダー：gateway probe、channels 調査、長文脈 429、openclaw.extensions
自前 OpenClaw は消失症状に見えがちです。短期ラダーはプロセス・RPC・openclaw doctor を先に固め、チャネル調査は後です。典型は 429 と openclaw.extensions 欠落です。
フラグは --help で版に合わせ、順序だけは不変としてください。各出力をチケットひな型へ貼り、証跡なしパッチを返しやすくします。
目次（TOC）
1. ラダーを飛ばすと調査予算が燃える理由
多プロセス多面設定ゆえ「接続済み」でもトークン／キャッシュ／CLI とゲートウェイのズレが混ざり、TLS／FW を先に触ると対照実験が壊れます。並列変更は二分探索を殺し、429／タイムアウトは HTTP を残さないとチャネル誤診になり、extensions 欠落は不安定ネットに見せかけます。
- 並列編集は因果説明を失います。
- 429は HTTP を残さないとプローブの陰に隠れます。
- manifest 欠落はネット不安定に見せかけます。
2. 六十秒ラダーと必須の証跡
メモ先頭は三要素：サービスユーザー、HOME、CLI／ゲートウェイの版またはハッシュ。運用認識とずれたら先にメタデータ分裂を潰します。
gateway probe で遅延・TLS・拒否クラスを残し、続けて gateway status と openclaw doctor を一枚に。RPC が拒否ならチャネルスクショは増やしても無駄です。
妥当ならチャネル調査へ。doctor がリモート URL／トークン不一致ならメッセンジャーを触る前にリモート観点を揃えます。Docker はトークン／ポート／WS コードを並記し、localhost と公開で差が出るなら compose／公開経路を優先します。meta.lastTouchedVersion が割れたら防火壁より分裂アップグレード表へ進みます。緑でも幽霊なら二段トグルと plugins.entries を確認します。ラダー出力は変更票へ貼ります。
3. 判定表：症状と最初に取る証拠
ゲートウェイ／チャネル証跡が無いうちはレア MCP は後回しにします。
| 症状 | 証拠 | 層 | 次手 |
|---|---|---|---|
| CLI 非到達 | probe stderr／timeout | RPC・listener・token | 先に probe |
| doctor ドリフト | マスク doctor | 権限／JSON | カテゴリ単位で一つ |
| probe 緑・チャット無音 | 二段／plugins.entries | 准入 | チャネル深掘りへ |
| 429 連発 | model ID／hdr／並行 | quota／tier | backoff／鍵分離／短文化 |
| 導入後プラグイン無し | package.json extensions | ローダ宣言 | 修正／薄ラッパー |
4. プラグイン導入と openclaw.extensions 契約
ローダは openclaw.extensions マップを前提にします。欠けると npm は成功でもランタイムはハンドラ無しに近い静けさです。キーと稼働メジャーを突合し、報告にはパス・semver・マニフェスト節チェックサムを添えます。
修正は組織名前空間の薄いラッパーで宣言だけ足すのが安全で、本番 node_modules 直編集は避けます。
# 推測せず公開マニフェストを確認
jq '.openclaw.extensions // "MISSING"' node_modules/<pkg>/package.json5. 長文脈ティアと実行可能な 429 緩和
バースト課金と長文脈 SKU はセットで、巨大ログや重いツール出力、並列扇は最初に 429 と Retry-After で現れがちです。ターンごとのトークン見積り、並列ツール上限、ステージング／本番鍵分離、再生前の添付削減、長文脈モデル ID と購入資格のルート整合を確認してください。
長文脈は尾部レイテンシを増やします。バックオフはユーザーへスロットリング可視化とセットにします。
6. ロールバックの説明を壊さない七段階
- 凍結：CLI／GW／イメージ版を記録。
- probe：失敗時は stderr 全文＋所要時間。
- status：公開 URL・トークン有無など環境。
- doctor：アダプタ前に構造修正。
- channels：面別に調査し ID 記録。
- extensions：宣言と semver を監査。
- 最後：ペア／リバプロ／リモート上書き。
ステップ二〜四で二つのバイナリが設定タイムスタンプでずれたら分裂指標へ戻り、幽霊 RPC を避けます。
7. 毎回ログに残す数値
週次 probe 遅延 pctl、doctor 警告、鍵／model／WS 別 429、導入対探索ギャップを固定化し数値化します。
8. FAQ と境界
質問：probe とヘルスは？CI の doctor は？回答：ヘルスは認証 RPC を省く場合があり、probe は CLI 実経路です。CI の golden で doctor 劣化ならリリース停止が筋です。
質問：旧プラグインやハード更新で extensions／429 はどうなりますか。回答：2026 マイナーで検証強化により寛容が消えることがあります。ハードは並行余裕に間接効果のみでクォータは残ります。
9. 託管 Mac とラダーの安定化
ラダーは証拠化しますが、スリープノートや VPN、乱れた HOME はノイズになります。対話ユーザーと launchd の主体差でも分裂が戻ります。
SFTPMAC レンタル Mac は常時稼働 GW 向けに再現性を上げます。クォータ／extensions 契約は不変。SSH 主体・トークンローテ・成果物受渡しも確認します。
上行と Mac ツールチェーンの近くへ置くなら SFTPMAC リモート Mac レンタルを参照してください。