Runware Run 是基础的 Openclaw Skills 技能，引导智能体在每种模态下安全、符合架构且感知成本地执行 Runware 任务。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install runware-run
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 runware-run。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Runware Run？
Runware Run 是 Openclaw Skills 的执行契约，可将模型选择转化为真实、可靠的 Runware 调用。
它引导智能体如何选择正确的 AIR 和 taskType、解析模型的 JSON Schema、正确上传或编码输入、选择同步或异步交付，并毫无悬念地读取特定模态的响应。无论是通过 TypeScript SDK、Python SDK、MCP 工具、CLI，还是通过 api.runware.ai/v1 兼容 OpenAI 的端点调用 Runware，这都意味着更少的无效请求、更干净的自动化和可预测的成本控制。
Runware Run 应用场景
Openclaw Skills 团队会在以下情况下使用此技能：
- 智能体即将发起真实的 Runware 生成调用，且需要正确的执行流程。
- 您必须在 imageInference、videoInference、audioInference 或 modelUpload 之间进行选择。
- 新发布的模型尚未进入 SDK 注册表，需要显式的 taskType。
- 您需要在发送上线前，根据模型架构验证负载。
- 本地文件必须先上传，并作为 URLs 或 base64 输入进行引用。
- 长期运行的任务需要使用 taskUUID 和 getResponse 进行异步轮询。
- 您希望通过 X-Runware-Dry-Run: 1 或 includeCost: true 获得成本可见性。
- 同一个 Runware 契约必须在 SDK、MCP、CLI 或 API 层面通用。
Runware Run 工作原理
- 选择模型和执行类型。从 runware-models 获取模型，选择 AIR，并根据模态设置 taskType；对于新发布或未注册的模型，需显式传递 taskType。
- 解析架构。检查模型的 JSON Schema，仅填充已文档化的字段名称；切勿杜撰参数名称。
- 准备输入。将图像、视频、音频、蒙版和其他资产作为 URLs 或 base64 发送；使用 SDK 或 MCP 辅助程序时，先上传本地文件。
- 使用正确的交付模式执行。对图像和其他快速任务使用同步调用；对视频、音频、3D 和训练使用异步执行，然后使用返回的 taskUUID 轮询 getResponse，直到任务结束。
- 读取最终输出。获取特定模态的结果，如图像 URLs、videoURL 或 3D 的 outputs.files[].url，并在需要时通过 includeCost 获取成本。
- 生产前进行验证和优化。使用 X-Runware-Dry-Run: 1 来验证请求并预览成本，无需实际执行，也无需付费。
Runware Run 配置指南
- 安装您计划使用的界面。
npm install @runware/sdk
pip install runware
- 尽可能优先使用 SDK 或 MCP，因为它们会为您处理架构解析、文件上传和异步轮询。
- 在生产前，使用
X-Runware-Dry-Run: 1验证不确定的负载，并在生产运行中启用includeCost: true。 - 对于长期运行的任务，存储返回的 taskUUID 并轮询 getResponse，直到任务达到最终状态。
Runware Run 数据架构与分类体系
Runware Run 遵循架构优先的请求/响应模型：
| 实体 | 用途 | 规则 |
|---|---|---|
taskType |
选择模态管道 | 使用 imageInference、videoInference、audioInference 或 modelUpload |
model / AIR |
标识要运行的模型 | 使用诸如 bfl:7@1 的 AIR；别名（slugs）也支持解析 |
| 参数 | 特定模型选项 | 必须与模型的 JSON Schema 完全匹配 |
| 输入 | 媒体和参考资产 | 传递 URLs 或 base64；优先上传本地文件 |
| 交付模式 | 控制运行时行为 | 图像和快速任务同步，视频、音频、3D 和训练异步 |
taskUUID |
异步任务句柄 | 长期运行的任务会返回；轮询 getResponse |
| 输出 | 最终产物 | 图像返回 URLs，视频返回 videoURL，3D 返回 outputs.files[].url |
| 成本元数据 | 价格可见性 | X-Runware-Dry-Run: 1 仅用于估算验证，includeCost: true 用于实际运行 |
元数据分类
- 标识: AIR 或别名，以及需要时的
taskType。 - 输入负载: 提示词、参考媒体、蒙版、音频、训练资产以及任何其他经架构批准的字段。
- 执行元数据: 同步与异步、返回的
taskUUID和轮询状态。 - 计费元数据: dry-run 验证和实际成本报告。
- 输出产物: 特定模态的 URLs 或文件列表，绝非单一假设的响应形式。
Runware Run 高级特性
- 执行前的架构解析消除了猜测和无效的参数名称。
- Dry-run 模式可验证请求形式并返回成本，无需执行或付费。
includeCost: true可在实际运行中显示真实支出，以便进行感知成本的自动化。- 使用
taskUUID和getResponse的异步编排可以防止长期任务发生同步超时。 - TypeScript SDK、Python SDK、MCP、CLI 和 api.runware.ai/v1 之间具有跨平台的一致性。
- 基于 AIR 的寻址加上显式的 taskType，在注册表更新前支持新发布或测试的模型。
- 内置适用于本地文件、参考图像、源视频、音频和蒙版的上传流程。
SKILL.md
加载中
Openclaw 相关技能
开源 Issue 优先工作流
一个 Openclaw Skills 工作流，强制您在为开源 Bug 编写自定义临时变通方案之前，先搜索上游 issue 和 release。
精选*
