← 返回 Skills 市场
silronin

Booker's OpenClaw Backup

作者 Silronin · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
67
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install bookers-openclaw-backup
功能描述
Create, inspect, configure, and restore self-contained backup bundles for ~/.openclaw. Use when the user wants full-state backup, backup listing, changing th...
使用说明 (SKILL.md)

OpenClaw Backup

Use this skill as the unified backup and restore entrypoint for ~/.openclaw.

Main commands

Create a backup bundle:

bash scripts/create_backup.sh

List existing bundles:

bash scripts/list_backups.sh

Show current configuration and effective values:

bash scripts/show_config.sh

Change the default backup directory:

bash scripts/set_backup_dir.sh /absolute/path

Select a bundle, audit it, extract it, and print the restore command:

bash scripts/select_and_restore.sh

Bundle format

Each backup is a self-contained tar.gz bundle with this structure:

occt7pkbak-YYYYMMDD-HHMMSS/
├── .openclaw/
├── restore.sh
├── manifest.txt
└── SHA256SUMS

The bundled restore.sh is the primary restore path.

Public defaults vs local overrides

Public default path:

~/backups/openclaw-snapshots

Local/private setups can override that path in two ways:

  • environment variable: OPENCLAW_SNAPSHOT_DIR
  • local config file: config.env

Configuration model

This skill keeps long-term local defaults in config.env.

Current configurable values:

  • OPENCLAW_SNAPSHOT_DIR
  • OPENCLAW_SNAPSHOT_PREFIX
  • OPENCLAW_SNAPSHOT_KEEP

Priority order is:

  • command-line flags
  • skill config file (config.env)
  • OPENCLAW_SNAPSHOT_* environment variables
  • built-in defaults

Important: in the current design, values stored in config.env override same-name environment variables. If you want a one-off override, prefer command-line flags such as --out-dir.

show_config.sh shows stored config values, environment values, and final effective values.

CLI notes

Primary CLI flag for backup location:

  • --out-dir

Compatibility alias still accepted:

  • --backup-dir

Safety model

  • integrity verification is mandatory during restore
  • symbolic links and special files are rejected
  • tar entries are audited before extraction, including hard-link rejection
  • dangerous target paths are rejected
  • the restore target basename must match the bundled source basename, normally .openclaw
  • the bundle is portable across environments; restore uses the current runtime target path rather than a build-time HOME lock
  • do not rename the extracted bundle root before running restore.sh
安全使用建议
This skill appears to do what it says: bundle ~/.openclaw into portable tar.gz archives and restore them with integrity checks. Before installing or running: 1) inspect any existing ~/.openclaw contents you plan to bundle (backups will include those files); 2) be aware the scripts will read $HOME and may be influenced by optional environment overrides (OPENCLAW_SOURCE_DIR, OPENCLAW_RESTORE_TARGET, and the documented OPENCLAW_SNAPSHOT_* variables); 3) set the backup directory to an absolute path you control (use set_backup_dir.sh) so backups are stored where you expect; and 4) note that the 'restore' flow is conservative (checksums, rejects symlinks/special files, and requires manual execution of the restore.sh inside an extracted bundle). The only issue to address is a documentation gap: the scripts accept a couple of extra optional environment variables not listed in SKILL.md — that's not malicious but worth noting.
能力评估
Purpose & Capability
The name/description match the provided scripts: create, list, configure, and restore self-contained tar.gz bundles of ~/.openclaw. Required files and behaviors (reading $HOME, writing bundles to a user-specified backup directory, storing config in config.env) are appropriate for a backup tool.
Instruction Scope
Runtime instructions direct the agent to run local shell scripts that only operate on local paths and the backup directory. The scripts do not perform network calls or access unrelated system configuration. Two environment variables used by the scripts (OPENCLAW_SOURCE_DIR and OPENCLAW_RESTORE_TARGET) are not mentioned in SKILL.md's 'Public defaults vs local overrides' section — SKILL.md documents OPENCLAW_SNAPSHOT_DIR but not these two optional overrides. This is a minor documentation mismatch (the variables are plausible override hooks) but worth noting.
Install Mechanism
There is no install spec and no external downloads. The skill is instruction-only with included scripts; no network-based installation or archive extraction from remote URLs is present.
Credentials
The skill requests no credentials and no privileged environment access. It relies on standard environment variables and the user's $HOME. It will read and bundle whatever is in the source directory (by default ~/.openclaw), which is expected for a backup utility.
Persistence & Privilege
always is false and the skill does not request persistent global privileges or modify other skills. It writes a local config.env in the skill directory when using set_backup_dir.sh, which is consistent with the described configuration model.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install bookers-openclaw-backup
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /bookers-openclaw-backup 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial public release: unified OpenClaw backup and restore skill with public-safe defaults, bundle auditing, and configurable local snapshot storage.
元数据
Slug bookers-openclaw-backup
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Booker's OpenClaw Backup 是什么?

Create, inspect, configure, and restore self-contained backup bundles for ~/.openclaw. Use when the user wants full-state backup, backup listing, changing th... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 67 次。

如何安装 Booker's OpenClaw Backup?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install bookers-openclaw-backup」即可一键安装,无需额外配置。

Booker's OpenClaw Backup 是免费的吗?

是的,Booker's OpenClaw Backup 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Booker's OpenClaw Backup 支持哪些平台?

Booker's OpenClaw Backup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Booker's OpenClaw Backup?

由 Silronin(@silronin)开发并维护,当前版本 v1.0.0。

💬 留言讨论