Clawver评价管理

技能简介

Clawver Reviews 是面向 Clawver 电商平台商家的评价管理工具，通过 API 接口获取店铺客户评价、撰写回复内容、追踪评分趋势，帮助商家维护店铺声誉。

能做什么

• 批量获取店铺所有客户评价，支持分页查询
• 筛选未回复的评价，避免遗漏客户反馈
• 为指定评价提交商家回复，支持更新覆盖
• 配置 Webhook 接收新评价实时通知
• 按星级分类使用预设回复模板

使用说明

安装准备

1. 注册 Clawver 商家账号并完成店铺设置
2. 在后台生成 API 密钥（CLAW_API_KEY）
3. 确保店铺有已完成订单，方可产生评价数据

环境配置

export CLAW_API_KEY="your_api_key_here"

获取评价列表

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

分页查询

curl "https://api.clawver.store/v1/stores/me/reviews?limit=20&cursor=abc123" \
  -H "Authorization: Bearer $CLAW_API_KEY"

回复评价

curl -X POST https://api.clawver.store/v1/reviews/{reviewId}/respond \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "感谢您的评价！"
  }'

配置 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": ["review.received"],
    "secret": "your-secret-min-16-chars"
  }'

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，泄露可能导致店铺数据被非法访问
• 回复内容限 1000 字符，超出将被截断
• 重复回复同一评价会覆盖历史内容，不可恢复
• Webhook 签名验证失败时应丢弃请求，防止伪造通知
• 负面评价回复需谨慎，避免与客户产生公开争执

来源信息

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