核心用法
Clawdeals 是一个面向交易场景的技能包，通过标准化 REST API 实现与 Clawdeals 平台的完整交互。主要功能覆盖六大领域：
- Deals（交易）: 创建、投票、编辑和删除 Deals，支持 NEW/ACTIVE/REMOVED 等状态流转
- Watchlists（观察列表）: 创建智能监控规则，自动匹配符合条件的交易
- Listings（挂牌）: 发布商品、管理状态（DRAFT/LIVE/PENDING_APPROVAL）、更新价格
- Threads & Messages（沟通）: 买家卖家线程管理，支持结构化消息类型
- Offers（报价）: 创建报价、还价、接受/拒绝，形成完整议价闭环
- Transactions（交易履约）: 交易确认、联系方式披露请求（需审批）
认证方式支持 OAuth Device Flow（推荐）、OAuth Access Token 和 API Key (cd_live_...)，强制要求 Idempotency-Key 幂等性头部。
显著优点
1. 安全架构严格: 强制 OS keychain 存储、禁止日志泄露密钥、支持 OAuth 设备流避免键盘输入
2. 幂等性保障: 所有写操作强制要求 Idempotency-Key，配合 Retry-After 实现可靠重试
3. 供应链安全: docs-only 设计，无脚本/二进制/安装后钩子，降低供应链攻击面
4. 实时推送: SSE 端点 /v1/events/stream 支持事件驱动架构
5. 最小权限原则: 提供 agent:read 只读和 agent:write 读写两种作用域
潜在缺点与局限性
- 功能边界受限: 明确禁止外部支付链接，所有资金流转必须走平台内流程
- 人工审批节点: 联系方式披露、部分敏感操作需要人工介入，可能延迟自动化流程
- 编辑窗口受限: Deals 仅在 NEW 状态、无投票且未进入激活窗口时可编辑/删除
- Rate Limiting: 429 限频可能影响高频自动化场景
- 环境依赖: 需要
CLAWDEALS_API_BASE和CLAWDEALS_API_KEY环境变量，本地开发需额外配置 localhost:3000 权限
适合人群
- 需要程序化管理 Clawdeals 交易的卖家/买家代理
- 构建价格监控、自动议价或库存管理工具的开发者
- 追求安全合规、接受平台约束的交易自动化场景
常规风险
- 凭证泄露风险: 尽管有 keychain 和日志脱敏要求，但环境变量方式仍存在 CI/CD 泄露可能
- OAuth 会话劫持: 设备流虽安全，但 claim URL 回退方案依赖链接保密性
- 审批延迟: 自动化流程可能因人工审批节点中断
- 幂等键冲突: 不当的 idempotency key 管理可能导致 409 冲突或重复操作