~/.openclaw/workspaceにworkspace-mainまたはロールバック tarball を持たない別のエージェントごとのディレクトリ。この記事では、4 つのルートの「移行後記憶喪失」テーブル、必須ディレクトリとコピー禁止ディレクトリのリスト、ローカル tarball からローカル tarball への 6 つのステップを示します。openclaw doctorクラウド ホスト上、および大規模なワークスペースがマシンを Xcode 側のビルドと共有する場合の層デシジョン ツリー。と一緒にお読みください公式インストールデーモン,診断ラダー,チャンネルプローブ,永続性ベースライン、 そしてヘッドレス SSH のウォークスルーそのため、クラウド上で「構成のみ、メモリなし」を繰り返すことがなくなります。2026 OpenClaw は移行後の新しいエージェントのように感じます: 変更レコードに貼り付けることができる 4 つのルート
OpenClaw が保持する構成と資格情報下~/.openclaw/そして長期記憶、人格、スキルワークスペース ツリー内 (デフォルト~/.openclaw/workspace;マルチエージェントセットアップでは使用できるworkspace-{agentId}）。 2026.3.x あたりのコミュニティ レポートでは、単一のシステムからの移行について説明しています。workspaceエージェントごとのパスへMEMORY.mdとmemory/YYYY-MM-DD.md自動コピーされなかった: ゲートウェイは引き続き起動しますが、厳選されたメモリが空のディレクトリを読み取るため、「アップグレードにより脳が完全に消去されました」となります。 「構成の損失」と「ワークスペースの損失」を区別していないと、モデルの交換やチャネルの再配線に時間を費やすことになります。
2番目の根は、のscpopenclaw.jsonのみ、 それなしcredentials/,sessions/, and workspace files such asskills/,AGENTS.md、 そしてSOUL.md;ツールが最初のオンボードのように動作している間に、ダッシュボードが読み込まれる可能性があります。 3つ目はlaunchd 環境ドリフトと対話型シェル: pリストWorkingDirectoryまたはOPENCLAW_*雲が移動した後も、依然として古い道を指しています。 4つ目はスキップopenclaw doctor大きなバージョンギャップを越えて、スキーマの移行が中途半端なままになり、フィールドは黙ってデフォルトに戻ります。と揃える永続性ベースラインまず、状態ディレクトリがチーム同期フォルダー上に存在してはなりません。そうしないと、高頻度の小規模な書き込みにより、同期レイヤーでのロック競合が増幅されます。
コピーを使用しないエージェントごとのパス変更:古いworkspace/*ゲートウェイが空の場所を指している間、ディスク上に残ります。workspace-main.
ワークスペースなしの構成: openclaw.json現在、MEMORY.mdない。
デーモンの作業ディレクトリのドリフト:launchd は依然としてラップトップ パスまたは古いノード上の解放されたマウントを参照します。
ドクターなしのバージョンのギャップ:スキーマとバイナリの不一致。畑は静かに後退します。
デバイス トークンをポータブル ファイルとして扱う:コピーは失敗します。ターゲット上で再ペアリングし、個別にログに記録します。
後公式インストールデーモンクラウド ホストでは、移行の受け入れ時に次の 4 行がフリーズするはずです。ワークスペースの絶対パス、openclaw バージョン、ドクター終了コード、最初のビジネス メッセージ ID またはタイムスタンプ。リージョンまたは層を変更した場合は、これらの行の 1 つを更新し、ロールバック用に以前の tarball ハッシュを保持する必要があります。「おそらくバックアップした」のではありません。移行後にチャネルが誤動作する場合は、チャンネルプローブメモリディレクトリを非難する前に、リッスンポートとトークンの真実について。
プラットフォーム所有者は、「移行」テンプレートと「グリーンフィールド インストール」テンプレートを分割する必要があります。グリーンフィールドは空のワークスペースから開始できます。移行では、tarball チェックサムとドクター出力を添付する必要があります。テンプレートを混合すると、「空のメモリを受け入れる」がレビューのデフォルトのように見え、厳選されたメモリが消えたときに関係者にストーリーが残りません。
移行前のバックアップ リスト: パックする必要がある、パックするのが適切、生コピーはしない
目標は「ホームディレクトリ全体をtar化する」ことではありません。ターゲット上のゲートウェイがドクターの後に同じメモリとスキル境界を読み取る。必須の梱包物:~/.openclaw/openclaw.json,credentials/,sessions/セッションの継続性と、少なくとも以下を含む完全なワークスペース ツリーに依存する場合MEMORY.md,memory/,skills/、 そしてUSER.mdあなたのチームが実際にそれらを使用しているとき。必要に応じて、永続ログ シンクからローテーションされた 7 日間のログを含めて、診断ラダーただし、本番移行の tarball を巨大なログで肥大化させないでください。
以下の表を変更レコードの「移行パッケージの内容」フィールドに貼り付け、PATH チェックの横で実行します。ヘッドレス SSH のウォークスルー: tarball の中身を証明し、次にターゲットが何を読み取ったかを証明します。
| パス/オブジェクト | 必須 | クラウドMacのメモ |
|---|---|---|
| openclaw.json + 認証情報 | はい | 抽出後に権限を強化します。チームでフォルダーを同期しない |
| フルワークスペース (MEMORY、memory/、skills/) | はい | ターゲットのagentIdディレクトリ名と一致する |
| セッション/ | ポリシー | 大きなツリー: アクティブなサブセットのみを移行します |
| デバイストークン/キーチェーンアイテム | コピーしないでください | ターゲット上で再ペアリングする |
| LaunchAgent plist の上書き | 注意 | パスとラベルを修正し、デーモンを再インストールします |
tarball に MEMORY.md がない場合は、移行ではなく Gateway を再インストールすることを意味します。
記録shasum -a 256ソース上でそれを変更レコードに添付して、切り詰められた SCP 転送をキャッチします。 API 資格情報を保持する長期間有効なパブリック オブジェクト バケットではなく、承認された暗号化チャネル (要塞 rsync) を介してアーカイブを移動します。ワークスペースが数ギガバイトを超える場合（大規模なスキル アセットまたはメモリ ログ）、ターゲットSSD層転送前。これは、以下の M4 Pro デシジョン ツリーに直接関係します。
コマンド ブロック: ローカル tarball、アップロード、およびドクター前のパス チェック
バージョンを凍結された openclaw ビルドに置き換え、tarball を添付しますshasum -a 256変更記録に。確認するノードのメジャー バージョンの一致ソースとターゲットについて。それ以外の場合は、最初にターゲットにインストールしてからワークスペースを解凍し、「新しいバイナリ、古いメモリ」のハーフステートを回避します。 CLI がクラウド ホストにインストールされていない場合は、完了します。公式インストール開梱する前に、順序を逆にしないでください。
openclaw --version ls -la ~/.openclaw/workspace* tar -czf openclaw-migrate-$(date +%Y%m%d).tgz \ -C "$HOME" .openclaw/openclaw.json \ -C "$HOME" .openclaw/credentials \ -C "$HOME" .openclaw/workspace shasum -a 256 openclaw-migrate-*.tgz scp openclaw-migrate-*.tgz user@cloud-mac:~/ ssh user@cloud-mac 'openclaw gateway stop || true' ssh user@cloud-mac 'tar -xzf openclaw-migrate-*.tgz -C $HOME && openclaw doctor'
ヒント：のためにworkspace-mainまたは他のエージェントごとのフォルダーの場合は、tar を変更します-C本当の自分への道workspace-*名前;非対話型の PATH チェックをヘッドレス SSH のウォークスルー.
しないでくださいgateway start抽出直後: 実行openclaw doctor、完全な標準出力を変更レコードに保存し、比較しますMEMORY.mdソースのタイムスタンプ。医師がワークスペース パスの移行を提案すると、上書きではなくマージただし、レコードが空のメモリを明示的に受け入れない場合は除きます。 plist パスがマージ中の空のディレクトリを指さないように、doctor が通過した後でのみ install-daemon を実行します。
6 つのステップ: ローカル パックからクラウド Mac 上の最初のメッセージまでのロールバックに適したパス
バージョンを凍結し、ワークスペースのパスを記録します。捕獲openclaw --versionそしてls ~/.openclaw/workspace*変更記録にあります。
ソース ゲートウェイを停止し、tarball をビルドします。json、認証情報、完全なワークスペース。 sha256と書きます。
非同期ターゲット パスを準備します。ルート空き領域は少なくとも解凍サイズの 1.5 倍。
ターゲット ゲートウェイをアップロードして停止します。抽出中の二重書き込みセッションを回避します。
ドクターが次にデーモンをインストールします。plist の真実を公式パス.
最初のメッセージの受け入れ:MEMORY スニペット、有線の場合はチャネル プローブ、1 行のゲートウェイ健全性 JSON。
6 つのステップが完了すると、チケットは、tarball の内容、ワークスペースのパス、ドクターの結果、または層のどのレバーが動いたかを答える必要があります。 KVMNODE 領域のみの移動でも、tarball をアーティファクト ストレージにアーカイブする必要があります。リージョンの変更により、IP および下りポリシーが変更されることがよくあります;ロールバックには空のゲートウェイではなく、メモリと構成が必要です。受け入れ週中のスナップショットopenclaw doctor毎日、フィールドを L1/L2 にマップします。診断ラダー.
リージョンとレベル: ワークスペース、スキル、および Xcode が 1 つのホストを共有する場合の M4 と M4 Pro
ワークスペースの増加は、CPU よりも先にディスクに到達することがよくあります。memory/*.mdファイル、スキル リポジトリ、並列ダウンロードのストレスディスク IOPS とユニファイド メモリ ページ キャッシュ。移行後に Xcode または Flutter アーカイブが同じ専用ホストで実行される場合、追跡解凍後のルート使用率、ゲートウェイの健全性 P95、並列ビルド時のメモリ負荷受付週間中。
解凍されたワークスペースのサイズ:30 GB を超えるか、毎週の増加が 5 GB を超える場合は、階層がジャンプする前にメモリとスキル アセットをローテーションします。
統合メモリのプレッシャー:ログmemory pressureビルドとゲートウェイが同時にピークに達したときのイベント。調達にカウントを加えます。
地域とRTT:tarball の到着はデータプレーンのコロケーションではありません。M4 Pro をロックする前に Git とアーティファクトを調整します。
| プロフィール | M4 16GB/256 | 24GB/512 | M4 Pro ハイユニファイド メモリ |
|---|---|---|---|
| 軽量ワークスペース + 単一ゲートウェイ | わかりました | より安全 | 過剰な場合が多い |
| 大容量メモリ + 多くのスキル + 毎日の記憶ログ | リスク | 好ましい | 並列処理に依存 |
| iOS CI とエージェントを使用した移行週間 | 推奨されません | 中くらい | 好ましい |
注記：「クラウドへの移動」はバックアップではありません。再構築やリージョンの移動により、ローカル ディスクが消去される可能性があります。 tarball の保持はチーム ポリシーである必要があります。
個人の Mac が唯一のバックアップ ソースとしてのメリット予測できないバックアップ時間枠まぶたを閉じて睡眠し、収縮性のない7×24の受け入れ。ラップトップ上の cron は、ユーザーの切り替えと許可のプロンプトで中断されます。スリープの多いノートブックは、移行後の継続的なメモリ ログの書き込みには適していません。 OpenClaw メモリとゲートウェイ用の、監査可能でリージョンに柔軟性があり、階層アップグレード可能な専用ホストを必要とするチームの場合、通常、KVMNODE Mac Mini クラウド レンタルの方が適しています。：専用の Apple Silicon、6 つのリージョン、日から月までの期間、および「パック-アンパック-ドクター」と CI の同じ配置言語。注文方法注文ページ、ランブックのヘルプセンター、SKU価格設定.