概述
Cursor Cloud Agents 技能是一个命令行工具封装层，用于调用 Cursor 的云代理 HTTP API，使 OpenClaw 能够将编码任务分派到 GitHub 仓库上的 Cursor 云代理，监控其进度并整合结果。
核心用法
该技能通过 cursor-api.sh 脚本提供完整的工作流支持：
- 启动代理：
cursor-api.sh launch --repo owner/repo --prompt "任务描述"，支持--background后台模式、--model指定模型（默认 gpt-5.2）、--max-runtime设置超时 - 状态监控：
cursor-api.sh status <agent-id>查看 CREATED/RUNNING/FINISHED/ERROR 等状态 - 对话历史：
cursor-api.sh conversation <agent-id>获取完整消息记录 - 迭代协作：
cursor-api.sh followup <agent-id> --prompt "补充指令"继续优化 - 后台任务管理：
bg-list、bg-status、bg-logs专门用于长时间运行任务 - 便捷别名：提供
cca-aliases.sh快速别名（cca替代cursor-api.sh）
认证采用多级自动发现机制：环境变量 CURSOR_API_KEY → ~/.openclaw/.env → 项目 .env → ~/.cursor/config.json。
显著优点
1. 异步工作流：支持后台模式运行，适合 CI/CD 集成和长时间任务（10 分钟至 24 小时）
2. 完整生命周期管理：从启动、监控、对话、跟进到删除的全流程支持
3. 智能默认值：自动使用 gpt-5.2 模型，合理的缓存策略（60 秒 TTL）和本地速率限制（1 req/s）
4. 企业级错误处理：定义明确的退出码（0-5），涵盖认证、限流、仓库访问等场景
5. 多模型支持：支持 gpt-5.2、claude-4-opus 等，通过 cursor-api.sh models 查看可用列表
6. 配额透明：usage 命令实时显示代理使用量和订阅层级限制
潜在缺点与局限性
1. GitHub 仓库限制：仅支持 GitHub 仓库，不支持其他 Git 托管服务或本地文件操作
2. 实时性不足：非流式响应，不适合需要即时交互的场景（应使用本地 Cursor CLI）
3. 并发限制严格：Free tier 仅 1 个并发，Pro 3 个，Ultra 5 个，大规模团队可能受限
4. 安全风险：~/.cache/cursor-api/ 缓存未加密，API 密钥多位置读取增加暴露面
5. 冷启动延迟：代理启动需 1-2 分钟，"CREATING" 状态可能持续较久
6. 模型幻觉风险：云代理对复杂代码库的理解可能不如本地 IDE 上下文完整
适合人群
- DevOps/平台工程师：需要将代码生成、测试编写集成到 CI/CD 流水线
- 技术团队负责人：需要批量处理多个仓库的技术债务或文档补全
- 独立开发者：希望异步委托编码任务，释放本地开发资源
- 开源维护者：需要为贡献者生成测试用例或文档 PR
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 密钥泄露 | API 密钥多位置存储，缓存未加密 | 使用最小权限环境变量，定期轮换密钥 |
| 代码质量不可控 | 代理生成的代码可能未经充分测试 | 强制代码审查，结合 `--no-pr` 手动验证后再合并 |
| 仓库权限失控 | 自动 PR 可能误改生产代码 | 限制代理访问分支保护规则，使用独立测试仓库 |
| 成本超支 | 长时间后台任务消耗订阅配额 | 设置合理 `--max-runtime`，定期执行 `usage` 检查 |
| 供应商锁定 | 深度依赖 Cursor 特定 API | 保持任务描述可迁移，避免专有指令嵌入业务逻辑 |