AIエージェントによるOpenClawアップグレードの自動化：実戦検証済みプレイブック

OpenClawのアップグレードは、レガシー設定の移行、サイレントな機能変更、プロセス管理のエッジケースなど、何かと問題を起こすことで有名です。ある開発者は同じ問題を何度も再発見することにうんざりし、Hermesエージェントにアップグレードプロセス全体を処理するよう教え込みました。その結果、最近の2026.7.1から2026.8.1（「OpenClaw 2.0」）へのアップグレードは、「数時間に及ぶ手に汗握るトラブルシューティング」から「プレイブックを実行し、既知の問題に2回当たる。どちらも1分以内に自動診断される」に変わりました。

セットアップ

著者は小規模な環境を運用しています。EC2ゲートウェイサーバーと2台のMac（MacBook ProとMac mini）で、それぞれがOpenClaw CLIとネイティブアプリの両方を実行し、すべて同じバックエンドを指しています。このマルチホスト構成では、「とりあえず再起動して様子を見る」という方法は非現実的です。

核となるアイデア：エージェントのメモリが成果物である

どのエージェントでもdoctor --fixを実行して出力を読むことはできます。本当の価値は次のことを行うときに生まれます：

• 見つけた内容を検索可能な形式で書き留める。
• 手順の知識（スキル/ランブック）を更新し、次のアップグレードが「これまでに分かっていること」から開始できるようにする。
• 過去のインシデントについて、検索可能なメモリストアをクロスリファレンスする。

著者は3つのコンポーネントを使用しています：

• スキルファイル：約9か月のアップグレードで構築された、落とし穴を含む構造化された手順。
• セマンティックメモリストア：MemPalace（github.com/mempalace/mempalace）が過去のインシデントレポートをインデックス化し、「デバイスIDの競合アプリ」のような曖昧な検索に対応します。
• 共有コンテキストファイル：OpenClaw側のエージェントも読み取るため、Hermesが学んだ教訓がサイロ化されません。

2026.8.1で実際にうまくいかなかったこと

3つの具体的な問題と、それらが二度驚くべきものでない理由：

1. doctor --repairは一度きりの操作ではありません。成熟したマルチエージェントインストールでは、繰り返し実行することを想定してください。各パスでレガシー設定/状態の1つの層がクリアされ、次の層が明らかになります。著者はゲートウェイだけで完全終了するまでに11回の実行が必要でした。2回で諦めると誤診につながります。
2. マルチエージェントゲートウェイには明示的な所有権が必要です。ゲートウェイごとに複数のエージェントペルソナを実行する場合、新しいバージョンでは、どのエージェントがアンビエント/システムレベルの操作を「所有」するかを宣言する必要があります。宣言モードは「strict」と「simple」の2つがあります。strictは理解しにくいクラッシュループを引き起こしました。simpleはすべてのエッジケースをマッピングしていない限り安全です。
3. レガシー設定ファイルが修復パイプライン全体をブロックする可能性があります。1つの古いJSONファイル（exec-approvals）が、それが具体的に解決されるまで、他のすべての修正が適用されるのを静かに妨げていました。

これらはOpenClaw固有のツールではありません。単に「エージェントに物事を書き留める場所を与え、それを習慣にする」だけです。同じアプローチは、Claude Code、Codex、またはツールを持つ任意のエージェントでも機能します。