OpenClaw 2.0舰队迁移：真正出了什么问题

単一のOpenClawインスタンスのアップグレードは簡単でも、本番稼働中のクライアントのフリート全体に行うと、障害は何倍にも拡大します。あるチームはOpenClaw 2.0への移行に丸一日を費やし、最も深刻な問題点を共有しました。ここでは、実際に何が壊れ、どう回避したかを説明します。

設定スキーマがより厳格に

2.0では設定スキーマが厳格化され、いくつかのフィールド（envキー、TTS、メディアモデル）が移動しました。最大の落とし穴は、doctor --fixが未知のフィールドを静かに削除することです。モデルキーが非推奨の領域にある場合、それらのフィールドと一緒に消えてしまう可能性があります。チームはキーを失わないよう、doctorを実行する前に設定を手動で書き直しました。

外部プラグインがゲートウェイを壊す

WhatsApp、Brave、Discord、Perplexityはコアイメージには含まれなくなり、外部プラグインになりました。設定がまだそれらを参照している場合、ゲートウェイは準備完了にならず、コンテナは再起動ループに入り、外部からは502のように見えます。プラグインをイメージに追加するだけでは不十分です。機能の同意が特定のマシンに結びついており、doctorはそれを受け入れないからです。唯一機能する方法は、openclaw plugins install ... --accept-capabilitiesを別のステップとして実行することです。

デバイスペアリング: Cloudflareヘッダーがローカリティを壊す

ウェブチャットでPAIRING_REQUIREDエラーが発生し始めました。根本原因は、2.0が転送ヘッダーなしでループバックからのリクエストのみを信頼することです。nginxでヘッダーを設定しないだけでは不十分です。Cloudflareは独自のヘッダーを送信するため、nginxで明示的にnullにする必要があります。これはトークンの破損のように見えましたが、実際にはCloudflare、nginx、OpenClawのローカリティロジック間の競合でした。

Perplexityが不要に自動ロードされる

PerplexityはOpenRouterキーを検出すると自動ロードされ、プラグインが不要でも同意を要求します。enabled: falseを設定しても効果はなく、ブロックするにはplugins.denyを使用する必要があります。

要点: 機能よりも稼働時間を優先する

最終的な原則: 一時的にウェブ検索や単一のチャネルを失う方が、エージェント全体を502でダウンさせるよりはましです。複数の障害を想定し、各コンポーネントを個別にテストしてください。

これは、OpenClawをクライアントにホスティングしているクラウドプラットフォームからの実際の移行レポートに基づいています。アップグレードを計画している場合は、ソースで詳細とコミュニティの洞察を参照してください。