OpenClawの頻繁な互換性破壊変更：更新手順と現在の問題

OpenClawの頻繁なリリースにおける更新手順

OpenClawは2〜3週間ごとに破壊的変更をリリースしており、2026年3月だけで13回のポイントリリースがありました。ソースには安全に更新するための具体的な手順が提供されています。

更新前の準備

• バックアップを作成: openclaw backup create --name "pre-update-$(date +%Y%m%d)"
• Dockerを使用している場合は、:latestではなくイメージタグを固定: image: openclaw/openclaw:2026.3.28

更新後の作業

• 実行: openclaw doctor --fix
• 離れる前に、チャネル、cron、スキルを手動でテストする
• --fixフラグはほとんどの設定移行を捕捉しますが、すべてではありません

問題が発生した場合

• バックアップにロールバックする
• 再試行する前に、GitHubのIssuesページで特定のバージョンの問題を確認する

現在のバージョンの問題（2026年4月、バージョン3.28）

• Localhost認証が変更: ローカル接続にトークンが必要になりました
• 危険なコード検出時にスキルインストールが失敗するようになりました
• Feishuに設定検証のリグレッションがあります（#56942）
• ハートビートモデルのオーバーライドが壊れています（#58137）: LiveSessionModelSwitch検出により、ハートビートがプライマリモデルに強制されます
• ハートビートのisolatedSession: trueが実際には隔離されません（#56941）

バージョン推奨事項

• Feishuを使用している場合は、バージョン3.23-2を維持してください
• ハートビートのコスト削減が重要な場合は、モデルオーバーライドのリグレッションが修正されるまで3.23-2の方が安全かもしれません

ソースでは、この種のリグレッションにより、BetterClawでのマネージドホスティングが魅力的であると指摘されています。リリースがエージェントに到達する前にテスト中に捕捉されるためです。ただし、セルフホスティングも有効な選択肢です。