OpenClaw Backup スキルガイド

OpenClaw Backup スキル概要

Backupスキルは、OpenClawエージェントに設定全体のスナップショットと復元機能を提供します — スキル、コマンド、設定、MCP統合、コンテキスト、テンプレートすべてを、自然言語でのリクエスト一つで操作できます。アップデートの失敗やスキルの設定ミスで動作していたセットアップを失ったことがあるなら、これはまさに必要な安全策です。

OpenClawの設定は ~/.claude/ 配下の複数のディレクトリとファイルに分散しています。何が変わったかを手動で追跡するのは面倒でミスが起きやすい作業です。OpenClaw Backupスキルはプロセス全体を自動化します：タイムスタンプ付きの tar.gz アーカイブを作成し、選択的なバックアップモードをサポートし、Git、rsync、またはDropboxやGoogle Driveなどのクラウドストレージを使ってデバイス間で設定を同期できます。

典型的なワークフロー：

1. 新しいスキルをインストールする前に、OpenClawに現在のセットアップをバックアップするよう依頼。
2. エージェントが設定をタイムスタンプ付きアーカイブにパッケージし、~/openclaw-backups/ に保存。
3. 何か問題が起きたら、OpenClawに最新のバックアップから復元するよう依頼 — 数秒で動作状態に戻ります。

このスキルは、設定変更をリアルタイムで検証する Config Guardian スキルや、バックアップに含まれるAPIトークンを安全に管理する 1Password スキルと相性が良いです。

Backup スキルの前提条件

Backupスキルをインストールする前に、以下を確認してください：

• OpenClaw がインストール済みで動作中（v1.0+）
• バックアップアーカイブ用の十分なディスク容量（スキル数に応じて通常5〜50 MB/スナップショット）
• スキル管理用の clawhub CLI がインストール済み
• Git（オプション）— バージョン管理されたバックアップ履歴が必要な場合のみ

環境を確認：

# OpenClaw バージョンを確認
openclaw --version

# 利用可能なディスク容量を確認
df -h ~/openclaw-backups

# clawhub CLI を確認
clawhub --version

Backup スキルのインストール方法

ワンコマンドでBackupスキルをインストール：

npx clawhub@latest install backup

インストールを確認：

clawhub list

インストール済みスキルのリストに backup が表示されるはずです。clawhub CLI でのインストールが最速です。

Backup スキルの設定

Backupスキルはデフォルト設定ですぐに使えます。環境変数で動作をカスタマイズできます。

環境変数の設定

# カスタムバックアップディレクトリ（デフォルト：~/openclaw-backups）
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# バックアップの最大保持数（デフォルト：7）
export OPENCLAW_BACKUP_RETENTION=7

# アップデート前の自動バックアップを有効化（デフォルト：true）
export OPENCLAW_BACKUP_AUTO=true

バックアップ対象

スキルはデフォルトで以下のディレクトリとファイルをアーカイブします：

| パス | 内容 | |------|------| | ~/.claude/skills/ | インストール済みスキル定義 | | ~/.claude/commands/ | カスタムコマンド | | ~/.claude/settings.json | エージェント設定と環境設定 | | ~/.claude/mcp/ | MCPサーバー設定 | | ~/.claude/contexts/ | セッションコンテキスト | | ~/.claude/templates/ | カスタムテンプレート |

キャッシュとログファイルは自動的に除外されます — 起動時に再生成されるため、アーカイブを肥大化させるだけです。

重要： バックアップアーカイブには、設定やMCP設定に保存されたAPIトークン、シークレット、認証情報が含まれる場合があります。バックアップは安全な場所に保存し、公開リポジトリには絶対にコミットしないでください。

Backup スキルの使用例

1. 完全バックアップの作成

あなた： 「新しいKubernetesスキルをインストールする前に、OpenClawのセットアップ全体をバックアップして。」

