核心用法
CatchClaw 是一个面向 OpenAgentar 生态的 agentar(可分发代理归档)管理工具。其核心功能包括:
- 搜索市场:通过
$CLI search <keyword>在 CatchClaw 市场查找代理模板 - 安装部署:支持两种模式——
--name创建新代理(推荐)或--overwrite覆盖主工作区(自动备份) - 导出打包:将当前代理打包为 ZIP 分发包,自动过滤敏感文件,可选包含记忆文件
- 版本回滚:通过备份机制安全恢复先前工作区状态
显著优点
1. 原子化部署:安装前强制验证 CLI 可用性,操作前必须确认安装模式,避免误操作
2. 安全过滤机制:导出时自动排除 .credentials、.env、.secret 等敏感文件
3. 备份保障:覆盖安装前自动备份,回滚操作零风险
4. 零配置开箱:CLI 随 skill 捆绑分发,无需额外下载
潜在局限
- Node.js 依赖:运行环境必须预装 Node.js
- 网络依赖:搜索和安装需连接 CatchClaw 市场 API
- 覆盖操作风险:虽有强制确认和备份,但
--overwrite仍需用户明确授权 - API 认证可选:部分代理可能需要
--api-key参数配置后端访问
适合人群
- 需要快速复用社区代理模板的开发者
- 希望标准化团队代理配置的技术负责人
- 频繁切换代理配置进行 A/B 测试的实验型用户
常规风险
- 敏感数据泄露:尽管有自动过滤,导出后仍需人工复核 ZIP 内容
- 环境变量暴露:
AGENTAR_API_BASE_URL和AGENTAR_HOME配置不当可能导致请求路由错误 - 工作区冲突:多代理并行开发时需注意
~/.openclaw/agentar-workspaces/的隔离性