openclaw backup

OpenClawの状態、設定、認証情報、セッション、およびオプションでワークスペースのローカルバックアップアーカイブを作成します。

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

補足

  • アーカイブには、解決済みのソースパスとアーカイブレイアウトが記録されたmanifest.jsonファイルが含まれます。
  • デフォルトの出力先は、現在の作業ディレクトリにタイムスタンプ付きの.tar.gzアーカイブです。
  • 現在の作業ディレクトリがバックアップ対象のソースツリー内にある場合、デフォルトのアーカイブ保存先としてホームディレクトリにフォールバックします。
  • 既存のアーカイブファイルは上書きされません。
  • ソースの状態/ワークスペースツリー内への出力パスは、自己包含を防ぐために拒否されます。
  • openclaw backup verify <archive>は、アーカイブにルートマニフェストが1つだけ含まれていることを検証し、パストラバーサル形式のアーカイブパスを拒否し、マニフェスト宣言されたすべてのペイロードがtarball内に存在することを確認します。
  • openclaw backup create --verifyは、アーカイブ書き込み直後にその検証を実行します。
  • openclaw backup create --only-configは、アクティブなJSON設定ファイルのみをバックアップします。

バックアップ対象

openclaw backup createは、ローカルのOpenClawインストールからバックアップソースを計画します：

  • OpenClawのローカル状態リゾルバーが返す状態ディレクトリ（通常~/.openclaw）
  • アクティブな設定ファイルパス
  • OAuth / 認証情報ディレクトリ
  • 現在の設定から検出されたワークスペースディレクトリ（--no-include-workspaceを指定しない場合）

--only-configを使用すると、状態、認証情報、ワークスペースの検出をスキップし、アクティブな設定ファイルパスのみをアーカイブします。

OpenClawはアーカイブ構築前にパスを正規化します。設定、認証情報、またはワークスペースが既に状態ディレクトリ内にある場合、別のトップレベルバックアップソースとして重複しません。存在しないパスはスキップされます。

アーカイブペイロードにはソースツリーのファイル内容が格納され、埋め込みのmanifest.jsonに解決済みの絶対ソースパスと各アセットのアーカイブレイアウトが記録されます。

無効な設定の動作

openclaw backupは、リカバリ時にも役立てるよう、通常の設定プリフライトを意図的にバイパスします。ワークスペースの検出は有効な設定に依存するため、openclaw backup createは設定ファイルが存在するが無効で、かつワークスペースバックアップがまだ有効な場合に即座に失敗します。

その場合に部分的なバックアップが必要なら、以下を再実行してください：

openclaw backup create --no-include-workspace

これにより、状態、設定、認証情報はスコープに含まれたまま、ワークスペースの検出は完全にスキップされます。

設定ファイル自体のコピーのみが必要な場合、--only-configはワークスペース検出のための設定解析に依存しないため、設定が不正な形式でも動作します。

サイズとパフォーマンス

OpenClawは組み込みの最大バックアップサイズやファイルごとのサイズ制限を設けていません。

実際の制限はローカルマシンと保存先ファイルシステムに依存します：

  • 一時アーカイブ書き込みと最終アーカイブに必要な空き容量
  • 大規模なワークスペースツリーを走査して.tar.gzに圧縮する時間
  • openclaw backup create --verifyやopenclaw backup verifyを使用する場合のアーカイブ再スキャン時間
  • 保存先パスでのファイルシステムの動作。OpenClawは上書きなしのハードリンクパブリッシュステップを優先し、ハードリンクがサポートされていない場合は排他コピーにフォールバックします

大規模なワークスペースがアーカイブサイズの主な要因になることが通常です。より小さく高速なバックアップが必要な場合は--no-include-workspaceを使用してください。

最小のアーカイブには--only-configを使用してください。

次へ
Overview
arrow_forward