前言¶
跑 OpenClaw 的开发者通常会积累一批不能丢的东西：配置、工作区、扩展和记忆类文件。手工 tar 或整盘拷贝能救急，但很难长期维持「工作日少写盘、周末做一次全量、过期自动清理」这类运维节奏，也缺少并发保护与备份后校验。
下面介绍 SkillHub 上的 openclaw系统自动全量和增量备份（坐标 @user_a8fdfe0b/openclaw-full-incremental-backup，版本 2.0.0）。它把全量/增量策略、保留周期和安装期可指定的备份路径封装成 Agent Skill，让 AI 按文档帮你落地 OpenClaw 侧的自动备份与恢复流程。
这是什么¶
一句话定位：OpenClaw 全自动备份恢复系统，面向 OpenClaw 环境提供增量备份能力。
- 来源：SkillHub 社区技能（
community），发布者标识为user_a8fdfe0b；SkillHub 页面展示作者为「湖南橡树」。 - 分类：
it-ops-security。 - 依赖：
requires_api_key=false，无需额外 API Key。 - 平台：支持 Linux / macOS；需 Python 3.8+。
官方简介中的使用场景是：保护 OpenClaw 配置、工作区、扩展、记忆文件，降低误删、升级失败或环境迁移带来的丢失风险。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面展开的实现细节不在文中臆测。
- 真正增量：基于
tar --listed-incremental的增量备份（官方文案写作listed-increural，指 listed incremental 机制）。 - 调度策略：每周六自动全量；工作日执行增量。
- 保留策略：全量与增量分别对应 30 天 / 180 天 保留（具体目录命名与清理逻辑由 Skill 内说明驱动）。
- 可靠性：防并发锁、完整性自动校验；备份前对当前目录做自动快照。
- 路径可配：安装时由用户指定备份路径，便于挂载独立磁盘或 NAS。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或把安装提示词发给当前 AI Agent。
1. 安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。SkillHub 文档给出的常见路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装命令形式如下（将 <skills目录> 换成上表对应路径）：
skillhub install @user_a8fdfe0b/openclaw-full-incremental-backup --dir <skills目录>
也可直接向 Agent 发送 SkillHub 页面提供的提示词：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_a8fdfe0b/openclaw-full-incremental-backup`。
安装完成后，按你所用 Client 的要求重启或刷新 Agent，使新 Skill 被加载。
3. 启用时的关键输入¶
官方说明强调：安装时由用户指定备份路径。启用 Skill 后，应在与 Agent 的对话中明确备份落盘位置（本地目录、挂载点等），以便与「周六全量 + 工作日增量」策略对齐。
典型用法¶
公开页面未附带独立的 shell 剧本或配置文件样例；典型用法是 安装 Skill → 在 Agent 中说明 OpenClaw 环境与备份路径 → 按 Skill 内 SKILL.md 指引完成备份/恢复与校验。
可复现的安装侧操作即上一节的 skillhub install 或官方安装提示词。备份调度（周六全量、工作日增量）、保留 30/180 天、锁与完整性校验等行为，以 Skill 文档与 Agent 执行结果为准；若需改 cron 或路径，应在对话中写清约束，避免与默认策略冲突。
适用场景与注意¶
适合谁
- 长期在本机或服务器跑 OpenClaw，需要定期保护配置、工作区、扩展与记忆文件。
- 希望用 listed incremental 降低日常备份 IO，同时保留周期性全量与自动清理。
- 使用 Linux 或 macOS，且环境满足 Python 3.8+。
限制与注意
- 仅支持 Linux / macOS；Windows 未在官方简介中列出。
- 备份路径需在安装/配置阶段明确，并确保磁盘空间与权限满足全量 + 增量叠加。
- SkillHub 统计（截至页面展示）：评分 100000，下载 1268，安装 1；社区来源，使用前建议在测试环境先跑一轮恢复验证。
- 与 Cursor、Codex、Claude Code 等无单独分叉说明时，差异主要在 skills 目录路径，安装命令相同。
结尾¶
openclaw系统自动全量和增量备份 把 OpenClaw 侧「全量 + 增量 + 保留 + 校验」写进可安装的 Agent Skill，减少手写 tar 与 cron 的重复劳动。若你要为 OpenClaw 做可恢复的本地备份，可从 SkillHub 安装 @user_a8fdfe0b/openclaw-full-incremental-backup 并按文档指定备份路径。
- SkillHub 页面：https://www.skillhub.cn/skills/user_a8fdfe0b/openclaw-full-incremental-backup
- API 坐标页：https://api.skillhub.cn/user_a8fdfe0b/openclaw-full-incremental-backup
- 安装说明：https://skillhub.cn/install/skillhub.md
