2026 年 OpenClaw ワークスペースのバックアップと復元：~/.openclaw をクラウド Mac mini へ安全に移す

ボリュームを拡張した、レンタルの Mac mini を再構築した、別リージョンにホットスタンバイのゲートウェイが必要——いずれもトークン・スキル・LaunchAgent パスを壊さず OpenClaw を動かす必要があります。~/.openclaw はデータベースのように扱いましょう：書き込みを止め、一貫したスナップショットを取り、読み取りを検証します。本稿では tar と rsync のトレードオフ、キーを漏らさずアーカイブを共有する方法、トラフィック切替前の openclaw doctor チェックをまとめます。深掘りは アップグレードチェックリスト、環境プロファイルの衛生、ゲートウェイ診断 と併読してください。

バックアップに含めるもの

最低限 ~/.openclaw、openclaw.json、skills 下のインストール済みスキル、コンプライアンスで 90 日 保持が求められる場合はゲートウェイログ、カスタムフックを含めます。エージェントが ~/.agents またはプロジェクトの .agents にある場合はマニフェストに書き、復元でツール定義が消えないようにします。

再生成手順を文書化したうえでだけ、巨大で再生可能なフォルダを除外します：npm キャッシュ、一時的なモデルダウンロード、自動化スクリーンショット用ブラウザプロファイル。モデルなしの本番アーカイブは圧縮で典型的に 120〜400 MB。ローカル LLM 重みがある場合は設定用 tarball と成果物同期に分け、サポートチケットを運びやすくします。

tar と rsync

方法	向いている用途	注意
tar czf	セキュリティや S3 への時点引き渡し	ゲートウェイ停止を確認；shasum -a 256 で検証
rsync -aH	ステージング間の増分ずれ修正	xattr に依存する場合は保持；末尾スラッシュに注意
APFS スナップショット	リスクの高いアップグレード前の同一マシンロールバック	オフボックス DR の代替にはならない

新しいクラウド Mac へ移す場合、チェックサム付き tarball は住宅アップロリンクでは繰り返し rsync より速いことが多いです。同一 VLAN 上なら 250 MB のツリーは rsync で多くの場合 6 分未満——教義ではなくネットワークで選びましょう。

シークレットとコンプライアンス

生の .env をチケットに貼らないでください。監査にはファイル名をハッシュしたマスク済みツリー一覧を生成し、実キーはボールトに保管します。キーを動かす必要がある場合は移行中にローテーション：先に先方ホストで新しい Slack ボットトークンと Discord webhook を発行し、doctor プローブ成功後に旧を失効させます。

SOC2 志向のチームは二つの成果物を持ちます：(1) ブレイクグラス用の暗号化フルバックアップ、(2) エンジニアリング再生用のサニタイズ済みアーカイブ。保持期間を文書化——スタートアップではサニタイズコピーを 35 日、ボールトオブジェクトを 1 年 とすることが多いです。

新しい Mac での復元順序

1. 移行前に記録したのと同じ Node 22 LTS マイナーをインストール。ここがずれるとネイティブモジュールが不一致になります。
2. サービスユーザー（多くは SSH ログイン）を作成し、そのホームに正しい UID/GID で展開します。
3. 承認されたパスで openclaw CLI をグローバルまたはパッケージマネージャ経由で再インストール。
4. LaunchAgent plist または systemd 相当を再読み込み。macOS ではオンボーディング文書に従い launchctl bootstrap。
5. TCC 権限（画面録画、自動化など）を再付与——マシンローカルです。

クラウドテナント間の移動では TCC クリックに 15〜25 分 の人手がかかりがちです。VNC セッションでまとめて処理し、中途半端な付与を避けましょう。

検証マトリクス

DNS 切替前に次を実行し、変更チケットにタイムスタンプを記録します：

• openclaw doctor がゼロ終了し、警告予算がソースホストと同じ。
• チャネルプローブが 30 秒以内 に合成メッセージの往復を完了。
• モデルまたはキャッシュ展開後、APFS の空きが 20% を超える。
• 上位 10 の自動化フローを再生する間、CPU アイドルが 35% を下回る。

