OpenClaw 2026.9.1移行：r/openclawからのレガシーマルチエージェントアップグレードノート

OpenClawのメジャーバージョン間のアップグレードは困難に感じるかもしれませんが、最近のr/openclawの投稿では、レガシーなマルチエージェント設定が2026.7.1-2から2026.9.1へ大きな問題なく移行できた例が示されています。特に、AIコーディングエージェントにステップを任せた場合はなおさらです。

レガシー設定

移行は以下の構成から始まりました：

• OpenClawのグローバルnpmインストール
• バージョン2026.7.1-2
• ユーザーsystemdゲートウェイサービス
• エージェント固有のワークスペースを持つ複数の設定済みエージェント
• グループ固有のルーティングを備えたWhatsAppチャネル
• ブラウザプロファイルといくつかの管理プラグイン

発見された問題

アップグレード後にのみ、実際に何が変更されたかがわかります。特定された問題は次のとおりです：

• 複数のレガシー設定キーが2026.9.1で拒否された
• マルチエージェントの所有権を明示的に宣言する必要があった
• 共有SQLite状態データベースのスキーマ移行が必要だった
• レガシーワークスペースのセットアップ状態の移行が必要だった
• いくつかの公式プラグインがまだ古いバージョンだった
• WhatsAppに一致しないメッセージ用のフォールバックエージェントがなかった
• Web UIリバースプロキシに信頼済み転送クライアント属性が必要だった
• サービス定義に古いまたは非標準のメタデータがあった

修正された内容

アップグレードはCodex（VS Code拡張機能を介してOpenClawマシンにリモート接続）に委任されました。全プロセスは約30分かかりました。生成された要約からの主な手順：

• 設定、シークレット、サービスファイル、パッケージメタデータ、およびランタイムステータスの日付入りロールバックバックアップを作成。
• 組み込みのアップデータを使用してOpenClawを2026.9.1に更新。
• 廃止されたキーを削除し、サポートされているタイムアウト設定を変換して設定を移行。
• マルチエージェントの所有権を明示的に設定。
• 外部サービス修復ポリシーでDoctorを実行し、SQLite、ワークスペース、デバイス、プラグインの状態移行を完了させた。
• systemdゲートウェイサービスの定義を更新。
• 公式プラグインを2026.9.1に更新。
• mainをデフォルトのハートビート所有者および未一致のWhatsAppルーティングエージェントとして設定。
• ローカルリバースプロキシ用に、スコープが狭い信頼済みプロキシエントリを追加。

結果と教訓

移行後、ゲートウェイは2026.9.1を実行し、設定は検証され、サービスはアクティブで、ローカルのHTTP/RPCリスナーが応答し、WhatsAppはインバウンドメッセージをリッスンしていると報告し、ハートビート処理が正常に開始されます。

主な教訓：大規模なバージョンジャンプの場合、最初にバックアップを取得し、スキーマと状態の移行を予想し、ゲートウェイの所有権とマルチエージェントのルーティングの両方を確認してください。