核心用法
CatchClaw是一款面向AI代理生态的市场管理工具，核心功能围绕Agentar（可分发代理归档包）展开。Agentar是包含SOUL.md、技能配置等文件的ZIP压缩包，可作为新代理安装或覆盖现有代理。
主要功能模块
1. 搜索与发现
- 使用
$CLI search <keyword>在CatchClaw市场搜索Agentar模板 - 使用
$CLI team search <keyword>搜索协作团队配置
2. 安装部署
- 新建模式（
--name <name>）：创建独立新代理，不影响现有环境 - 覆盖模式（
--overwrite）：替换主工作区~/.openclaw/workspace，自动备份原环境 - 支持指定版本（
--version）和API密钥注入（--api-key）
3. 导出打包
$CLI export [--agent <id>]将代理打包为标准Agentar- 自动过滤敏感文件（.credentials, .env, .secret等）
- 默认排除MEMORY.md，可选包含（
--include-memory）
4. 版本回滚
$CLI rollback恢复工作区备份，当前环境自动备份后再恢复，确保操作安全
5. 团队管理
$CLI team install <slug>一键部署多代理协作团队- 自动安装/复用成员代理，同步
AGENTS.md团队协调配置 - 成员版本冲突时逐个提示升级确认
显著优点
- 严格的用户确认机制：所有破坏性操作（覆盖安装、团队部署）强制要求显式用户授权
- 自动备份保护：覆盖操作前自动创建备份，支持任意时刻回滚
- 敏感信息过滤：导出时自动剔除凭据类文件，降低泄露风险
- 团队协同原生支持：内置多代理协作配置管理，简化复杂场景部署
- 零依赖分发：CLI直接捆绑于技能目录，无需额外下载
潜在局限与风险
- Node.js依赖：必须预装Node.js运行时环境
- 网络依赖：市场搜索和安装需连接CatchClaw官方服务
- 版本冲突处理：团队安装时成员版本冲突需逐一手动确认，大规模部署效率受限
- 覆盖操作不可逆性：虽自动备份，但频繁覆盖-回滚可能造成配置混乱
- 凭据存储：
--api-key选项会将密钥写入文件系统，需关注文件权限设置
适合人群
- 需要快速复用/分发标准化代理配置的开发者
- 管理多代理协作团队的技术负责人
- 追求环境可回溯、可版本化的DevOps实践者
常规风险提醒
1. 导出后务必人工复核ZIP内容，自动过滤并非绝对可靠
2. 团队安装前确认成员代理的复用策略，避免意外覆盖本地修改
3. API密钥类环境变量建议通过外部秘钥管理服务注入，而非持久化存储于.credentials