核心用法
CatchClaw 是一个用于管理「Agentar」（智能体归档包）的 CLI 工具集。Agentar 是包含 SOUL.md、skills 和配置文件的 ZIP 压缩包，可作为模板快速部署新智能体或覆盖现有工作区。
主要功能模块：
1. 搜索 (search)：$CLI search <keyword> — 在 CatchClaw 市场搜索匹配的智能体模板
2. 安装 (install)：$CLI install <slug> --name <name> 或 --overwrite — 支持两种模式：
3. 导出 (export)：$CLI export [--agent <id>] — 将当前智能体打包为可分发 ZIP，自动过滤敏感文件，可选包含 MEMORY.md
4. 回滚 (rollback)：$CLI rollback [--latest] — 从自动备份恢复先前版本，操作前会再次备份当前状态
new：创建独立新智能体，不影响现有环境overwrite：覆盖主工作区（自动备份），需用户显式确认
使用前必须验证 CLI：所有操作前需运行 node <skill-dir>/agentar_cli.mjs version 确认 CLI 可用。
显著优点
- 官方生态集成：CatchClaw 市场原生支持，模板来源可信
- 零配置快速部署：单命令完成复杂智能体环境搭建
- 安全导出机制：自动排除
.credentials、.env、密钥等敏感文件 - 原子化回滚：覆盖操作前自动备份，误操作可无损恢复
- 多环境隔离：
--name模式支持同一主机运行多个独立智能体实例
潜在缺点与局限性
- Node.js 依赖：必须预装 Node 运行时环境
- 覆盖风险：
--overwrite虽自动备份，但仍可能打断当前工作流 - API 依赖：搜索和安装需连接 CatchClaw 市场服务
- 本地存储敏感：
--api-key会写入本地文件，多用户环境需额外注意权限 - Memory 默认排除：MEMORY.md 需显式
--include-memory才会导出，可能遗漏关键上下文
适合人群
- 需要快速复用成熟智能体配置的开发者
- 团队协作中需要标准化 Agent 模板的团队
- 频繁实验新配置、需要版本回滚能力的进阶用户
- 希望分发自定义智能体给社区的开源贡献者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据覆盖 | `--overwrite` 替换主工作区 | 强制用户显式选择，自动备份 |
| 敏感信息泄露 | 导出时可能遗漏人工硬编码的密钥 | 导出后人工复核 ZIP 内容 |
| API 密钥本地存储 | `--api-key` 写入 `.credentials` | 限制文件权限，避免提交到版本控制 |
| 网络中断 | 市场搜索/安装失败 | 支持 `AGENTAR_API_BASE_URL` 自定义镜像 |
| 备份膨胀 | 频繁覆盖产生大量备份 | 定期清理 `~/.agentar/backups` |