不変タグ · Compose 規律 · トラフィック前スモーク · ロールバック準備
個人運用と小規模チームが VPS で OpenClaw を動かすと、:latest が夜間に新しい Gateway を引いて不意のアップグレードになることがあります。本稿では浮動タグが再現性を壊す理由、Compose と Kubernetes での semver / digest 固定、イメージ変更前にバックアップすべきパス、静かな時間帯の二重インスタンス・スモーク、以前のタグへ戻して health とチャネルを再確認するロールバックのシェル形をまとめます。あわせて持続可能なアップグレード、VPS Docker インストール、Exit 137 と WASM ウィンドウ、Gateway doctor トリアージを参照してください。
:latest が向かない理由浮動タグは三つの漂移を隠します：Skill が前提とした Gateway のバイナリ表面、コールバックが頼ったプラグインやチャネル schema、Node 周辺のコンテナ基盤です。「常に最新」を引くとインシデントが当て推論になり、ホスト間でレイヤーが揃わずポストモーテムも崩れます。
| レイヤ | :latest で動くもの | 最初に感じる症状 |
|---|---|---|
| Gateway API | CLI フラグ、設定 schema、Control UI ルート | 計画外再起動後に Skill 検証が失敗 |
| チャネル | Webhook ハンドシェイクのタイミング、Discord intents の既定 | 誰かが気づくまでメッセージが静かに落ちる |
| ランタイム | Node のパッチレベル、libc 互換 | 初回 WASM やネイティブ依存で CPU または OOM |
本番の OpenClaw イメージは二回同じ文字列で名付けられるべきです：Git で一度、ホストでも一度——digest は任意だが意識的に選ぶ。
注：クラスタのゼロダウンタイム移行は DR とゼロダウンタイムアップグレード；本ページは単体または二重 Compose の VPS 向けです。
環境ごとに不変参照は一つ：ステージングで試したリリースタグ（v2026.4.2）か、リージョン間でバイト一致が必要なら digest。文字列を compose の横に書き、インシデントチケットにも転記します。
services:
openclaw:
image: ghcr.io/openclaw/openclaw:v2026.4.2
pull_policy: missing
pull_policy: missing か digest を固定。注意：openclaw.json だけを編集しイメージが裏で進むのも無管理アップグレードです——設定リビジョンとイメージ参照を同一チケットで固定してください。
docker compose pull の前にスコープを固定し、ロールバック時に「良かった」の意味を残します。
設定ボリューム：~/.openclaw またはマウントパスをスナップショット；ツールが許せばチェックサムも。
ワークスペース：Skill ディレクトリと env_file で渡すボリューム外シークレットを記録。
チャネル：Webhook URL をエクスポートし、メンテ告知と受信可能時間帯を整合。
スモーク一覧：本番トラフィック前に通すべき Skill 二つとチャネル送受信ペアを決める。
リソース：初回コンパイルのメモリ余裕を Exit 137 記事 と照合。
候補イメージを別プロジェクト名または非本番ポートの compose で動かし、スモーク後にのみトラフィックを寄せます。
| 信号 | 見る場所 | 合格条件 |
|---|---|---|
| Gateway health | curl ループバック health | 複数プローブで HTTP 200 が安定 |
| チャネル状態 | Gateway ログまたは CLI | 再接続嵐なし；コールバック確認済み |
| Skill 監査 | Skill runner 出力 | ステージング期待に対して新たな deny がない |
| Control UI | ピン留めしたオリジンでブラウザ | プロキシ設定後に non-loopback 不一致なし |
昇格の時間窓は短く；長い並走は Gateway が触る DB やキューの漂移を増やします。
ロールバックは即興ではなく練習したスクリプトとして扱います。イメージ参照を最後に良好だったタグへ戻し、明示的に pull、コンテナ再作成、その後に health を示してから復旧を宣言します。
export OPENCLAW_IMAGE_TAG="v2026.4.1" docker compose pull openclaw docker compose up -d --force-recreate openclaw curl -sf http://127.0.0.1:18789/health
VPS の横にmacOS 依存の重い仕事があるなら、Gateway の稼働とコンパイルプールの議論を分けてロールバックの論点を狭めます。自宅機より境界がはっきりした専用リモート Mac キャパシティが必要なら、本稿の Gateway 規律とあわせ 料金ページ と 注文ページ で容量を確認してください。
持続可能なアップグレードはチャネルや更新リズム、環境横断のバックアップを扱います。本稿は Docker イメージのピン留め、ステージング・スモーク、VPS 運用者向けロールバックコマンドに絞ります。
多くのチームは検証済み semver タグ；規制当局やマルチリージョンでバイト一致が必要なら digest。どちらも Git の compose 横に明記します。
初回起動とサイズは OpenClaw v2026.4 VPS Docker インストール；アップグレード時のメモリスパイクは Exit 137 と WASM ウィンドウ を参照。