最終更新: 2026年3月 · ソース: openclaw-backup

暗号化状態アーカイブ

OpenClaw ワークスペースとローカルプロジェクトを Google Drive へ自動で暗号化・重複排除バックアップ — 暗号化とスナップショット管理に restic、トランスポートに rclone、暗号化パスワードは macOS キーチェーンに保管。

← モジュール概要

概要

openclaw-backup は OpenClaw ワークスペースとローカルプロジェクトディレクトリの増分・暗号化・時点スナップショットを作成し、Google Drive に保存します。各バックアップ実行で新しいスナップショットが追加され、変更されていないブロックは重複排除されるため、変更されたデータのみがアップロードされます。保持ポリシーにより古いスナップショットは自動的に削除されます。暗号化パスワードはディスクに触れることなく、実行のたびに macOS キーチェーンから取得されます。

目的

エージェントシステムは再構築が難しい状態を蓄積します：数ヶ月のセッションで構築されたメモリファイル、進行中のプロジェクトコード、チューニングに時間を要した設定。バックアップなしのディスク障害・誤削除・ワークスペース破損は、その状態の完全な喪失を意味します。

標準のクラウド同期ツール（iCloud、Dropbox）はアップロード前に暗号化せず、スナップショット履歴を追跡せず、重複排除も行いません。「3 日前のワークスペースの状態」に復元することはできず、現在の同期済み状態にしか戻れません。restic はこの 3 つの問題を全て解決します：クライアントサイド暗号化（Google Drive が見るのは暗号文のみ）、コンテンツアドレス型重複排除（高速な増分）、設定可能な保持ポリシーを持つ不変の時点スナップショット。

アーキテクチャ

各バックアップ実行で 2 つのレイヤーが協調します：

~/.openclaw/  ──┐
               ├──▶ restic（暗号化 + 重複排除）──▶ rclone ──▶ Google Drive
~/projects/   ──┘

バックアップ対象：

除外対象（バックアップ対象外）：

• node_modules/ — package.json から再インストール可能
• .venv/ — 再作成可能な Python 環境
• browser/ — Chromium バイナリキャッシュ
• .git/objects — 既に GitHub 上にある

保持ポリシー：

古いスナップショットは各バックアップ実行の最後に自動的に削除されます。

主要な設計上の決定

自分でビルドする方法

セキュリティ

• ハードコードされたシークレットなし — 全認証情報は macOS キーチェーンまたは環境変数を使用
• restic はアップロード前に全データを暗号化；Google Drive が保存するのは暗号文のみ
• rclone 設定の OAuth トークンは .gitignore で git から除外
• test.sh が git 管理下の全ファイルをシークレットスキャン