Zhuaxia（抓虾）—— OpenClaw 实例导出/导入

将完整的 OpenClaw 实例导出或导入为可移植的 .claw 包。敏感数据（如 API 密钥、token）会自动剥离。导入前自动创建备份，并支持回滚。

CLI 参考手册

保存（导出）

node {baseDir}/scripts/clawctl.mjs save  [options]

加载（导入）

node {baseDir}/scripts/clawctl.mjs load  [options]

加载操作会自动创建备份后再执行安装。可通过 --no-backup 跳过该步骤。

备份

node {baseDir}/scripts/clawctl.mjs backup [--source ] [--label ]

创建当前工作区 + 配置的快照，存储于 ~/.openclaw/.zhuaxia-backups//。

列出备份

node {baseDir}/scripts/clawctl.mjs backups [--source ]

回滚

node {baseDir}/scripts/clawctl.mjs rollback [] [--target ]

从备份中恢复。若未指定 ，则使用最新备份。恢复前会自动创建当前状态的安全备份。

AI 代理行为指南

当用户触发本技能时，请遵循以下智能工作流，而非盲目执行命令。

导出工作流

当用户说类似“导出 claw”、“export my setup”、“backup my openclaw”等语句时：

步骤 1 — 自动收集上下文

在向用户提问前，静默完成以下检查：

# 检查工作区内容
ls ~/.openclaw/workspace/

# 读取 identity 推断合适的包名
cat ~/.openclaw/workspace/IDENTITY.md 2>/dev/null | head -20

# 检查已安装技能（这些将记录在 manifest 中）
clawhub list --workdir ~/.openclaw 2>/dev/null

# 检查配置文件是否存在
test -f ~/.openclaw/openclaw.json && echo "config exists" || echo "no config"

步骤 2 — 推断智能默认值，并与用户确认

根据所收集的信息：

• ref：以代理的名称/identity 作为包名。例如，若 IDENTITY.md 中声明代理名为 “X”，则使用 user/x:v1；若不明确，则询问用户。
• output：默认输出至 ~/Desktop/.claw（便于查找与分享）；Linux 下使用 ~/。
• description：从 IDENTITY.md 或 SOUL.md 中提取一句概括性描述，说明该代理的性格/用途。
• include-memory：默认为 NO。仅当用户明确表示希望迁移记忆时，才建议启用 YES。

简洁呈现你的计划：

我将把您的 OpenClaw 导出为 user/x:v1，保存至 ~/Desktop/x-v1.claw。
描述：“一名名为 X 的助手，具备……”
记忆：未包含
打包技能：zhuaxia@0.3.0、custom-skill（共 2 个，来自 ~/.openclaw/skills/）

是否继续？

步骤 3 — 执行并反馈结果

node {baseDir}/scripts/clawctl.mjs save  -o  --description ""

成功后，向用户说明以下信息：

1. 文件路径与大小
2. 包含的文件数量
3. 被剥离的凭据数量（向用户确认其可安全共享）
4. 传输方式：“将此文件复制到另一台机器，然后告诉那台机器上的 OpenClaw ‘请安装这个 claw 包’”

导入工作流

当用户说类似“导入 claw”、“install this claw”、“load this package”，或直接提供一个 .claw 文件路径时：

步骤 1 — 定位 .claw 文件

若用户未指定路径，主动搜索：

