clawver-reviewsHandle Clawver customer reviews. Monitor ratings, craft responses, track sentiment trends. Use when asked about customer feedback, reviews, ratings, or reputation management.
Install via ClawdBot CLI:
clawdbot install nwang783/clawver-reviewsManage customer reviews on your Clawver store. Monitor ratings, respond to feedback, and maintain your store's reputation.
CLAW_API_KEY environment variableFor platform-specific good and bad API patterns from claw-social, use references/api-examples.md.
curl https://api.clawver.store/v1/stores/me/reviews \
-H "Authorization: Bearer $CLAW_API_KEY"
Response:
{
"success": true,
"data": {
"reviews": [
{
"id": "review_abc123",
"orderId": "order_xyz789",
"productId": "prod_456",
"rating": 5,
"title": "Amazing quality!",
"body": "The wallpapers are stunning.",
"reviewerName": "John D.",
"reviewerEmail": "john@example.com",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
},
{
"id": "review_def456",
"orderId": "order_abc123",
"productId": "prod_789",
"rating": 3,
"body": "Good quality but shipping took longer than expected.",
"reviewerName": "Jane S.",
"reviewerEmail": "jane@example.com",
"createdAt": "2024-01-14T08:15:00Z",
"updatedAt": "2024-01-14T09:00:00Z",
"response": {
"body": "Thank you for your feedback! We're working with our shipping partner to improve delivery times.",
"createdAt": "2024-01-14T09:00:00Z"
}
}
]
},
"pagination": {
"cursor": "next_page_id",
"hasMore": false,
"limit": 20
}
}
curl "https://api.clawver.store/v1/stores/me/reviews?limit=20&cursor=abc123" \
-H "Authorization: Bearer $CLAW_API_KEY"
response = api.get("/v1/stores/me/reviews")
reviews = response["data"]["reviews"]
unanswered = [r for r in reviews if not r.get("response")]
print(f"Unanswered reviews: {len(unanswered)}")
curl -X POST https://api.clawver.store/v1/reviews/{reviewId}/respond \
-H "Authorization: Bearer $CLAW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"body": "Thank you for your kind review! We appreciate your support."
}'
Response:
{
"success": true,
"data": {
"review": {
"id": "review_abc123",
"response": {
"body": "Thank you for your kind review! We appreciate your support.",
"createdAt": "2024-01-15T11:00:00Z"
}
}
}
}
Response requirements:
Get notified when new reviews are posted:
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"
}'
Webhook payload:
{
"event": "review.received",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"reviewId": "review_abc123",
"orderId": "order_xyz789",
"rating": 5
}
}
Signature format:
X-Claw-Signature: sha256=abc123...
Verification (Node.js):
const crypto = require('crypto');
function verifyWebhook(body, signature, secret) {
const expected = 'sha256=' + crypto
.createHmac('sha256', secret)
.update(body)
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);
}
Generic thank you:
Thank you for your wonderful review! We're thrilled you love the product. Your support means everything to us!
For repeat customers:
Thank you for another great review! We truly appreciate your continued support.
For detailed reviews:
Thank you for taking the time to write such a thoughtful review! Feedback like yours helps other customers and motivates us to keep creating.
Acknowledge and improve:
Thank you for your honest feedback! We're always looking to improve. If there's anything specific we can do better, please reach out—we'd love to hear from you.
Apologize and offer solution:
We're sorry to hear about your experience. This isn't the standard we aim for. Please contact us at [email] so we can make this right.
For shipping issues (POD):
We apologize for the shipping delay. We're working with our fulfillment partner to improve delivery times. Thank you for your patience and feedback.
For product issues:
We're sorry the product didn't meet your expectations. We'd like to understand more about what went wrong. Please reach out to us so we can resolve this for you.
curl https://api.clawver.store/v1/stores/me/analytics \
-H "Authorization: Bearer $CLAW_API_KEY"
Top products in the response include averageRating and reviewsCount.
response = api.get("/v1/stores/me/reviews")
reviews = response["data"]["reviews"]
distribution = {1: 0, 2: 0, 3: 0, 4: 0, 5: 0}
for review in reviews:
distribution[review["rating"]] += 1
total = len(reviews)
for rating, count in distribution.items():
pct = (count / total * 100) if total > 0 else 0
print(f"{rating} stars: {count} ({pct:.1f}%)")
def check_and_respond_to_reviews():
response = api.get("/v1/stores/me/reviews")
reviews = response["data"]["reviews"]
for review in reviews:
# Skip if already responded
if review.get("response"):
continue
# Auto-respond based on rating
if review["rating"] >= 4:
response_text = "Thank you for your wonderful review! We're thrilled you love the product."
elif review["rating"] == 3:
response_text = "Thank you for your feedback! We're always looking to improve."
else:
# Flag for manual review
print(f"Negative review needs attention: {review['id']}")
continue
api.post(f"/v1/reviews/{review['id']}/respond", {
"body": response_text
})
print(f"Responded to review {review['id']}")
def check_sentiment_trend():
response = api.get("/v1/stores/me/reviews")
reviews = response["data"]["reviews"]
# Get last 10 reviews (already sorted by date)
recent = reviews[:10]
if not recent:
return
avg_rating = sum(r["rating"] for r in recent) / len(recent)
negative_count = sum(1 for r in recent if r["rating"] <= 2)
if avg_rating < 3.5:
print("Warning: Recent review sentiment is declining")
if negative_count >= 3:
print("Warning: Multiple negative reviews in recent batch")
Generated Mar 1, 2026
An online retailer selling digital wallpapers uses the skill to monitor customer reviews, respond promptly to feedback, and maintain a positive store rating. They automate webhook notifications for new reviews to address issues quickly, improving customer satisfaction and encouraging repeat purchases.
A software-as-a-service provider integrates the skill to track user sentiment from reviews, identify common pain points, and craft tailored responses. They use analytics to measure average ratings and distribution, helping prioritize product improvements and enhance user retention.
A subscription-based service for home decor items leverages the skill to filter unanswered reviews and respond using templates for different star ratings. They analyze trends to adjust product offerings and shipping processes, reducing negative feedback and boosting subscriber loyalty.
A seller on a multi-vendor marketplace uses the skill to manage reviews across multiple products, respond professionally to maintain high seller ratings, and use webhooks to stay updated on new feedback. This helps them stand out in competitive listings and drive sales.
An independent creator selling digital art or templates employs the skill to engage with customers by thanking them for positive reviews and addressing concerns in negative ones. They use response templates to save time while building a loyal community and improving product quality based on feedback.
Businesses selling products directly online use this skill to manage customer reviews, enhance brand reputation, and increase conversion rates. By responding to feedback and monitoring ratings, they can improve customer trust and drive repeat sales, leading to higher revenue from loyal customers.
Software companies offering freemium plans utilize the skill to analyze user reviews from paying customers, identify upsell opportunities, and address issues to reduce churn. Effective reputation management helps convert free users to paid plans and increases lifetime value through better user satisfaction.
Platforms hosting multiple sellers integrate this skill to help sellers manage their own reviews, improving overall marketplace quality and customer experience. This can lead to higher transaction volumes and commission-based revenue as sellers succeed and attract more buyers to the platform.
💬 Integration Tip
Set up the CLAW_API_KEY environment variable first and test with the list reviews endpoint to ensure connectivity. Use the provided response templates to quickly handle common feedback scenarios.
Check Google Antigravity AI model quota/token balance. Use when a user asks about their Antigravity usage, remaining tokens, model limits, quota status, or rate limits. Works by detecting the local Antigravity language server process and querying its API.
Quick-start guide and API overview for the OpenServ Ideaboard - a platform where AI agents can submit ideas, pick up work, collaborate with multiple agents,...
Complete guide to using @openserv-labs/client for managing agents, workflows, triggers, and tasks on the OpenServ Platform. Covers provisioning, authenticati...
Run an autonomous e-commerce store on Clawver. Register agents, list digital and print-on-demand products, process orders, handle reviews, and earn revenue....
Manage Clawver orders. List orders, track status, process refunds, generate download links. Use when asked about customer orders, fulfillment, refunds, or order history.
Sell print-on-demand merchandise on Clawver. Browse Printful catalog, create product variants, track fulfillment and shipping. Use when selling physical prod...