OpenClaw 接入阿里云百炼Alibaba Model StudioWan 视频生成完全指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawOpenClaw 内置的alibaba插件以 DashScopeModel Studio 国际版为后端为 Agent 提供阿里通义万相Wan系列模型的视频生成能力开箱即用、默认启用只需一个 API Key 即可完成接入。本文将以 docs/providers/alibaba.md 为主线结合 extensions/alibaba 插件源码与测试用例完整讲解认证配置、模型选型、能力边界、高级配置与底层调用原理帮助你在 OpenClaw 中快速跑通从文本/图片/参考视频生成 AI 视频的完整链路。插件概览Provider 身份与默认值alibaba插件是 OpenClaw 内置bundled插件用于在 Alibaba Model StudioDashScope 的国际名称上注册 Wan 系列模型的 video-generation provider。它默认启用enabledByDefault: true属于媒体media类目无需手动激活——只要提供 API Key 即可使用。从 openclaw.plugin.json 可以看到插件通过contracts.videoGenerationProviders: [alibaba]声明其能力契约而 index.ts 中register钩子同时做了两件事注册alibabaprovider含 API Key 认证方式并调用api.registerVideoGenerationProvider(...)注册视频生成 provider。官方文档给出的 Provider 核心属性如下PropertyValueProvider idalibabaPluginbundled,enabledByDefault: trueAuth env varsMODELSTUDIO_API_KEY→DASHSCOPE_API_KEY→QWEN_API_KEY(first match wins)Onboarding flag--auth-choice alibaba-model-studio-api-keyDirect CLI flag--alibaba-model-studio-api-key keyDefault modelalibaba/wan2.6-t2vDefault base URLhttps://dashscope-intl.aliyuncs.com对应到源码video-generation-provider.ts 中定义了默认 Base URL 常量https://dashscope-intl.aliyuncs.com与文档一致index.ts 中envVars数组依次声明了三个可接受的环境变量解析时取第一个非空值。认证方式的实现细节index.ts 通过createProviderApiKeyAuthMethod注册了 API Key 认证flagName: --alibaba-model-studio-api-key——对应直传 CLI 参数optionKey: alibabaModelStudioApiKey——对应配置/命令行选项键envVar: MODELSTUDIO_API_KEY——向导写入时优先使用的主环境变量wizard.choiceId: alibaba-model-studio-api-key——onboarding 交互中的认证选项 IDonboardingScopes: [image-generation]——该认证仅服务于媒体生成类目。测试用例 video-generation-provider.test.ts 验证了该注册行为捕获插件注册结果后videoGenerationProviders只包含alibaba一个 provider、modelCatalogProviders为空、provider 列表长度为 1且非交互式校验validateNonInteractive会把--alibaba-model-studio-api-key的值正确解析为MODELSTUDIO_API_KEY对应的 API Key。快速开始三种方式配置 API Key方式一通过 onboarding 向导存储openclaw onboard --auth-choice alibaba-model-studio-api-key交互式向导会把 Key 持久化到alibabaprovider 的认证存储中。方式二命令行直传openclaw onboard --alibaba-model-studio-api-key your-key该方式对应源码中flagName: --alibaba-model-studio-api-key的定义适合脚本化接入。方式三导出环境变量在启动 Gateway 之前export MODELSTUDIO_API_KEYsk-... # or DASHSCOPE_API_KEY... # or QWEN_API_KEY...三个变量按MODELSTUDIO_API_KEY→DASHSCOPE_API_KEY→QWEN_API_KEY的优先级取第一个非空值。从测试 video-generation-provider.test.ts 可以看到仅设置MODELSTUDIO_API_KEY时isConfigured即返回true说明环境变量发现机制是生效的。值得注意的一个细节环境变量QWEN_API_KEY是 Qwen 插件与 Alibaba 插件共享的。测试 video-generation-provider.test.ts 证明如果继承到的是 Qwen Coding Plan 的sk-sp-前缀 Keyprovider 不会将其视为有效认证。设置默认视频模型在 OpenClaw 配置文件中通过agents.defaults.mediaModels.video.primary指定默认视频模型{ agents: { defaults: { mediaModels: { video: { primary: alibaba/wan2.6-t2v, }, }, }, }, }设置后Agent 调用video_generate工具时会自动使用该模型无需每次显式指定。该配置项与 docs/gateway/config-agents.md 中关于 agent defaults 的模型配置体系一致video_generate工具的完整参数与运行模式见 docs/tools/video-generation.md。验证配置是否生效openclaw models list --provider alibaba该命令会列出全部五个内置 Wan 模型。如果MODELSTUDIO_API_KEY无法解析例如未设置、值为空openclaw models status --json会在auth.unusableProfiles中报告缺失的凭据便于在自动化脚本中快速诊断。凭据有效性检查的源码依据插件在提交请求前就会做一次能力门禁检查。从 video-generation-provider.ts 的credentialPolicy可以看到两层校验acceptsApiKey拒绝以sk-sp-开头的 Key——这类 Key 属于阿里云 Coding Plan / Token Plan 凭据虽然与 Alibaba 共用环境变量别名但无法通过 Wan 请求认证acceptsBaseUrl拒绝coding.dashscope/token-plan.*.maas等非标准端点。对应测试 video-generation-provider.test.ts 验证了解析到 Coding Plan Key 时直接抛错且不发起任何 HTTP 请求的行为错误信息为Alibaba Wan video generation requires a Standard DashScope endpoint and a same-region Standard API key; Coding Plan and Token Plan credentials are not supported.内置 Wan 模型清单Model refModealibaba/wan2.6-t2vText-to-video (default)alibaba/wan2.6-i2vImage-to-videoalibaba/wan2.6-r2vReference-to-videoalibaba/wan2.6-r2v-flashReference-to-video (fast)alibaba/wan2.7-r2vReference-to-video其中wan2.6-r2v-flash是快速版参考视频生成模型。测试 video-generation-provider.test.ts 通过expectExplicitVideoGenerationCapabilities断言了每个模型只对外声明其匹配的运行时模式mode且defaultModel与models列表与 SDK 中的DEFAULT_DASHSCOPE_WAN_VIDEO_MODEL、DASHSCOPE_WAN_VIDEO_MODELS常量保持一致。能力与限制每个模型只声明与其匹配的运行时模式几何参数geometry也遵循该模型族在厂商协议中的约定而不是发送一个通用的参数形状。各模式的具体限制如下ModeMax output videosReference limitsMax durationSupported controlsText-to-video1n/a15 ssize,aspectRatio,resolution,audio,watermarkImage-to-video11 image15 sresolution,audio,watermarkReference-to-video (Wan 2.6)15 total images/videos; up to 3 videos10 ssize,aspectRatio,resolution,audio,watermarkReference-to-video (Wan 2.7)15 total images/videos; up to 3 videos10 ssize,aspectRatio,resolution,watermark; audio is always on各模式的请求参数语义Wan 2.6 文本/参考模型将resolution与aspectRatio换算为文档规定的精确sizeWan 2.6 图生视频发送resolution档位并沿用输入图片自身的宽高比Wan 2.7 参考视频发送更新的media、resolution、ratio字段且始终生成音频audio 不可关闭。请求未指定durationSeconds时采用 DashScope 接受的默认值5 秒。底层请求形状从测试用例看实际 HTTP 调用测试 video-generation-provider.test.ts 完整还原了一次异步生成流程可以据此确认真实请求结构提交端点https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisPOST JSON请求体model为模型名如wan2.6-r2v-flashinput.prompt为提示词文本input.reference_urls为参考素材 URL 数组parameters.duration、parameters.audio、parameters.watermark一一映射到用户传入的durationSeconds、audio、watermark参数提交后轮询任务状态GET/api/v1/tasks/{task-id}完成后下载最终视频文件示例中为https://example.com/out.mp4。这套提交异步任务 → 轮询 → 下载的流程与 docs/tools/video-generation.md 中描述的异步生成机制完全吻合任务在后台处理期间同一会话内的重复video_generate调用会返回当前任务状态而不是重复发起新任务。⚠️ 参考素材必须是远程 URL参考图片与参考视频必须为远程http(s)URLDashScope 的参考模式会拒绝本地文件路径。请先上传到对象存储或使用 media tool 流程该流程产出的就是公网 URL。对应的快速失败逻辑有测试覆盖video-generation-provider.test.ts 验证了当inputImages传入本地 buffer{ buffer, mimeType }时provider 直接抛出Alibaba Wan video generation currently requires remote http(s) URLs for reference images/videos.错误且不会发起任何 HTTP 请求。高级配置覆盖 DashScope Base URL切换国内区端点Provider 默认使用 DashScope 国际端点。要切换到国内区端点在配置文件的models.providers.alibaba下设置baseUrl{ models: { providers: { alibaba: { baseUrl: https://dashscope.aliyuncs.com, }, }, }, }Provider 在拼接 AIGC 任务 URL 前会去除尾部斜杠trailing slashes因此两种写法...com与...com/均可用。注意国内与国际端点需要对应区域的 Standard API Key混用会导致认证失败。认证环境变量优先级OpenClaw 按以下顺序解析 Alibaba API Key取第一个非空值MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY通过openclaw models auth login配置的auth.profiles条目优先于环境变量解析。轮换rotation、冷却cooldown与覆盖override机制详见 Auth profiles in the models FAQ。源码与测试对profile 优先于环境变量的语义有明确验证video-generation-provider.test.ts 分别验证了 profile 中sk-ws-Standard Key 与环境变量sk-sp-Coding Key 共存时以 profile 为准、反之 profile 中 Coding Key 不会让 provider 生效的两种情况。与 Qwen 插件的关系两个内置插件都对接 DashScope且接受重叠的 API Key。使用建议alibaba/wan*.*模型 ID用于本页介绍的专用 Wan 视频生成能力qwen/*模型 ID用于 Qwen 的对话chat、向量化embedding、媒体理解media understanding见 Qwen。只要设置一次MODELSTUDIO_API_KEY两个插件即可同时完成认证认证环境变量列表是刻意重叠的无需分别对两个插件执行 onboarding。请求策略request policy的应用从源码与测试还可以看到provider 支持在models.providers.alibaba.request下配置请求策略例如允许访问私有网络或附加自定义请求头。video-generation-provider.test.ts 验证了request.allowPrivateNetwork、request.headers会被正确传递到任务轮询与视频下载请求并应用 SSRF 策略与调度器策略dispatcherPolicy。这为需要内网/代理环境的部署提供了灵活的出口控制能力。实战排查清单models list看不到 Wan 模型检查MODELSTUDIO_API_KEY/DASHSCOPE_API_KEY/QWEN_API_KEY是否已设置且非空用openclaw models status --json查看auth.unusableProfiles中是否报告缺失凭据。提交报 Coding/Token Plan 不支持确认 Key 不是sk-sp-前缀且baseUrl不是coding.dashscope或token-plan.*.maas端点必须使用 Standard 端点与同区域 Standard Key。参考模式报本地路径错误参考图片/视频必须使用http(s)公网 URL先走 media tool 或对象存储完成上传。生成的视频时长不对未传durationSeconds时按 5 秒默认值处理且不同模式有 10 s / 15 s 的上限约束。任务长时间无结果视频生成为异步任务OpenClaw 提交后轮询任务状态可用openclaw tasks list/openclaw tasks show lookup查看后台任务详见 Background tasks若该文档路径在仓库中存在。相关资源Video generationvideo_generate工具的参数与多 Provider 选择逻辑Qwen基于同一 DashScope 认证的 Qwen 对话/向量化/媒体理解配置Configuration referenceagent defaults 与模型配置体系Models FAQauth profiles、模型切换与 no profile 错误的排查。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考