CleanApp Ingest v1 综合评估
核心用法
CleanApp Ingest 是一个客户端集成技能，允许 AI Agent 通过 HTTPS 向 CleanApp 平台提交各类问题信号（bug、事故、诈骗、UX摩擦、政策违规、安全隐患、改进建议）。核心流程采用 Fetcher Key System：
1. 密钥注册 (POST /v1/fetchers/register) — 一次性获取 API 密钥
2. 批量提交 (POST /v1/reports:bulkIngest) — 隔离优先的批量上报
3. 状态自检 (GET /v1/fetchers/me) — 查询配额与状态
关键参数 --approx-location 和 --no-media 提供隐私保护选项，支持 --dry-run 离线测试。
显著优点
| 特性 | 说明 |
|------|------|
| **安全隔离设计** | 默认进入 quarantine lane，不直接公开，可控爆炸半径 |
| **密钥可撤销** | `CLEANAPP_API_TOKEN` 随时可吊销，支持 kill switch |
| **幂等性保障** | `source_id` 机制防止重复提交，适合重试场景 |
| **渐进式信任** | 通过 promotion-request 可申请提升权限，声誉驱动 |
| **最小数据原则** | 坐标模糊化、媒体可选提交，降低隐私泄露风险 |
潜在局限
- 依赖外部服务：CleanApp 后端可用性直接影响功能
- 权限天花板：新密钥默认受限，需人工审核才能解锁完整能力
- 无本地处理：纯客户端集成，不内置数据验证或富文本处理
- 速率限制：后端强制配额，高并发场景需协商扩容
适合人群
- 社区治理/众包平台的运营方，需结构化收集用户反馈
- 城市治理、公共安全领域的自动化上报系统
- 希望将 AI Agent 输出对接至可信第三方平台的开发者
- 需要 "human-in-the-loop" 审核流程的企业合规团队
常规风险
| 风险 | 缓解措施 |
|------|---------|
| 密钥泄露 | 存储于 ClawHub/OpenClaw Secret，禁止硬编码 |
| Prompt 注入导致恶意提交 | 隔离队列 + 可撤销密钥限制影响范围 |
| 地理位置精度过度暴露 | 使用 `--approx-location` 模糊化 |
| API 变更兼容性 | 依赖官方 Swagger/OpenAPI 文档，版本锁定 v1 |
总体评价
这是一个设计成熟、安全优先的 API 集成技能，quarantine-first 架构体现了对 AI Agent 不可控性的深刻理解。适合生产环境，但需配合 CleanApp 官方的审核流程才能发挥完整价值。