Git-Crypt 备份

将 Clawdbot 工作区（~/clawd）和配置（~/.clawdbot）自动备份到 GitHub，敏感文件通过 git-crypt 加密。

设置

1. 创建 GitHub 仓库（建议设为私有）

bash

在 GitHub 上创建两个私有仓库：

- <用户名>/clawdbot-workspace

- <用户名>/clawdbot-config

2. 初始化 git-crypt

bash

安装 git-crypt

brew install git-crypt # macOS

apt install git-crypt # Linux

工作区仓库

cd ~/clawd git init git-crypt init git remote add origin git@github.com:<用户名>/clawdbot-workspace.git

配置仓库

cd ~/.clawdbot git init git-crypt init git remote add origin git@github.com:<用户名>/clawdbot-config.git

3. 配置加密规则

工作区 .gitattributes：

SOUL.md filter=git-crypt diff=git-crypt
USER.md filter=git-crypt diff=git-crypt
HEARTBEAT.md filter=git-crypt diff=git-crypt
MEMORY.md filter=git-crypt diff=git-crypt
memory/ filter=git-crypt diff=git-crypt

配置 .gitattributes：

clawdbot.json filter=git-crypt diff=git-crypt
.env filter=git-crypt diff=git-crypt
credentials/ filter=git-crypt diff=git-crypt
telegram/ filter=git-crypt diff=git-crypt
identity/ filter=git-crypt diff=git-crypt
agents//sessions/ filter=git-crypt diff=git-crypt
nodes/ filter=git-crypt diff=git-crypt

配置 .gitignore：

*.bak
.bak.
.DS_Store
logs/
media/
browser/
subagents/
memory/
update-check.json
*.lock

4. 导出密钥（重要！）

bash
mkdir -p ~/clawdbot-keys
cd ~/clawd && git-crypt export-key ~/clawdbot-keys/workspace.key
cd ~/.clawdbot && git-crypt export-key ~/clawdbot-keys/config.key

⚠️ 安全存储这些密钥（1Password、iCloud 钥匙串、U盘等）

5. 首次提交并推送

bash
cd ~/clawd && git add -A && git commit -m 初始备份 && git push -u origin main
cd ~/.clawdbot && git add -A && git commit -m 初始备份 && git push -u origin main

每日备份

运行 scripts/backup.sh：

bash
~/clawd/skills/git-crypt-backup/scripts/backup.sh

或设置 cron 任务实现自动每日备份。

在新机器上恢复

bash

1. 克隆仓库

git clone git@github.com:<用户名>/clawdbot-workspace.git ~/clawd
git clone git@github.com:<用户名>/clawdbot-config.git ~/.clawdbot

2. 使用密钥解锁

cd ~/clawd && git-crypt unlock /path/to/workspace.key cd ~/.clawdbot && git-crypt unlock /path/to/config.key

加密内容说明

仓库	加密内容	明文内容
工作区	SOUL/USER/HEARTBEAT/MEMORY.md, memory/	AGENTS.md, IDENTITY.md, TOOLS.md, drafts/
配置

clawdbot.json, .env, credentials/, sessions/ | cron/jobs.json, settings/ |