本番で OpenClaw を動かしているチームが 2026 年に最も恐れるのは次の三つです。latest の漂移、状態ディレクトリをバックアップせずに上げること、Gateway を誤った順序で止めてトークンとボリュームが食い違うことです。本稿は新規インストールではなく、《三プラットフォーム導入》《Docker 本番》《インストール後の切り分け》《Linux systemd＋Tunnel》と役割を分け、痛みの整理、ローカルとコンテナの対照表、症状とロールバックのマトリクス、バックアップ断片、六ステップの Runbook、当番向けの三行をまとめます。Secrets と露出面の統制は《上級実践編》へ進んでください。
導入編は「どう入れるか」、Docker 本番編は「常駐と代表的なコンテナ障害」、インストール後編は「起動しないときの症状別」、Linux＋Tunnel 編は「systemd で公開バインドを避ける」です。本稿は「すでに動いている」前提のアップグレード、換装、デプロイ形態の変更、ロールバックだけを扱い、変更チケットに貼れる粒度にします。実際の当番で多い六類型は、変更説明にそのまま貼ってください。
latest や浮動タグのままでは、前の digest に戻せません。~/.openclaw（または文書化されたパス）の鍵・ワークスペース・Gateway 設定がボリュームと一緒にスナップショットされていません。レビューで「このリリースはどちらの経路か」を固定するための表です。フィールド名は利用中の fork／リリースノートに合わせてください。
| 観点 | ローカル経路 | Docker Compose 経路 |
|---|---|---|
| バージョンアンカー | npm／pnpm と lockfile を固定し Node マイナーを記録 | イメージ tag または digest を固定し、silent latest を禁止 |
| 状態の置き場 | ~/.openclaw とローカルワークスペース | bind mount または名前付きボリュームをホストにマップ |
| 鍵とトークン | 環境変数、キーチェーン、.env（Git に入れない） | .env、Docker secrets、オーケストレーション変数。昇格前にエクスポート |
| ヘルス | CLI／ローカルポートのプローブ | compose ps、コンテナ内ヘルス、ホスト側ポート |
| ロールバックの手 | 指定版の再インストール＋ディレクトリ tar の復元 | 前の digest に戻す＋ボリュームスナップショットの復元 |
インストール後の切り分け記事と補完関係です。ここではアップグレード窗口内の判断順を強調します。Control UI と公開露出は上級実践編の方針に揃えてください。
| 症状 | まず疑う | 最初にやる | それでもダメなら |
|---|---|---|---|
| Gateway の再起動ループ | バインドと UI 許可リストの不一致 | loopback バインドへ寄せるか allowedOrigins 系を整えて再試行 | 直前のイメージ digest に戻しボリュームを復元 |
| ペアリング／端末認可の異常 | 二重インスタンスまたはトークンローテーションがクライアントに届いていない | 旧インスタンスを完全停止し、CLI で端末を列挙して公式手順で再設定 | バックアップからトークンファイルを戻し一時的にバージョンも戻す |
| モデル接続タイムアウト | 出口、プロキシ、鍵の変更 | コンテナ内とホストで curl。鍵は最小変更で試す | ベンダー状況とファイアウォールを確認 |
| ディスク逼迫後にアップグレード失敗 | ワークスペースとログのローテーション不足 | ログ削除の前にスナップショット。公式推奨の空き容量を確保 | ディスク拡張またはワークスペースを別ボリュームへ |
# 例：アップグレード前に状態ディレクトリを固める（パスは環境に合わせる。アーカイブは git に入れない） tar czf openclaw-state-$(date +%Y%m%d).tgz -C "$HOME" .openclaw # Compose：.env または compose で digest／マイナーを固定してから pull & up # docker compose pull && docker compose up -d
注意：秘密を含むバックアップの権限は運用ロールに限定します。復元後は漏えいしうるトークンをローテーションし、上級実践編の Secrets 監査サイクルと揃えてください。
.env の安全コピー（監査用はマスク）。ノートとサーバで Gateway を二重に動かす場合は監視にインスタンスラベルを付けます。アラートが down だけでは DNS をどちらに切るか分からず、Docker 本番編のトークンと露出面の約束の延長線にあります。
スリープ、OS アップデート、ディスクの伸びが窗口をランダムにします。スナップショットと契約期間が揃っていない短期 VPS では、ロールバック用のディスクが欠けることがよくあります。Gateway を本番部品にするには予測可能なオンライン時間、復元可能なディスク、リージョン選択が必要で、Runbook を監視と結び付けます。
バラバラのホストでは Secrets 統制と監査が崩れやすく、誰が最後にトークンを変えたか、どのマシンが digest X かが曖昧になります。MACCOME は複数リージョンで Mac Mini M4／M4 Pro のベアメタルを提供し、OpenClaw の安定した実行面や専用 Gateway ホストに向きます。《マルチリージョンとレンタル期間のガイド》《SSH と VNC の判断》とあわせて検討し、料金でプランを揃え、ヘルプセンターで請求と接続の文言を確認してください。
パイロットなら、対象リージョンで短いレンタルからバックアップ—アップグレード—ロールバックの演習をしてから長期契約に載せるのが安全です。
よくある質問
アップグレード前に省略してはいけない三つは何ですか？
イメージまたはパッケージのアンカー固定、状態ディレクトリとボリュームの完全バックアップ、窗口内でのロールバック責任者と検証ケースの記録です。商業条件は レンタル料金 と ヘルプセンター を開いてください。
Gateway アップグレード後に Control UI がおかしい場合、最初に何を見ますか？
バインドとヘルス、Docker では loopback と UI 許可リスト系、ローカルではポートとトークンです。症状別の流れは《インストール後の切り分け》を主に参照してください。
Docker 本番編とどう組み合わせますか？
本番編は常駐と代表的なコンテナ障害、本稿はアップグレード前後のバックアップ順とアンカーとロールバックです。《Docker 本番》と同じ運用手順目次に置いてください。