いずれかが失敗したら DNS をロールバックし旧ゲートウェイを維持——切替直前にスナップショットしていればクラウド Mac の巻き戻しは約 5 分 です。

自動化のヒント

各アーカイブの横に BACKUP_MANIFEST.txt を置き、OpenClaw バージョン、Node バージョン、OS ビルド、チェックサムを列挙します。未来の自分と深夜 2 時のオンコールが感謝します。マニフェスト生成は LaunchAgent シリーズで説明した週次 cron に紐づけられます。

盲信クローンを避けるとき

ソースマシンが侵害されている場合は、ホームツリー全体をコピーせず既知良好の設定から再構築します。サニタイズ済みアーカイブと新しくローテーションした資格情報を使いましょう。速度優先で LaunchAgent を複製しマルウェアの永続化を残したチームの前例があります。

帯域と時間枠

理論上 400 MB の tarball を 25 Mbps で上げると約 2.5 分——TLS と再送を足すとだいたい倍です。webhook が多い時間帯を避け、切替ウィンドウ中はゲートウェイを叩くマーケ自動化を一時停止。APAC のチームは UTC 02:00 を選ぶことが多く、米トラフィックは落ち、EU の朝ピークはまだ始まっていません。

マルチホスト艦隊では署名付き成果物パイプラインを使います：tar を SSE-KMS の内部オブジェクトストレージに上げ、新しい Mac では 60 分 で期限切れのワンタイム URL で取得しオブジェクトを削除。長寿命の公開リンクを嫌う監査向けです。

復元後のスキルとプラグイン

~/.openclaw/skills のピン留めスキルはそのまま現れるはずですが、openclaw skills list でマニフェストと件数を比較してください。プラグインがインストール時にバイナリを引いた場合、Apple Silicon 先とアーキテクチャが一致するか確認します。不一致は最初の 3 件の自動タスク以内にログで spawn ENOEXEC として現れがちです——顧客向けチャネルが再接続する前に掴みましょう。

四半期ごとの「消防訓練」を文書化：先週のバックアップを新しい mini に復元し doctor を実行して解体。四半期 90 分 を投資するチームは実際の移行で Sev-2 が約 40% 減ったと報告しています（MacHTML テナントのポストモーテムレビュー）——主にマニフェストが正直だったためです。

可観測性も盲信移行しないでください。旧ホストがローカルファイルにログを出しているなら、切替前にシンク設定を複製しないと最初の 1 時間はデバッグ不能です。filebeat または macOS 向けエージェントを同じ Elasticsearch インデックスに向け、新しい host.name ラベルで 48 時間 エラー率を並べて比較できます。

最後に、紙の runbook PDF を残しましょう——クラウド企業でも皮肉ですが。DNS と VPN が壊れたとき、オフラインのチェックリストが届かない wiki に勝ちます。PDF の版文字列を OpenClaw の semver の横に置き、監査が文書と実行コードを対応づけられます。

FAQ

Dropbox で ~/.openclaw を同期してよいですか？

強く非推奨です。ファイルウォッチャーがゲートウェイと競合し、クラウド同期が JSON 保存の途中に割り込んだ事例があります。明示的なスケジュールバックアップを使ってください。

同じホスト名が必要ですか？

一部の webhook URL にホスト名が埋め込まれます。ホスト名が変わったら許可オリジンとコールバック URL を更新してください。チャネルをプロべれば doctor がすぐ不一致を示します。

Apple Silicon と Intel のアーカイブは互換ですか？

設定は移ります。スキル依存のネイティブバイナリは再ビルドが必要なことがあります。アーキテクチャを跨ぐ場合は npm rebuild に約 20 分 を見込んでください。

OpenClaw は下層の Mac が安定し、常時稼働し、スナップショットしやすいときに輝きます。Apple Silicon Mac mini はネイティブなキーチェーン挙動、予測可能な USB セキュリティキー対応、24/7 ゲートウェイ向けの静かな熱設計を提供し——インシデントのたびに新ハードを買う必要はありません。MacHTML は SSH/VNC 付きのベアメタルレンタルを提供し、捨て可能なホストでバックアップ/復元訓練を行い、勝ったイメージを昇格させ残りを退役できます。机の下に遊休機を置くより、弾力ある Mac 容量の方が合理的です。