OpenClawバックアップ作成ガイド：設定とデータを安全に保存

開発を進めていると、ツールの設定やセッション情報が突然消えてしまう不安を感じることはありませんか？環境の移行やトラブルへの備えとして、確実なバックアップ手段を持っておくことは非常に重要です。

OpenClawでは、簡単なコマンドで現在の状態をまるごと保存できます。万が一の時に備えて、バックアップの仕組みを理解しておきましょう。

openclaw backup

OpenClawの state、config、credentials、sessions、そしてオプションで workspaces を含むローカルバックアップアーカイブを作成します。

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はデフォルトのアーカイブ保存先としてホームディレクトリを使用します。
• 既存のアーカイブファイルが上書きされることはありません。
• 自己包含を避けるため、ソースの state や workspace ツリー内の出力パスは拒否されます。
• openclaw backup verify <archive> は、アーカイブにルートマニフェストが1つだけ含まれていることを確認し、トラバーサル形式のパスを拒否し、マニフェストに記載されたすべてのペイロードが tarball 内に存在することをチェックします。
• openclaw backup create --verify を実行すると、アーカイブの書き込み直後にその検証を実行します。
• openclaw backup create --only-config は、アクティブな JSON 形式の config ファイルのみをバックアップします。

バックアップの対象

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

• OpenClaw のローカル state リゾルバによって返される state ディレクトリ（通常は ~/.openclaw）
• アクティブな config ファイルのパス
• OAuth および credentials ディレクトリ
• 現在の config から検出された workspace ディレクトリ（--no-include-workspace を指定した場合を除く）

--only-config を使用した場合、OpenClaw は state、credentials、workspace の探索をスキップし、アクティブな config ファイルのパスのみをアーカイブします。

OpenClaw はアーカイブを作成する前にパスを正規化します。もし config、credentials、workspace がすでに state ディレクトリ内に存在する場合、それらが個別のトップレベルソースとして重複して保存されることはありません。存在しないパスはスキップされます。

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

設定ファイルが無効な場合の挙動

openclaw backup は、リカバリ作業を助けるために、通常の config プリフライトチェックを意図的にバイパスします。ただし、workspace の探索は有効な config に依存しているため、config ファイルが存在していても内容が無効で、かつ workspace のバックアップが有効なままである場合、openclaw backup create は即座に失敗します。

そのような状況でも部分的なバックアップを取得したい場合は、以下のコマンドを再実行してください。

openclaw backup create --no-include-workspace

これにより、workspace の探索を完全にスキップしつつ、state、config、credentials をバックアップ対象に含めることができます。

config ファイル自体のコピーだけが必要な場合は、--only-config も有効です。このオプションは workspace 探索のために config をパースする必要がないため、config が不正な形式であっても動作します。

サイズとパフォーマンス

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

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

• 一時的なアーカイブ書き込みと最終的なアーカイブのための空き容量
• 大きな workspace ツリーをスキャンし、.tar.gz に圧縮するために必要な時間
• openclaw backup create --verify や openclaw backup verify を実行した際のアーカイブ再スキャン時間
• 保存先パスのファイルシステムの挙動。OpenClaw は上書きなしのハードリンクによる公開ステップを優先しますが、ハードリンクがサポートされていない場合は排他的コピーにフォールバックします。

アーカイブのサイズが大きくなる主な要因は、通常、巨大な workspace です。より小さく、より高速にバックアップを行いたい場合は、--no-include-workspace を使用してください。

最もコンパクトなアーカイブを作成するには、--only-config を使用します。

次のステップ

• OpenClaw の設定ガイド
• Workspace の管理方法

AI Setup Assistant