技能介绍

多模态生成的常见痛点是接口分散和长耗时任务阻塞。生图、生视频、音频与短剧通常需要维护多套客户端，且视频渲染动辄几分钟，若不处理异步轮询，很容易卡住 Agent 主线程。ArtClaw 试图用一个 CLI 工具解决这些问题。

核心机制

技能以 scripts/artclaw.py 作为唯一入口，覆盖鉴权、提交、轮询、重试和历史记录。启动时会探测当前 Agent 平台，并加载 docs/adapters/ 下对应的适配器文档。不同平台的异步策略完全不同：Claude Code 依赖 run_in_background 与 /tasks；OpenClaw 兼容平台则使用 --spawn；其他不支持 spawn 的环境默认走 --no-wait。这种设计避免了把一种平台的规则硬套到另一种平台上。

执行具体任务前，必须先运行 python3 scripts/artclaw.py verify-key。生图支持 doubao-seedream-5-0-260128，并可切换 youchuan-v-7 或 Navo Bana 系列；生视频默认使用 doubao-seedance-2-0-260128，音频与文本模型也有明确清单。所有任务返回 job_id 后，应通过 job-status、last-job 或 history 追踪，而不是重新提交。

适用边界

API Key 需要提前在 https://artclaw.com/settings 创建，本地数据存放在 ~/.artclaw/。语音任务的 TTL 较短，404 错误通常意味着任务过期，需要重新提交。批量生视频时，一旦拿到 job_id 就不能再重复提交同一条请求。429 错误说明触发限流，需要等待重试；402 则意味着额度不足。