baidu-drive-backup
基于百度网盘的 OpenClaw 记忆备份和恢复插件。
将本地 AI Agent 的记忆文件（Markdown 日记、常青记忆、人格配置、向量索引等）自动或手动备份到百度网盘云端，支持按日期恢复到本地，保障 Agent 记忆数据的安全性和可迁移性。
当前支持 OpenClaw（memory-core 记忆系统）。支持平台：macOS、Linux、Windows (WSL2)。
目录
快速上手
# 1. 卸载旧版插件（如有）
openclaw plugins uninstall baidu-drive-backup --force
# 2. 安装插件（将 xxx 替换为实际下载的 zip 文件路径）
openclaw plugins install baidu-drive-backup-1.0.5.zip
# 3. 开启自动备份
openclaw setup-autobackup enable
> 如果开启失败，请按照命令行引导提示完成前置依赖安装配置。可通过 `openclaw setup-autobackup status` 查看前置依赖是否全部满足。
# 4. 重启使插件生效（必须！否则自动备份不会生效）
openclaw gateway restart
功能特性
| 特性 | 说明 |
|---|---|
| 自动备份 | 记忆变更后自动上传到百度网盘，防抖合并高频触发，每天仅保留最新一次 |
| 手动备份 | 通过 CLI 或自然语言一键全量备份，每次生成独立的时间戳快照 |
| 备份列表 | 查看网盘上所有可用备份，展示 auto/manual 两种类型 |
| 精确恢复 | 按日期或精确时间戳恢复，支持模糊匹配和 --force 跳过兼容性校验 |
| 安全恢复 | 恢复前自动创建本地备份，防止误操作丢失数据 |
| 增量备份 | 首次全量上传，后续仅上传变更文件（SHA-256 比对） |
安装
前置依赖
| 工具 | 用途 | 安装方式 |
|---|---|---|
openclaw | Agent 运行环境 | 参考OpenClaw 安装文档 |
bdpan | 百度网盘 CLI | 安装插件时自动检测并引导安装；也可提前手动安装：bash <(curl -fsSL https://issuecdn.baidupcs.com/issue/netdisk/ai-bdpan/install.sh) --skip-checksum |
安装 bdpan 后需登录百度网盘：
bdpan login
安装插件
下载最新版 baidu-drive-backup-1.0.5.zip 。安装前建议先卸载旧版本，避免版本冲突。
# 1. 卸载旧版（首次安装可跳过）
openclaw plugins uninstall baidu-drive-backup --force
# 2. 安装插件
openclaw plugins install baidu-drive-backup-1.0.5.zip
# 3. 开启自动备份
openclaw setup-autobackup enable
> 如果开启失败，请按照命令行引导提示完成前置依赖安装配置。可通过 `openclaw setup-autobackup status` 查看前置依赖是否全部满足。
# 4. 重启 OpenClaw 使插件生效
openclaw gateway restart
卸载
openclaw plugins uninstall baidu-drive-backup --force
手动备份与恢复
注意：以下带有
@skills/前缀的命令需在 OpenClaw 对话框中执行（不是终端）。openclaw setup-autobackup等命令则在终端执行。
备份
通过 CLI 进行全量备份（写入 manual/ 目录，不受每日覆盖策略影响）：
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh backup
或在 OpenClaw 中直接说「帮我备份当前记忆」。
备份内容：
| 文件类型 | 本地路径 | 说明 |
|---|---|---|
| 每日记忆 | ~/.openclaw/workspace/memory/*.md | 日记 + 常青记忆 |
| MEMORY.md | ~/.openclaw/workspace/MEMORY.md | 长期记忆摘要 |
| AGENTS.md | ~/.openclaw/workspace/AGENTS.md | Agent 操作指令 |
| SOUL.md | ~/.openclaw/workspace/SOUL.md | 人格/语气/边界定义 |
| USER.md | ~/.openclaw/workspace/USER.md | 用户身份信息 |
| IDENTITY.md | ~/.openclaw/workspace/IDENTITY.md | Agent 名字/风格 |
| 向量索引 | ~/.openclaw/memory/*.sqlite | 语义搜索索引 |
查看备份列表
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh list
指定自定义网盘路径查看：
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh list --path "我的应用数据/bdpan/custom-backup"
输出示例：
📋 可用备份列表（设备: macbook-air）
# 日期 类型 文件数 包含索引 Agent
1 2026-03-27T14-30-00 auto 15 ✓ openclaw
2 2026-03-27T10-00-00 manual 15 ✓ openclaw
3 2026-03-26T08-15-22 auto 12 ✓ openclaw
共 3 个备份
恢复记忆
# 模糊匹配日期
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh restore 2026-03-27
# 精确时间戳恢复
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh restore 2026-03-27T14-30-00
# 跳过兼容性校验强制恢复
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh restore 2026-03-27 --force
# 从自定义网盘路径恢复
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh restore 2026-03-27 --path "我的应用数据/custom-backup"
恢复策略（Merge）：同名文件用备份覆盖，本地多余文件保留，备份中多出的文件直接拷贝。
恢复前会自动将当前本地记忆备份到
~/.openclaw/workspace/.backup-before-restore/<timestamp>/，可随时找回。
自然语言触发
安装后 OpenClaw 自动注册 /baidu_drive_backup 斜杠命令：
/baidu_drive_backup 备份一下记忆
/baidu_drive_backup 看看有哪些备份
/baidu_drive_backup 恢复 2026-03-20 的记忆
也支持直接用自然语言（无需斜杠命令）：
| 用户指令 | 对应操作 |
|---|---|
| 「帮我备份当前记忆」 | backup |
| 「查看我的记忆备份」 | list |
| 「恢复3月16号的记忆」 | restore 2026-03-16 |
| 「把记忆存到网盘」 | backup |
| 「恢复昨天的记忆」 | restore<yesterday> |
查看版本号
bash @skills/baidu-drive-backup/scripts/baidu-drive-backup.sh --version
自动备份配置
【说明】打开自动备份，插件在 setup 时会修改 openclaw.json 中的 hooks.internal.enabled = true，这是全局设置。
插件安装后需要通过 setup-autobackup 命令开启自动备份。提供两种使用方式：
方式一：Bash 命令行（openclaw setup-autobackup）
在终端中直接执行，适用于脚本化部署和 CI 场景：
# 查看当前配置状态
openclaw setup-autobackup status
# 开启自动备份（同时启用 OpenClaw Hook 分发）
openclaw setup-autobackup enable
> 如果开启失败，请按照命令行引导提示完成前置依赖安装配置。可通过 `openclaw setup-autobackup status` 查看前置依赖是否全部满足。
# 关闭自动备份
openclaw setup-autobackup disable
status 输出示例：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
baidu-drive-backup 配置状态
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
自动备份：已开启
环境校验：通过
bdpan CLI：已安装
百度网盘：已登录
方式二：OpenClaw TUI 斜杠命令（/setup-autobackup）
在 OpenClaw 交互界面中输入斜杠命令：
/setup-autobackup status 查看当前配置状态
/setup-autobackup enable 开启自动备份
> 如果开启失败，请按照命令行引导提示完成前置依赖安装配置。可通过 `/setup-autobackup status` 查看前置依赖是否全部满足。
/setup-autobackup disable 关闭自动备份
网盘存储结构
/apps/bdpan/agent-memory/
└── openclaw/ # Agent 类型
└── <device>/ # 设备名（如 macbook-air）
├── auto/ # 自动备份（每日覆盖）
│ └── 2026-03-27T14-30-00/
│ ├── manifest.json
│ ├── MEMORY.md
│ ├── memory/
│ │ └── 2026-03-06.md
│ └── vector-index/
│ └── main.sqlite
└── manual/ # 手动备份（独立快照）
└── 2026-03-27T10-00-00/
└── ...
安全设计
| 机制 | 说明 |
|---|---|
| 路径遍历防护 | manifest 解析时拒绝绝对路径和 ../；恢复时通过 cd && pwd 解析真实路径，校验目标不超出允许目录 |
| 安全临时目录 | mktemp -d 创建临时目录，trap 保证退出时自动清理 |
| 恢复安全网 | 恢复前自动备份当前记忆到 .backup-before-restore/ |
| 兼容性校验 | 恢复时检查 Agent 类型和记忆系统是否匹配，不匹配时拒绝（除非 --force） |
| 网盘隔离 | 所有操作限定在百度网盘 /apps/bdpan/ 目录下 |
| Token 加密存储 | bdpan 使用 AES-256-GCM 加密存储 access_token，Plugin 和 Skill 均透明支持解密 |
故障排除 / FAQ
Q: 安装后自动备份没有生效？
A: 需要重启 OpenClaw gateway。执行：
openclaw gateway restart
Q: bdpan login 过期了怎么办？
A: 重新执行登录：
bdpan login
Q: 备份列表为空？
A: 确认已执行过以下操作：
- 已完成
bdpan login登录百度网盘 - 已执行至少一次备份（手动或自动）
Q: 恢复后部分文件丢失？
A: 恢复前系统会自动创建本地安全备份，位置在：
~/.openclaw/workspace/.backup-before-restore/<timestamp>/
Q: 多台设备如何同步记忆？
A: 每台设备有独立的备份目录（按设备名隔离）。在设备 B 上执行 restore 恢复设备 A 的备份即可跨设备同步。如需覆盖设备 B 的记忆，使用 --force 跳过兼容性校验。
Q: 误删了网盘上的备份怎么办？
A: 百度网盘有回收站机制，删除后 10 天内可在网盘客户端或网页版「回收站」中恢复。
Q: 备份占用多少网盘空间？
A: 取决于记忆文件数量和大小。增量备份仅上传变更文件，单次增量通常几十 KB 到几百 KB。首次全量备份通常不超过 5 MB。
加入社区
扫码添加，备注「github」即可入群
- 与核心开发团队直接交流
- 提交 Bug 反馈和功能建议
- 参与 Plugin & Skill 共建计划