适用场景

当用户希望通过 GoAI 进行文生视频（text-to-video）或图生视频（image-to-video）生成时，使用本技能。典型提示词包括：生成视频、做视频、出视频、文生视频、图生视频、做个动画等。

除非用户明确要求对提示词进行优化、润色、重写、翻译或补充创意细节，否则应原样传递用户的视频提示词。切勿静默地扩充简短提示词。

请勿将用户的提示词翻译为其他语言。若用户使用中文输入，则将中文内容直接传入 --prompt；若用户使用英文输入，则将英文内容直接传入 --prompt。仅可剥离轻量级请求包裹语，例如 帮我、给我、请、生成 或 做个，但不得改写提示词的核心内容。

示例：

• 用户：给我生成一段狮子奔跑的视频 → --prompt "一段狮子奔跑的视频" 或 --prompt "给我生成一段狮子奔跑的视频"
• 用户：做个海浪视频 → --prompt "做个海浪视频" 或 --prompt "海浪视频"
• 切勿将 给我生成一段狮子奔跑的视频 自动转为 a lion running video，除非用户明确要求英文翻译。

默认行为

当前该包面向生产环境 https://mustgoai.com。仅当您有意使用不同端点时，才覆盖 GOAI_BASE_URL。

本技能目前通过 uv 使用统一的跨平台 Python 入口脚本。若用户未指定模型，脚本将调用 /api/v1/models/capabilities 接口，按 display.priority 对已启用的视频模型排序，并根据用户请求的 video_mode 过滤后选取优先级最高的兼容模型。当用户未提供视频参数时，脚本将从同一能力接口响应中推导默认宽高比、时长与分辨率。

请将 uv 视为用户需手动安装的唯一运行时依赖项。首次运行时，uv 可能会创建本地环境、安装 httpx，并在系统无可用 Python 解释器时自动下载 Python。该初始化过程属于预期行为，不应被描述为错误。

若用户提供本地图像路径，脚本将先上传图像，并将返回的 URL 作为 images 参数发送；若用户提供远程 URL，则脚本将原样透传。

脚本规则

始终通过 uv 调用 Python 入口脚本：

uv run --project . python scripts/generate_video.py 
  --prompt "..." 
  [--model "..."] 
  [--aspect-ratio "..."] 
  [--duration "8"] 
  [--resolution "1080p"] 
  [--video-mode "frames"] 
  [--image "/path/to/image.png"] 
  [--image "https://example.com/image.png"]

Python 入口脚本会校验 GOAI_API_KEY，在未设置 GOAI_BASE_URL 时默认使用 https://mustgoai.com，并将 401、402、429、内容拦截、缺失 task_id、缺失 video_url 以及后端终态失败等情形视为硬性失败。轮询逻辑遵循 Web 客户端行为：每 3 秒检查一次，对临时性轮询错误进行重试，并等待后端返回终态结果，而非强制施加客户端超时限制。

若该 Python 入口脚本被误以 python scripts/generate_video.py ... 或 python3 scripts/generate_video.py ... 方式调用，入口脚本将自动修复为 uv run 执行。请勿尝试为此技能修复系统 Python 环境。

通过 OpenClaw 的 exec 工具调用本技能时，务必设置 timeout=600，以允许最多 10 分钟的长耗时视频生成任务。除非脚本自身非零退出，或后端报告终态失败，否则不得将执行描述为“超时”或“被终止”。

若系统中缺少 uv，请明确引导用户先行安装：

• macOS：brew install uv
• Windows：winget install astral-sh.uv

安装 uv 后，请重新运行相同命令。请勿要求用户手动安装 Python 包；uv 负责准备 Python 运行环境及本技能所需的所有依赖。

若执行时报错缺少 Python 模块（如 httpx），请勿运行 pip install、pip install --user 或 pip install --break-system-packages。请通过 uv 重新运行本技能；其依赖集合完全由 pyproject.toml 和 uv.lock 定义。

若缺失 GOAI_API_KEY，请明确引导用户访问 https://mustgoai.com，完成注册或登录后，进入 Settings -> API Key 页面创建密钥，并在 ~/.openclaw/openclaw.json 中配置本技能的环境变量。

输出约定

成功执行后，必须严格按以下顺序输出全部四行：

• MEDIA:/absolute/path/to/generated-file
• MEDIA_URL:https://...
• RESULT_PATH:/absolute/path/to/generated-file
• RESULT_URL:https://...

向用户反馈成功结果时，即使 OpenClaw 已渲染或读取了本地媒体文件，也必须在纯文本中同时包含精确的本地文件路径和精确的公开 URL。不得因媒体预览成功而省略 URL。执行失败时，请以非零状态码退出，并打印简洁明了的错误信息。禁止将二进制输出内联回对话中。