三つの痛み：アップデート後にランダムな OpenClaw の不具合に見えるもの
1）設定契約なしでアップグレード。 openclaw update 成功後に openclaw.json のキー変更やデータ移動でチャンネルが沈黙することがあります。日付付き tar と直前のパッケージまたはイメージダイジェストが無いとロールバックは推測になります。トークン経路とモデルキャッシュを文書化し、再インストールと独立した復元にします。
2）MCP を純設定として扱う。 プラグインは子プロセスとパスを定義する運用面です。JSON や権限の誤りでツールが文脈から消えます。ホットリロードは変更点を隠すので、都度ツール一覧を検証します。
3）切り分け梯子を飛ばす。 待受、HTTP、doctor、最小再現ログの順です。チャンネル、版、tar、health JSON を記録します。
チャンネルとロールバックの判断表
アーキレビューと事後分析にも使えます。
| 方針 | 向く場面 | 主なリスク | 最低限の統制 |
|---|---|---|---|
| 安定版のみ | 本番ゲートウェイ、規制フロー | 機能が遅い | ロックまたはダイジェストで固定、月次で tar 復元をリハーサル |
| ステージングでベータ | MCP や新ブリッジの検証 | 共有設定への波及 | 設定とキーを分離、bump ごとに doctor |
| tar と過去パッケージで戻す | 分単位の中断が許容できる場合 | 一方向移行 | ノートを読み、前後で health JSON を保存 |
| 最新をクリーン再設置 | ラボ・捨て VM | キャッシュ喪失 | 本番の第一対応にしない |
インストール経路 と揃え、Docker はダイジェスト、npm はロックで固定します。
事前スナップショット：含めるものと境界
openclaw update 前に UTC 日付と版目標を名前に含む tar を取り、openclaw.json ツリー、重ね設定、サービス用シェル、シークレット参照を入れます。高コストなキャッシュは必要に応じます。ワークスペースの読み書き境界とコンテナの UID／GID を明示します。
オブジェクトストアに少なくとも九十日、Node、パッケージマネージャ、which openclaw、最後の health JSON を添えます。更新前に openclaw doctor で基準線を残し、失敗時は差分を見ます。チェックサムゲート と同様に根拠を優先します。共有設定は環境で分岐し、main マージはインフラと同じ審査にします。
MCP プラグイン JSON、ホットリロード、ツール一覧の罠
MCP は子プロセスやローカル接続の構造化エントリです。スキーマで JSON を検証し、相対パスを優先します。ホットリロードは版で無効のこともあり、環境や実行権の変更には全再起動が要ります。再読み込み後はツール一覧と単発プロンプトで検証します。ログはサブシステムでフィルタし、プラグインは最小権限で、許可リストを文書化します。
プラグイン変更後の診断コマンド例
openclaw status
curl -sS -m 5 http://127.0.0.1:18789/health || echo "gateway probe failed"
openclaw doctor
openclaw health --json > /tmp/openclaw-health-plugins-$(date +%Y%m%d%H%M).json
openclaw logs --follow
TLS が外側で終端する場合はポートと URL を読み替え、順序は維持してください。
数値基準：ポート、メモリ、ログ、並列
手引きはゲートウェイ HTTP を 18789 に揃え、TLS は nginx／Caddy／LB に任せます。内部ポートと公開 URL を両方記載します。会話用に約 1.5 GiB の空き RAM、十四日以上の構造化ログを日次で保持します。CI と同居する場合は並列を抑え、並行とキープアライブ を参照し、原子シンボリックリリース の昇格とメンテを揃えます。
切り分け順、FAQ、ホスト型リモート Mac
更新やプラグイン変更のあとは status→HTTP→doctor→ログ です。ゲートウェイ運用の記事 と整合します。
- doctor は通るがチャンネルが沈黙： ブリッジのトークンと許可オリジンを見る。
- ツール一覧が空： JSON、権限、再起動要否を確認する。
- プロキシ背後の断続 502： 上流タイムアウトと長いツール呼び出しを比較する。
まとめ： 版の規律、スナップショット、明示的な MCP 契約、共有の梯子です。
限界： スリープする個人機と未文書化の手編集が支配的です。
SFTPMAC： ホスト型リモート Mac は常時到達と隔離を提供し、SFTP／rsync と同居しやすく、休眠や権限ずれを減らします。
マイナーパッチでもスナップショットは必要ですか？
本番なら推奨します。tar のコストは無秩序な復旧より小さいです。
ステージングと本番で plugins を共有できますか？
テンプレートとシークレット分離時のみ。それ以外は環境で分岐します。
クラウド Linux で足りないのは？
多くのゲートウェイは足ります。ツールチェーンやパスが macOS 前提ならリモート Mac を選びます。
管理されたファイル配信の隣で安定 Mac ホストに OpenClaw を載せたい場合は、SFTPMAC のプランをご確認ください。