エージェントがタイムスタンプ付きアーカイブ（例：openclaw-2026-03-13_1045.tar.gz）を作成し、すべての設定ファイルを含めます。完了後、アーカイブパス、ファイルサイズ、アイテム数を報告します。

2. スキルのみの選択的バックアップ

あなた： 「インストール済みスキルだけバックアップして、いくつか削除テストしたい。」

エージェントがスキルのみのバックアップを実行し、~/.claude/skills/ ディレクトリのみをアーカイブします。スキル定義の保護だけが必要な場合、より高速で小さなファイルになります。

3. バックアップからの復元

あなた： 「アップデート後に何か壊れた。最新のバックアップから復元して。」

エージェントが利用可能なバックアップを一覧表示し、最新のもののタイムスタンプと内容を表示して、復元前に確認を求めます。まずアーカイブの整合性を検証してから、エージェントを停止し、現在の設定を置き換えて再起動 — 動作状態が復元されます。

4. バックアップの一覧と管理

あなた： 「全バックアップと使用容量を表示して。」

エージェントがバックアップディレクトリ内のすべてのアーカイブを日付順にファイルサイズ付きで一覧表示します。保持期間を超えた古いバックアップにフラグを立て、クリーンアップを提案します。

5. リモートへのバックアップ同期

あなた： 「最新のバックアップをGitバックアップリポにプッシュして。」

エージェントが最新アーカイブを設定済みのGitリポジトリにコミットしてリモートにプッシュします。これによりバージョン履歴とマルチデバイスアクセスが可能になります — 別のマシンでリポジトリをクローンすれば、任意のスナップショットから復元できます。

Backup セキュリティとベストプラクティス

バックアップアーカイブにはOpenClawの完全な設定が含まれ、機密データが含まれる可能性があります。以下のガイドラインに従って安全を確保してください：

• 機密バックアップを暗号化。 設定にAPIキーやトークンが含まれる場合、クラウドストレージに保存する前にアーカイブを暗号化してください。gpg またはシークレットマネージャーを使用してください。
• ファイル権限を制限。 バックアップファイルを現在のユーザーのみ読み取り可能に：chmod 700 ~/openclaw-backups。
• バックアップを公開リポジトリにコミットしない。 ~/openclaw-backups/ をグローバル .gitignore に追加して偶発的な露出を防止。
• 古いバックアップをローテーション。 OPENCLAW_BACKUP_RETENTION を設定して古いアーカイブを自動クリーンアップ。ほとんどのセットアップで7つのバックアップが妥当なデフォルトです。
• 定期的に復元を検証。 実際に必要になる前に復元プロセスをテストしてください。一時ディレクトリに復元してアーカイブの整合性を確認。
• Config Guardian とBackupを併用。 Config Guardianはリアルタイムで変更を検証し、Backupはポイントインタイムリカバリを提供します。両方で完全な安全網を形成します。安全チェックリストでOpenClawの一般的なセキュリティガイダンスを確認してください。

Backup よくあるエラーのトラブルシューティング

"No backups found in ~/openclaw-backups"

バックアップディレクトリが空か存在しません。

1. ディレクトリの存在を確認：

ls -la ~/openclaw-backups

2. パスをカスタマイズした場合、OPENCLAW_BACKUP_DIR が正しく設定されているか確認：

echo $OPENCLAW_BACKUP_DIR

3. OpenClawに最初のバックアップを作成させてください：「今すぐ設定をバックアップして。」

"Permission denied when creating backup archive"

バックアップディレクトリに書き込み権限がありません。

# 権限を修正
chmod 700 ~/openclaw-backups

# またはディレクトリが存在しない場合は作成
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

アーカイブが保存または転送中に破損しました。

1. アーカイブの整合性をテスト：

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. 破損している場合、保持リスト内の前のバックアップを試してください。
3. Git同期バックアップの場合、古いコミットに正常なアーカイブがないか確認：バックアップリポジトリで git log --oneline を実行。