# 检查常见位置
ls ~/Desktop/*.claw ~/Downloads/*.claw /tmp/*.claw ~/*.claw 2>/dev/null

若发现多个 .claw 文件，列出并请用户选择；若未找到，则向用户索要路径。

步骤 2 — 首先预览（始终执行）

安装前务必执行 dry-run：

node {baseDir}/scripts/clawctl.mjs load  --dry-run

清晰地向用户展示预览结果：

• 包名与描述
• 工作区文件数量（并列出）
• 需手动配置的必要凭据
• 需额外安装的必要技能

步骤 3 — 分析冲突

安装前，检查当前已有内容：

# 检查工作区文件是否会被覆盖
ls ~/.openclaw/workspace/

若存在将被覆盖的文件，则明确警告用户：

以下文件已存在，将被覆盖：

• IDENTITY.md
• SOUL.md

您当前的代理人格将被替换。系统将自动创建备份，以便需要时回滚。是否继续？

步骤 4 — 安装（含自动备份）

load 命令会在安装前自动创建备份：

node {baseDir}/scripts/clawctl.mjs load 

命令输出示例：

  Creating backup before install...
  Backup created: 20260308-143022 (12 files)
  Rollback with: clawctl rollback 20260308-143022

告知用户备份 ID，并强调其可随时回滚。

步骤 5 — 安装后智能处理

这是 AI 价值最突出的环节。load 命令本身已支持：

• 安装前自动备份（含回滚 ID）
• 工作区文件安装
• 内置技能自动安装（.claw 包中附带的技能将自动安装至 ~/.openclaw/skills/）
• 已存在技能版本比对（若本地已安装相同或更新版本，则跳过）

load 命令执行完毕后，代理应进一步处理：

1. 技能缺口检查 — load 输出中会提示 “Additional skills referenced in config (not bundled, may be built-in)”。对每一项：

   • 若是 OpenClaw 内置技能（如 coding-agent、github），则已就绪，无需操作。
   • 若是 ClawHub 技能，则主动提供安装选项：

   clawhub install  --workdir ~/.openclaw
   

2. 配置合并 — 同时读取 ~/.openclaw/openclaw.json 和 ~/.openclaw/openclaw.imported.json，识别导入配置新增的内容（如新模型提供商、通道设置、技能配置）与当前配置已有的部分。汇总呈现如下：

   导入的配置包含：

   • Telegram 通道配置（需 bot token）
   • 自定义模型提供商 “kimi-code”
   • 技能 “nano-banana-pro” 的配置

   您当前的配置已包含：[列表]
   待合并的新配置项：[列表]
   是否合并非敏感设置？

   若用户同意，读取两个 JSON 文件，智能合并（保留当前凭据，添加新的非敏感设置），并将结果写回 openclaw.json。

3. 凭据检查清单 — 对导入配置中每个 $CLAW_PLACEHOLDER，明确告知用户需设置的具体内容：

   为完成配置，您需要设置：

   • Telegram bot token：openclaw config set channels.telegram.botToken
   • Gateway auth token：openclaw config set gateway.auth.token

4. 验证 — 全部完成后快速健康检查：

   # 验证工作区文件是否就位
   ls ~/.openclaw/workspace/
   # 验证技能是否已安装
   ls ~/.openclaw/skills/
   # 验证配置是否为有效 JSON
   node -e "JSON.parse(require('fs').readFileSync(require('os').homedir()+'/.openclaw/openclaw.json','utf8')); console.log('Config OK')"
   

回滚工作流

当用户说“回滚”、“rollback”、“undo import”、“restore my old config”等语句时：

步骤 1 — 列出可用备份

node {baseDir}/scripts/clawctl.mjs backups

向用户展示所有可用备份及其时间戳与标签。

步骤 2 — 确认要恢复的备份

若仅有一个备份，确认如下：

发现 1 个备份：20260308-143022（before-load:my-bot.claw，共 12 个文件）
是否恢复？系统将首先为您当前状态创建安全备份。

若有多个备份，请用户选择。

步骤 3 — 执行回滚

node {baseDir}/scripts/clawctl.mjs rollback 

rollback 命令在恢复前会自动创建当前状态的安全备份，因此用户可在必要时“撤销回滚”。

步骤 4 — 验证

ls ~/.openclaw/workspace/

确认恢复后的文件符合预期。

手动备份工作流

当用户说“备份一下当前状态”、“save a checkpoint”、“backup before I try something”等语句时：

node {baseDir}/scripts/clawctl.mjs backup --label "user description here"

报告备份 ID，方便用户后续引用。

边界情况

• 用户只说“导出”但无上下文：先自动收集信息，再提出默认方案；最多仅向用户提问 2 次。
• 用户提供 URL 而非文件路径：先用 curl -o /tmp/downloaded.claw 下载，再进入导入流程。
• 在全新 OpenClaw（无现有配置）上导入：跳过冲突检查，直接安装全部内容；自动备份仍会执行（备份空状态，提供干净的回滚目标）。
• 用户希望一步完成导出 + 分享：导出完成后，推荐便捷传输方式（AirDrop、scp、云盘等）。
• 多个 .claw 文件：若用户说“install all claw packages”，则逐个遍历，对每个文件分别执行预览。
• 回滚链：每次回滚均创建安全备份，因此用户总可撤销一次回滚；用户询问时需明确解释此机制。
• 磁盘空间：若用户备份过多，建议清理旧备份：rm -rf ~/.openclaw/.zhuaxia-backups/。

导出内容

• 工作区文件（系统提示词、代理人格、自定义指令）
• 脱敏后的配置（凭据被替换为 $CLAW_PLACEHOLDER）
• 所有用户安装的技能（来自 ~/.openclaw/skills/，完整文件，导入时自动安装）
• 技能列表与通道列表（用于依赖追踪的元数据）

不导出内容

• API 密钥、token、密码（自动剥离）
• 会话日志与历史记录
• 记忆（除非显式指定 --include-memory）
• 凭据目录
• 二进制文件（图片、密钥、证书等）

备份内容（导入/回滚时）

• 全部工作区文件（~/.openclaw/workspace/）
• 配置文件（~/.openclaw/openclaw.json）
• 存储于 ~/.openclaw/.zhuaxia-backups//