by 运行时依赖
安装命令
点击复制技能文档
Clipcat CLI 当您需要通过 Clipcat 创建 TikTok 电商视频时使用此技能。获取 API 密钥：https://clipcat.ai/workspace?modal=settings&tab=apikeys 此技能故意简短。详细标志和支持值属于 CLI 本身 —— 总是将 clipcat -h 和 clipcat <子命令> -h 视为主要参考。
安装 此技能由 OpenClaw 自动安装，使用上方 frontmatter 中声明的安装规范。OpenClaw 从 https://static.clipcat.ai/public/cli/vX.Y.Z/ 下的版本化、不可变 URL 下载平台特定二进制文件，并将其放在 ~/.openclaw/tools/clipcat/ 下。不执行远程 shell 脚本。安装后，配置您的 API 密钥一次：clipcat config --api-key <您的密钥>
此 CLI 的用途 clipcat 是所有 Clipcat AI 视频生成工作流的本地入口点： 搜索关键词的热门 TikTok 视频 按关键词搜索 TikTok Shop 产品（市场情报） 获取 TikTok Shop 产品详细信息和评论 复制带有您的产品的热门视频 从图像生成产品视频 使用 GPT Image 2（可选参考图像）从文本提示生成 AI 图像 分析视频（脚本、场景、音乐） 下载 TikTok/Douyin 视频 查询异步任务状态 默认代理工作流 从 clipcat -h 开始查看所有命令。在使用任何命令之前，运行 clipcat <子命令> -h 查看标志。默认为 JSON 输出。仅在结果用于人类终端阅读时使用 --pretty。当命令消耗积分时，警告用户。
选择正确的命令 search —— 按关键词查找热门 TikTok 视频；支持 --region、--sort-by 相关性|喜欢、--time-range 任意|天|周|月|季度|半年、--require-shop search_items —— 按关键词搜索 TikTok Shop 产品；返回市场洞察、竞争对手商店和产品情报；支持 --region、--offset、--page-token 用于分页 product_detail —— 通过 --input 获取产品信息；支持 --region product_comment —— 通过 --input 获取产品评论；支持 --region、--sort-rule、--filter-type、--filter-value replicate —— 复制带有您的产品图像的热门视频（自动检测 URL 类型）；图像通过 --image（本地）或 --image-url（URL）；本地文件和 URL 可以混合；支持 --model、--duration、--size、--lang、--resolution、--character-id product_video —— 仅从产品图像生成视频（无参考视频）；图像通过 --image（本地）或 --image-url（URL）；本地文件和 URL 可以混合 image —— 使用 GPT Image 2 模型从文本提示生成 AI 图像；可选提供最多 5 个参考图像通过 --image（本地文件）或 --image-url（URL）。使用 --aspect-ratio 选择 1:1（默认）/ 16:9 / 9:16 list_images —— 列出从服务器生成的图像任务；支持 --status / --limit / --page 过滤器 breakdown —— 分析视频（脚本、场景、音乐）；立即返回缓存结果，如果之前已分析 download —— 下载 TikTok/Douyin 视频（返回签名 URL）；缓存结果立即返回 user_videos —— 获取带有分析的 TikTok 用户的视频列表（播放、喜欢、分享、评论、电商购物车数据）；--unique-id 必需；传递 --sec-user-id 以跳过 ID 解析并加快响应；支持 --max-cursor 分页和 --sort-type 0|1 query_task —— 通过 ID 和类型（--type replicate | product | breakdown | download | image）检查任务状态。省略 --task-id 以恢复最新的本地任务。 list_tasks —— 列出来自服务器的最近与视频相关的任务（--type 必需：replicate | product | breakdown | download）。图像任务使用 list_images。
复制：URL 类型自动检测 clipcat replicate 自动检测 URL 类型： TikTok/Douyin 链接 → 调用 /replicate_from_social（下载消耗 1 个额外积分） 直接视频 URL → 调用 /replicate 始终在运行具有社交 URL 的命令之前通知用户有关额外积分。
clipcat:// 资产引用 在早期回合中看到的 clipcat://... 字符串是稳定的资产引用。将它们逐字传递给任何 --image-url / --character-id 标志 —— 永远不要添加 https:// 或修改它们。有关详细信息，请参阅子命令 -h。
异步任务规则 replicate、product_video、image 和 breakdown 是异步的。所有四个提交并立即返回任务 ID —— 它们永远不会阻塞。典型持续时间：image ~3 分钟，breakdown 几分钟，product_video / replicate 10+ 分钟。永远不要尝试在单个工具调用内同步等待 —— 每个现实的代理工具都有一个工具调用超时（通常为 60 秒），它将在任务完成之前杀死调用。始终提交 → 返回 → 轮询跨回合。任务 ID 自动保存在 ~/.clipcat/tasks.json 中。使用 clipcat query_task --task-id --type 检查状态。每个调用立即返回当前状态。省略 --task-id 以恢复最新任务。在回合中重新调用命令（建议节奏：~30 秒用于 image，~1-2 分钟用于 breakdown / product_video / replicate），直到状态完成或失败。