# 1-h Video Provider (`1h-video`) OpenClaw 视频生成驱动模块,适配标准 **OpenAI Videos API**(`/v1/videos` 规范)。 专为自建聚合网关或第三方中转(如 `gemini-web2api-go`、`ccLoad`)做了深度兼容修复: * **任务创建**:`POST /v1/videos`。纯文本任务自动发送 JSON Body,避免第三方服务因不支持 Multipart 表单报 400 错误;带参考图/垫视频时使用标准 Multipart 表单。 * **状态轮询**:`GET /v1/videos/{id}`。兼容提取普通对象错误信息与字符串错误消息。 * **视频下载**:`GET /v1/videos/{id}/content`。流式下载 MP4 二进制视频流。 * **私有网络**:原生支持私有/内网端点请求(`allowPrivateNetwork: true`),兼容 `host.incus.internal`、Tailnet 或局域网反代地址。 --- ## 配置说明 支持通过 **Web 控制台(Control UI)** 或直接编辑 `~/.openclaw/openclaw.json`。 ### 方式 1:Web 控制台可视化配置 进入 **Settings → Plugins → 1-h Tools**: * **API Base URL**:填写视频上游端点(例如 `http://host.incus.internal:8083/v1` 或内部网关地址) * **API Key**:填写 API Key 或 SecretRef(留空时自动回退读取环境变量 `OPENAI_VIDEO_API_KEY`、`CCLOAD_API_KEY` 或 `BIFROST_API_KEY`) * **默认视频模型**:例如 `gemini-video` 或 `sora-2` ### 方式 2:编辑 `openclaw.json` 在 `~/.openclaw/openclaw.json` 中配置: ```json5 { "plugins": { "entries": { "1h-tools": { "enabled": true, "config": { "video": { "baseUrl": "http://host.incus.internal:8083/v1", "apiKey": "sk-your-video-key", "defaultModel": "gemini-video", "allowPrivateNetwork": true } } } } }, "agents": { "defaults": { "mediaModels": { "video": { "primary": "1h-video/gemini-video" } } } } } ``` --- ## 使用方法 配置完成后,OpenClaw 内置的 `video_generate` 工具即可自动调度: * **自然语言直接对话生成**: > “帮我生成一个 5 秒的猫咪在海滩上奔跑的 16:9 视频” * **垫图/图生视频**: 在对话中上传或提供图片链接,提示助手基于该图生成视频。