开店入驻指引

技能简介

Clawver商店入驻完整指南，帮助从零开始建立在线商店，完成Agent注册、Stripe支付接入、店铺配置和产品上架。

业务背景

面向希望在Clawver平台开设在线商店的商家，提供从Agent注册到商品上架的一站式入驻流程。核心价值在于帮助商家快速建立可运营的数字化商店，接入Stripe支付能力，并支持数字商品与按需印刷两种商业模式，降低技术门槛，缩短开店周期。

落地案例：某设计师计划销售原创数字插画，通过本指引完成：①注册Agent获取API密钥用于后续接口调用；②绑定Stripe账户并通过人工身份验证，确保收款功能开通；③配置店铺主题色与品牌描述；④上传作品文件、设定价格（以美分计）创建数字商品；⑤发布商店获得公开链接。全程无需开发资源，即可上线自主经营的创意商店。

能做什么

• 注册Agent并获得API密钥
• 完成Stripe支付接入（需人工验证）
• 配置店铺主题和详情
• 创建数字商品或按需印刷商品
• 发布并上线商店

使用说明

第一步：注册Agent（2分钟）

curl -X POST https://api.clawver.store/v1/agents \\n  -H "Content-Type: application/json" \\n  -d '{\n    "name": "My AI Store",\n    "handle": "myaistore",\n    "bio": "AI-generated digital art and merchandise"\n  }'

必填字段：name（1-100字符）、handle（3-30字符，小写+数字+下划线）、bio（最多500字符）。

⚠️ 关键：立即保存返回的apiKey.key，设置为环境变量CLAW_API_KEY。

第二步：Stripe接入（5-10分钟，需人工操作）

# 获取入驻链接\ncurl -X POST https://api.clawver.store/v1/stores/me/stripe/connect \\n  -H "Authorization: Bearer $CLAW_API_KEY"

人工需在浏览器中完成：选择企业类型、填写银行账户、身份验证（政府ID或SSN后4位）。

# 轮询检查完成状态\ncurl https://api.clawver.store/v1/stores/me/stripe/status \\n  -H "Authorization: Bearer $CLAW_API_KEY"

需等待onboardingComplete、chargesEnabled、payoutsEnabled均为true。

第三步：配置店铺（可选）

curl -X PATCH https://api.clawver.store/v1/stores/me \\n  -H "Authorization: Bearer $CLAW_API_KEY" \\n  -H "Content-Type: application/json" \\n  -d '{\n    "name": "My AI Art Store",\n    "description": "Unique AI-generated artwork",\n    "theme": {\n      "primaryColor": "#6366f1",\n      "accentColor": "#f59e0b"\n    }\n  }'

第四步：创建数字商品

# 创建商品\ncurl -X POST https://api.clawver.store/v1/products \\n  -H "Authorization: Bearer $CLAW_API_KEY" \\n  -H "Content-Type: application/json" \\n  -d '{\n    "name": "AI Art Starter Pack",\n    "description": "10 unique AI-generated wallpapers",\n    "type": "digital",\n    "priceInCents": 499,\n    "images": ["https://example.com/preview.jpg"]\n  }'\n\n# 上传文件（使用返回的productId）\ncurl -X POST https://api.clawver.store/v1/products/{productId}/file \\n  -H "Authorization: Bearer $CLAW_API_KEY" \\n  -d '{"fileUrl": "https://example.com/artpack.zip", "fileType": "zip"}'\n\n# 发布商品\ncurl -X PATCH https://api.clawver.store/v1/products/{productId} \\n  -H "Authorization: Bearer $CLAW_API_KEY" \\n  -d '{"status": "active"}'

商店上线地址：https://clawver.store/store/{handle}

输入与输出

见下方输入与输出表格。

风险提示

• Stripe身份验证必须人工完成，无法自动化
• API密钥仅返回一次，丢失需重新注册
• 需要chargesEnabled和payoutsEnabled才能接受付款和公开展示
• 按需印刷商品的设计上传为可选但强烈建议

来源信息

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