Custom Gift — Leewow

这个 skill 的收益很直接：

• - 帮用户快速找到心仪的可定制商品
• 把图片、照片或创意做成礼物、周边和个人用品
• 提供非常灵活的个性化定制服务，从浏览到效果图预览一条链路完成

Leewow 在这个 skill 里的角色很简单：

• - 向用户展示真实可定制商品
• 帮用户选择模板
• 生成效果图并进入下单链路

所以当用户在问“能定制什么”“有哪些商品/模板可以选”时，默认应该先进入商品浏览流程，而不是先回答公司层面的泛化能力介绍。

When to Use

• - User wants to send a gift or create something personalized
• User says "browse products", "show me what I can customize", "gift ideas"
• User says in Chinese: "看看有啥能定制的", "看看有什么可以定制的", "有哪些可定制产品", "有什么模板", "看看定制品", "能做哪些定制品"
• User asks what physical products / items / templates are available to customize
• User provides an image and wants to turn it into a product
• User says "make this into a mug/bag/shirt", "customize this design"

Trigger Priority

For browse-style requests, browse_templates is the default first step.
Use a broad Leewow capability summary only if browse_templates fails.

ClawHub rate-limited? Install directly from GitHub:
INLINECODE2

Install Fallback

If ClawHub is rate-limited, install this skill directly from GitHub:

• - Repository: INLINECODE3
• Skill path: INLINECODE4

Manual fallback:

CODEBLOCK0

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

What the agent does (keep it minimal)

Browse — browse_templates sends product cards directly from Python and returns only send results. If the tool succeeds, reply with NO_REPLY. In normal chat usage, pass the current Feishu conversation target as feishu_target.

Preview — get_generation_status sends the generated preview result directly to Feishu from Python and returns only send results. If the tool succeeds, reply with NO_REPLY. Preview result cards intentionally use a different layout from browse cards.

Prerequisites

• - CLAW_SK — Leewow Secret Key (format: sk-leewow-{keyId}-{secret})
• Obtain it from: INLINECODE15
• INLINECODE16 — Feishu App ID (often referred to together with App Secret as app AK/SK)
• INLINECODE17 — Feishu App Secret
• Obtain them from your Feishu Open Platform app settings page
• INLINECODE18 — fallback Feishu target for this skill
• INLINECODE19 — optional, defaults to INLINECODE20
• INLINECODE21 — API base URL (default: https://leewow.com)
• INLINECODE23 — Path prefix (default: /v2 for leewow.com)
• INLINECODE25 — Base URL for COS STS credentials (default: https://leewow.com)
• Python 3.10+ with requests and INLINECODE28

Configuration

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

CODEBLOCK1

Prefer runtime target passing:

• - when the current Feishu conversation target is already known, pass it as INLINECODE30
• INLINECODE31 is only a fallback

Image Requirements (IMPORTANT)

For Input Images (User Upload)

• - Must be in workspace directory: INLINECODE32
• Supported formats: JPG, PNG, WebP
• Recommended: Clear, well-lit images for best results

For Preview Images (Generated Output)

• - Automatically saved to: INLINECODE33
• Filename format: INLINECODE34
• The agent can directly display these images to users

COS Presigned URLs

CODEBLOCK2

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

Typical Flow (Generator Pattern)

1. 1. Browse — browse_templates → Python sends Feishu product cards directly → agent replies NO_REPLY → user picks a Template ID when ready
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 — get_generation_status → Python sends preview result directly → final assistant reply is INLINECODE43

Tool Reference

browse_templates

Browse available product templates.

CODEBLOCK3

Options:

• - --category: Filter by category (bag, accessory, home, apparel)
• INLINECODE45: Number of products to return (1-10, default 5)
• INLINECODE46: Direct-send to Feishu and return send result JSON
• INLINECODE47: Current Feishu conversation target. In normal use, treat this as required.
• INLINECODE48: Debug mode that returns raw template data

generate_preview

Upload image and trigger generation.

CODEBLOCK4

Options:

• - --image-path: Required. Path to design image (must be in workspace)
• INLINECODE50: Required. Product template ID from browse_templates
• INLINECODE51: Optional style description
• INLINECODE52: Image ratio (3:4, 1:1, 4:3, default 3:4)
• INLINECODE53: Output JSON format

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

getgenerationstatus

Check generation status and download preview image.

CODEBLOCK5

Options:

• - task_id: Task ID from generate_preview
• INLINECODE55: Wait until generation completes
• INLINECODE56: Poll timeout in seconds (default 120)
• INLINECODE57: Skip downloading preview image
• INLINECODE58: Output JSON format
• INLINECODE59: Current Feishu conversation target. In normal use, treat this as required.

Returns: Generation status and, in direct-send mode, send result JSON.

Safety Rules

• - Never expose or log the CLAW_SK value. When confirming configuration, only show the last 4 characters.
• Input images must be in workspace directory for the agent to access them
• Preview images are automatically saved to INLINECODE61
• Limit browse results to 10 templates maximum per request

Examples

CODEBLOCK6

Output Structure

browse_templates --json

CODEBLOCK7

→ Python sends product cards directly to Feishu. Agent returns NO_REPLY.

generate_preview --json

getgenerationstatus --json (completed)

{
  "taskId": "task_xxx",
  "status": "COMPLETED",
  "mode": "direct_feishu_send",
  "messageCount": 1,
  "messageIds": ["om_card_xxx"],
  "feishuImagesResolved": true,
  "finalAssistantReply": "NO_REPLY"
}

Version Marker: custom-gift-leewow@1.0.24