Clawver订单管理

技能简介

该技能用于管理 Clawver 店铺的订单数据，支持查看订单历史、筛选订单状态、处理全额或部分退款、生成数字商品下载链接，以及订阅订单发货等事件通知。

业务背景

Clawver订单管理技能为电商卖家提供一站式订单处理能力，支持从订单查询、状态跟踪到退款处理的全流程自动化。该技能打通Stripe支付与物流通知，帮助商家快速响应售后需求，减少人工核对错误，提升客户满意度与资金周转效率。

落地案例：一家数字内容店铺接入该技能后，实现了订单处理的自动化升级：顾客下单后系统自动生成专属下载链接并邮件发送；每日定时同步待发货订单至仓库系统；遇到退货申请时，客服在聊天窗口输入订单号即可发起部分退款，Stripe自动原路退回。售后处理时长从平均4小时缩短至10分钟内。

能做什么

• 列出全部订单并按状态筛选（待付款、已确认、处理中、已发货、已完成、已取消）
• 获取单个订单的详细信息，包括 POD 商品的规格与物流追踪
• 为数字商品生成店主端或顾客端的下载链接
• 发起全额或部分退款，自动对接 Stripe 处理
• 配置 Webhook 接收订单发货、完成等实时推送

使用说明

安装指令

本技能无需本地安装包，但需配置环境变量：

export CLAW_API_KEY="your_clawver_api_key"

确保店铺处于活跃状态且已有订单数据。

基础调用示例

获取所有订单：

curl https://api.clawver.store/v1/orders \
  -H "Authorization: Bearer $CLAW_API_KEY"

按状态筛选（如已确认）：

curl "https://api.clawver.store/v1/orders?status=confirmed" \
  -H "Authorization: Bearer $CLAW_API_KEY"

处理全额退款：

curl -X POST https://api.clawver.store/v1/orders/{orderId}/refund \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amountInCents": 2499,
    "reason": "Customer requested refund"
  }'

配置发货通知 Webhook：

curl -X POST https://api.clawver.store/v1/webhooks \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["order.shipped", "order.fulfilled"],
    "secret": "your-secret-min-16-chars"
  }'

输入与输出

见下方输入与输出表格。

风险提示

• 退款金额以分为单位，不可超过剩余可退金额，提交前请二次核对
• 退款通过 Stripe 处理，到账需 1-5 个工作日
• POD 商品自 2026 年 2 月起强制要求 variantId，缺货规格会被拒绝
• Webhook 密钥长度至少 16 位字符，建议定期轮换
• 公开下载链接含 token 参数，注意避免泄露

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nwang783/clawver-orders/SKILL.md
来源类型：GitHub 仓库