Agentar 技能概览

用于分发 AI agent 的快速 CLI 工具。

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 ]

创建当前 workspace 与配置的快照，存储于 ~/.openclaw/.agentar-backups// 目录中。

列出备份

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

回滚

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

从备份中恢复。若未指定 ，则使用最新备份。恢复前，系统将自动为当前状态创建一份安全备份。

AI Agent 行为指南

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

导出工作流

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

第 1 步 — 自动收集上下文

在向用户提问之前，静默执行以下检查：

# 检查 workspace 中的内容
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：使用 agent 的名称或 identity 作为包名。例如：若 IDENTITY.md 中声明 agent 名为 “X”，则使用 user/x:v1；若无法明确判断，则向用户询问。
• output：默认输出路径为 ~/Desktop/.claw（便于查找与分享）；Linux 系统下使用 ~/。
• description：基于 IDENTITY.md 或 SOUL.md 中内容，用一句话概括 agent 的人格特征或用途。
• include-memory：默认为 NO。仅当用户明确表示希望迁移记忆时，才建议启用 YES。

简洁地向用户呈现你的计划：

我将把您的 OpenClaw 导出为 user/x:v1，保存至 ~/Desktop/x-v1.claw。
描述：“一名名为 X 的助手，具备……”
记忆：未包含
打包的技能：agentar@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

清晰地向用户呈现预览结果：

• 包名与描述
• workspace 文件数量（列出具体文件）
• 需手动配置的凭据项
• 需额外安装的技能

第 3 步 — 分析冲突

安装前，检查当前已存在的内容：

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

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

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

• IDENTITY.md
• SOUL.md

您当前 agent 的人格设定将被替换。系统将自动创建备份，以便您随时回滚。是否继续？

第 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）
• workspace 文件安装
• 打包技能自动安装（.claw 包内所含技能将自动安装至 ~/.openclaw/skills/）
• 已存在技能版本比对（若本地已有相同或更新版本，则跳过安装）

load 命令执行完毕后，agent 应进一步完成以下任务：

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，识别导入配置新增项（如新模型提供商、channel 设置、技能配置）与当前配置已有项的区别。汇总后呈现给用户：

   导入的配置包含：

   • Telegram channel 配置（需 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. 验证 —— 全部操作完成后，执行快速健康检查：

   # 验证 workspace 文件是否就位
   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，以便用户后续引用。

边界情况

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

导出内容说明

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

不导出内容说明

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

备份内容说明（load / rollback 时）

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