Leewow Custom Gifts

Custom Gift — Leewow

Create personalized gifts and custom products powered by AI. This skill provides:

| Tool | Purpose | |------|---------| | browse_templates | Discover customizable product templates (bags, accessories, home decor, apparel, etc.) | | generate_preview | Upload a design image and trigger AI generation | | get_status | Check generation status and download preview image |

When to Use

CRITICAL: Images Must Be Sent via Media, NOT Markdown

Feishu / chat platforms cannot render !image markdown. To show images to the user you MUST send them as media attachments using whatever message/media mechanism your platform provides (e.g. the message tool with a media parameter on OpenClaw/Feishu).

Tool outputs include a localImagePath (workspace file) for every image. Use that path as the media attachment. Showing images is mandatory, not optional.

Generator Output Format (MUST FOLLOW)

This skill uses a two-step generator pattern.

Step 1: Browse — Show Templates

After calling browse_templates, the tool returns JSON with a list of templates. Each template has localImagePath (cover image downloaded to workspace).

For every template you MUST: 1. Send the cover image as a media attachment using the localImagePath 2. Include a text caption with: name, price, templateId

Example message flow:

[send image: /Users/.../.openclaw/workspace/template_images/template_3_xxx.jpg]
1. 男士卫衣 (Men's Hoodie) — 💰 $29.9 USD — 模板ID: 3
[send image: /Users/.../.openclaw/workspace/template_images/template_12_xxx.jpg]
2. 帆布手提袋 (Canvas Tote Bag) — 💰 $19.9 USD — 模板ID: 12
...
告诉我你想选哪个，我来帮你生成效果图！

Rules for Step 1:

Step 2: Generation Complete — Show Preview + Purchase Link

After get_generation_status returns COMPLETED, the JSON contains:

You MUST: 1. Send the preview image as a media attachment using localImagePath 2. Send the purchase link in the text message

Example:

[send image: /Users/.../.openclaw/workspace/previews/leewow_preview_task_xxx.jpg]
你的定制效果图出来啦 🎉
🛒 点击下单购买: https://leewow.com/h5/preview?taskId=xxx&skid=...&sig=...
喜欢吗？如果想调整或者试试其他产品，告诉我！

Rules for Step 2:

Common Mistakes to AVOID

❌ Using !image markdown — Feishu can't render local paths this way ❌ Just saying "完成啦！" and describing the product in text without sending the image ❌ Omitting the purchase/order link ❌ Sending a table/list instead of actual images ❌ Saying "图片已下载到本地" without actually sending the image to the user

Prerequisites

Configuration

Environment variables are loaded from ~/.openclaw/.env:

CLAW_SK=sk-leewow-xxxx-xxxx
CLAW_BASE_URL=https://leewow.com
CLAW_PATH_PREFIX=/v2
LEEWOW_API_BASE=https://leewow.com

Image Requirements (IMPORTANT)

For Input Images (User Upload)

For Preview Images (Generated Output)

COS Presigned URLs

# Generate presigned URL for a COS image
python3 scripts/cos_presign.py "https://bucket.cos.region.myqcloud.com/key.png" --json
With custom expiration (e.g., 1 hour = 3600 seconds)
python3 scripts/cos_presign.py "COS_URL" --expired 3600
Use with get_status to get presigned preview URL
python3 scripts/get_status.py {taskId} --presign --json

Note: Most Leewow COS buckets are public, so presigned URLs are optional.

Typical Flow (Generator Pattern)

1. Browse (Step 1) — Call browse_templates → get JSON with localImagePath for each template → send each cover image as media + text caption (name, price, ID) → ask user to pick 2. Upload — User provides an image (must be in workspace ~/.openclaw/workspace/) 3. Generate — Call generate_preview → get taskId → immediately proceed to step 4 4. Poll — Call get_generation_status with poll=true → wait for COMPLETED 5. Display (Step 2) — Send preview image as media (localImagePath) + text with PURCHASE LINK (purchaseUrl)

Tool Reference

browse_templates

Browse available product templates.

python3 scripts/browse.py --count 3 --json

Options:

generate_preview

Upload image and trigger generation.

python3 scripts/generate.py --image-path ./workspace/my_design.png --template-id 3 --json

Options:

Returns: Task ID for status polling. Generation is async (~30-60s).

get_status

Check generation status and download preview image.

python3 scripts/get_status.py {taskId} --poll

Options:

Returns: Generation status and local image path (if completed).

Safety Rules

Examples

User: "I want to make a custom gift for my friend"
→ browse_templates → for each template: send cover image as media + text caption
→ user picks → generate_preview → get_generation_status --poll
→ send preview image as media + purchaseUrl in text
User: "Turn this photo into a phone case"
→ browse_templates --category phone → send images as media → user picks
→ generate_preview → get_generation_status --poll
→ send preview image as media + purchaseUrl in text
User: "Show me what products I can customize"
→ browse_templates → send ALL template images as media with captions

Output Structure

browse_templates

[
  {
    "index": 1,
    "templateId": 3,
    "name": "Men's Hoodie",
    "price": "$29.9 USD",
    "localImagePath": "/Users/.../.openclaw/workspace/template_images/template_3_xxx.jpg",
    "remoteImageUrl": "https://...",
    "skuType": "hoodie"
  }
]

generate_preview --json

{
  "taskId": "task_xxx",
  "status": "PENDING",
  "estimatedSeconds": 45,
  "templateId": 3,
  "_success": true
}

get_status --json (completed)

{
  "taskId": "task_xxx",
  "status": "COMPLETED",
  "purchaseUrl": "https://leewow.com/h5/preview?taskId=xxx&skid=...&sig=...",
  "localImagePath": "/Users/.../.openclaw/workspace/previews/leewow_preview_task_xxx.jpg"
}

User: "I want to make a custom gift for my friend"
→ browse_templates → for each template: send cover image as media + text caption
→ user picks → generate_preview → get_generation_status --poll
→ send preview image as media + purchaseUrl in text
User: "Turn this photo into a phone case"
→ browse_templates --category phone → send images as media → user picks
→ generate_preview → get_generation_status --poll
→ send preview image as media + purchaseUrl in text
User: "Show me what products I can customize"
→ browse_templates → send ALL template images as media with captions

Environment variables are loaded from ~/.openclaw/.env:

CLAW_SK=sk-leewow-xxxx-xxxx
CLAW_BASE_URL=https://leewow.com
CLAW_PATH_PREFIX=/v2
LEEWOW_API_BASE=https://leewow.com