🔐 Agent Vault

给你的 AI Agent 上一份保险。一句话，自动备份，永不丢失。

English · 快速开始 · 工作原理 · 灾难恢复

---

你花了几周甚至几个月，精心调教你的 AI Agent——

• 🧠 记忆 — Agent 记住了你的偏好、你的项目、你的决策风格
• 📝 知识库 — 积累了大量的专属知识和工作经验
• ⚙️ 配置 — 调了半天的 SOUL.md、AGENTS.md、cron 任务、工具权限
• 🔑 凭证 — API Key、Bot Token、Cookie、SSH 密钥

然后有一天——

服务器挂了。 硬盘坏了。VPS 到期忘续费。手贱 rm -rf 了。

全没了。从零开始。

---

现有的方案够用吗？

	openclaw backup	tar.gz 脚本	Agent Vault
存储位置	📁 同一台服务器	📁 同一台服务器	☁️ GitHub 异地
服务器挂了	❌ 备份一起没	❌ 备份一起没	✅ clone 恢复
自动化	手动执行	需自己配 cron	✅ 一句话搞定
备份大小	~500MB/次	~500MB/次	~20MB 总计
版本历史	❌	❌	✅ 完整 Git 历史
增量更新	❌ 每次全量	❌ 每次全量	✅ 只传变化
可浏览	解压才能看	解压才能看	✅ GitHub / Obsidian

Agent Vault 把备份这件事变成一句话：

快速开始

复制这句话给你的 AI Agent（OpenClaw、Claude Code、Cursor 等）：

帮我设置 Agent Vault：https://raw.githubusercontent.com/Panniantong/agent-vault-backup/main/docs/install.md

就这一步。 Agent 会自己完成剩下的所有事情：

🔍 检测环境... Git ✓  rsync ✓
🔑 GitHub CLI 已登录，创建私有仓库... ✓
🔧 部署同步脚本（发现 4 个 Agent）... ✓
⏰ 设置定时任务（每 30 分钟）... ✓
🚀 首次同步完成 — 47 个文件已推送
✅ Agent Vault 已启动！

从此以后，每 30 分钟，你所有 Agent 的数据自动同步到 GitHub 私有仓库。

没有 GitHub CLI？

没关系。Agent 会自动检测你的环境：

• ✅ 有 gh CLI 且已登录 → 全自动，不用你操心
• ✅ 有 SSH Key → Agent 让你去 GitHub 创建个私有仓库，给个 URL 就行
• ✅ 什么都没有 → Agent 手把手教你配 SSH Key（3 条命令）

备份了什么？

类别	内容	说明
🧠 Agent 记忆	SOUL.md、MEMORY.md、memory/、drafts/	所有 Agent 的 workspace
📚 共享知识库	shared-knowledge/	跨 Agent 共享的知识
🛠️ Skill 文档	skills/*.md	自定义技能文档
⚙️ 完整配置	openclaw.json、cron jobs	主配置 + 定时任务
🔑 凭证	API Key、Token、Cookie	灾难恢复必需

新增 Agent 自动纳入备份——不需要手动配置，sync 脚本每次运行时自动扫描所有 workspace。

日常使用

装完之后，这些话 Agent 都能听懂：

你说	Agent 做什么
"备份状态" / "backup status"	检查最近一次同步时间和状态
"立即备份" / "sync now"	立刻触发一次手动同步
"停止备份" / "stop backup"	移除定时任务

工作原理

系统 cron（每 30 分钟）
    ↓
sync.sh 扫描 ~/.openclaw/workspace*
    ↓
复制 .md + .json 文件到本地 vault
    ↓
git add → commit → push
    ↓
GitHub 私有仓库（异地备份）

为什么用系统 cron 而不是 OpenClaw cron？

因为 OpenClaw 挂了的时候，你最需要备份还在跑。 系统级 cron 不依赖 OpenClaw Gateway，更可靠。

为什么只同步 .md 和 .json？

Agent 的核心资产是记忆文件（.md）和配置（.json）。代码、venv、node_modules 这些丢了重装就行，不是不可替代的。这让备份保持在 ~20MB，而不是 500MB+。

灾难恢复

服务器挂了？5 分钟恢复：

# 1. 新机器装 OpenClaw
npm i -g openclaw

# 2. 克隆你的备份
git clone git@github.com:YOUR_USER/agent-vault.git ~/restore

# 3. 还原配置
cp -r ~/restore/config/* ~/.openclaw/

# 4. 还原 Agent 数据
cp -r ~/restore/agents/main/* ~/.openclaw/workspace/
# 对每个 agent 重复...

# 5. 还原共享知识库
cp -r ~/restore/shared-knowledge/ ~/.openclaw/shared-knowledge/

# 6. 启动
openclaw gateway start

用 Obsidian？装个 Obsidian Git 插件，把仓库 clone 下来，就能在本地随时浏览所有 Agent 的记忆。

⚠️ 安全

Agent Vault 备份的内容包含敏感信息（API Key、Bot Token、Cookie 等）。

• 安装时默认创建 Private 仓库
• 如果你手动提供仓库 URL，Agent 会自动验证是否为私有仓库
• 公开仓库会被拒绝配置
• ⚠️ 永远不要把仓库改为 Public

环境要求

• git + rsync（大部分 Linux 服务器已预装）
• GitHub 账号（免费版即可，私有仓库免费）
• GitHub CLI（gh）用于全自动设置，或 SSH Key 用于手动设置

卸载

帮我停止自动备份

Agent 会移除 cron 任务。本地 vault 数据和 GitHub 仓库不会被删除（需要的话手动删）。

贡献

这个项目源于我自己管理 7 个 OpenClaw Agent 的实际需求。如果你也在用 OpenClaw，欢迎：

• ⭐ Star 这个项目
• 🐛 遇到问题提 Issue
• 🔧 想加功能提 PR

License

MIT