Doubao Native Media Skill
This is a native OpenClaw skill. Do not spin up the upstream MCP server unless the user explicitly asks for MCP compatibility.
Use this skill for
- - Doubao / 豆包 text-to-image
- image-to-image or multi-reference image generation
- Doubao text-to-video or image-to-video
- querying an async Doubao video task by INLINECODE0
- troubleshooting Volcengine Ark endpoint/model issues
Commands
Generate an image
CODEBLOCK0
Generate a video
CODEBLOCK1
Query a video task
CODEBLOCK2
Wait for a video task and optionally download the result
CODEBLOCK3
Input rules
- - Always prefer
--endpoint-id when the user has a provisioned Volcengine Ark endpoint. - Fall back to model names only when endpoint ids are unavailable.
- For video generation, this skill mirrors the upstream behavior and appends
--dur, --fps, --rs, and --ratio to the prompt when they are not already present. - If the user supplies image URLs, pass them through exactly; do not download or re-host unless asked.
Troubleshooting
- - If neither
--endpoint-id nor a default endpoint env var exists, the script falls back to the default model env var. - If the API returns
InvalidEndpointOrModel.NotFound, ask the user to verify the Volcengine Ark endpoint authorization first. - Video generation is async. If generation succeeds, capture
task_id and query it later with the task subcommand, or use wait for automatic polling.
References
- - Read
references/api-notes.md when you need request shapes, defaults, or caveats.
豆包原生媒体技能
这是一个原生OpenClaw技能。除非用户明确要求MCP兼容性,否则不要启动上游MCP服务器。
使用此技能的场景
- - 豆包(Doubao)文生图
- 图生图或多参考图像生成
- 豆包文生视频或图生视频
- 通过task_id查询异步豆包视频任务
- 排查火山引擎方舟(Volcengine Ark)端点/模型问题
命令
生成图像
bash
python3 {baseDir}/scripts/doubao_media.py image \
--prompt 雨夜中的赛博朋克小巷,电影质感 \
--size 2560x1440
生成视频
bash
python3 {baseDir}/scripts/doubao_media.py video \
--prompt 一只熊猫宇航员在月球上挥手 \
--video-duration 5 \
--fps 24 \
--resolution 1080p
查询视频任务
bash
python3 {baseDir}/scripts/doubao_media.py task --task-id your-task-id
等待视频任务完成并可选下载结果
bash
python3 {baseDir}/scripts/doubao_media.py wait \
--task-id your-task-id \
--timeout 600 \
--interval 5 \
--download-to ./doubao-result.mp4
输入规则
- - 当用户拥有已配置的火山引擎方舟端点时,始终优先使用--endpoint-id。
- 仅在端点ID不可用时,回退到仅使用模型名称。
- 对于视频生成,此技能会镜像上游行为,在提示词中尚未包含--dur、--fps、--rs和--ratio参数时自动追加。
- 如果用户提供图像URL,请原样传递;除非被要求,否则不要下载或重新托管。
故障排查
- - 如果既不存在--endpoint-id,也不存在默认端点环境变量,脚本将回退到默认模型环境变量。
- 如果API返回InvalidEndpointOrModel.NotFound,请先要求用户验证火山引擎方舟端点的授权。
- 视频生成是异步的。如果生成成功,捕获task_id,稍后使用task子命令查询,或使用wait进行自动轮询。
参考资料
- - 当需要请求格式、默认值或注意事项时,请阅读references/api-notes.md。