Skip to main content
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 はホームディレクトリをデフォルトの出力先としてフォールバックします。
  • 既存のアーカイブファイルを上書きすることはありません。
  • 自己包含（無限ループ）を避けるため、ソース状態やワークスペースツリー内のパスを出力先として指定することはできません。
  • openclaw backup verify <archive> は、アーカイブに正確に 1 つのルートマニフェストが含まれているか、ディレクトリトラバーサル攻撃のような不正なパスが含まれていないか、およびマニフェストに記載されたすべてのデータが実際にアーカイブ内に存在するかを検証します。
  • openclaw backup create --verify は、アーカイブの書き込み直後に上記の検証を自動的に実行します。
  • openclaw backup create --only-config は、有効な JSON 構成ファイルのみをバックアップします。

​
バックアップの対象

openclaw backup create は、ローカルの OpenClaw インストール環境から以下のソースをバックアップ対象として計画します:
  • OpenClaw のローカル状態リゾルバーによって返される状態ディレクトリ（通常は ~/.openclaw）。
  • 有効な構成ファイルのパス。
  • OAuth および認証情報（credentials）ディレクトリ。
  • --no-include-workspace を指定しない限り、現在の構成から検出されたワークスペースディレクトリ。
--only-config を使用した場合、状態、認証情報、ワークスペースの検出はスキップされ、有効な構成ファイルのみがアーカイブされます。 OpenClaw はアーカイブ構築前にパスを正規化します。構成、認証情報、またはワークスペースがすでに状態ディレクトリ内に存在する場合、それらが個別のトップレベルソースとして重複してアーカイブされることはありません。存在しないパスはスキップされます。 アーカイブにはこれらのソースツリー内のファイル内容が保存され、同梱の manifest.json には解決された絶対ソースパスと、各資産に使用されたアーカイブレイアウトが記録されます。

​
構成が無効な場合の動作

openclaw backup は、リカバリ（復旧）時にも役立つよう、通常の構成チェックを意図的にバイパスします。ただし、ワークスペースの検出は有効な構成内容に依存するため、構成ファイルが存在するものの内容が無効で、かつワークスペースのバックアップが有効な場合、openclaw backup create はエラーで即座に終了します。 そのような状況で部分的なバックアップを行いたい場合は、以下のコマンドを再実行してください: 
openclaw backup create --no-include-workspace
これにより、ワークスペースの検出をスキップしつつ、状態、構成、および認証情報をバックアップ対象に含めることができます。 構成ファイル自体のコピーのみが必要な場合は、構成の解析を必要としない --only-config フラグも有効です。

​
サイズとパフォーマンス

OpenClaw は、バックアップの最大サイズやファイルごとのサイズ制限を設けていません。 実質的な制限は、ローカルマシンの性能と出力先のファイルシステムに依存します:
  • 一時的なアーカイブ書き込み用および最終的なアーカイブ用の空き容量。
  • 大規模なワークスペースツリーを走査し、.tar.gz に圧縮するために要する時間。
  • --verify を使用した場合のアーカイブの再スキャン時間。
  • 出力先ファイルシステムの動作。OpenClaw は上書きなしのハードリンクによる公開を優先しますが、ハードリンクがサポートされていない場合は排他的コピーにフォールバックします。
アーカイブサイズが大きくなる主な要因は、通常、大規模なワークスペースです。バックアップを小さく、あるいは高速に完了させたい場合は、--no-include-workspace を使用してください。 最も小さなアーカイブを作成するには --only-config を使用します。