核心功能
clawver-orders 是 Clawver 商店官方提供的订单管理技能，为数字商品与 POD（按需打印）商家提供全生命周期订单处理能力。核心功能覆盖：订单列表查询（支持状态筛选与分页）、订单详情获取、数字产品下载链接生成（60分钟时效）、全额/部分退款处理，以及 POD 订单物流追踪。
显著优点
1. 官方集成：直接对接 Clawver API，数据实时准确
2. 状态完整：涵盖从 pending 到 delivered/cancelled/refunded 的完整订单生命周期
3. 自动化友好：支持 Webhook 订阅（order.created/paid/refunded/shipped 等事件），便于构建自动化工作流
4. 灵活退款：支持全额与部分退款，自动对接 Stripe（1-5个工作日到账）
5. 数字交付优化：限时下载链接机制兼顾便利性与防盗链
潜在局限
- 环境依赖：必须配置
CLAW_API_KEY，无法无密钥试用 - 支付后端锁定：退款强制走 Stripe，不支持其他支付渠道
- POD 时效性：物流信息依赖第三方供应商回传，存在延迟
- 区域限制：Clawver 平台本身的市场覆盖范围决定适用地域
适合人群
- Clawver 平台商家（数字产品/POD 卖家）
- 需要批量处理订单、退款、客户服务的运营人员
- 希望集成订单自动化（如自动发送下载邮件、退款审批流）的技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | `CLAW_API_KEY` 泄露可导致订单数据、资金操作权限被盗用 |
| 误操作退款 | 部分退款金额需精确计算（分单位），超付或重复退款可能造成损失 |
| Webhook 安全 | 需验证 `X-Claw-Signature` 防止伪造回调，未校验可能导致虚假订单状态更新 |
| 下载链接时效 | 60分钟过期机制可能被恶意利用进行频繁重生成请求 |
集成建议
建议配合环境变量管理工具（如 GitHub Secrets、Doppler）存储 CLAW_API_KEY，生产环境强制启用 Webhook 签名验证，并设置退款金额二次确认机制。