OpenClaw Qwen 插件参考Qwen Cloud 多计划端点、模型目录与多模态契约全解析【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文以 OpenClaw 的 Qwen 插件参考文档为骨架完整解析openclaw/qwen-provider的分发方式、六个 provider 标识、端点与认证选项、按计费计划分层的模型目录、thinking 控制的数据线实现以及媒体理解与视频生成两项契约能力。读完后可独立完成 Qwen Cloud / DashScope 各计划的接入配置并理解插件在请求层做了哪些载荷约束。插件概述与分发Qwen 插件为 OpenClaw 增加Qwen、Qwen Cloud、Model Studio、DashScope、Qwen Token Plan、Bailian Token Plan模型提供者支持。它属于官方外部插件不随核心捆绑发行需要显式安装后重启 Gateway。参考文档给出的分发信息Distribution如下包名openclaw/qwen-provider安装路线npm 或 ClawHubclawhub:openclaw/qwen-provider结合 plugins 入口说明标准安装流程为openclaw plugins install openclaw/qwen-provider openclaw gateway restart从 package.json 可以确认该插件的版本约束与发布渠道当前版本2026.9.3同时发布到 npm 与 ClawHubpublishToNpm与publishToClawHub均为true默认安装渠道为 npm要求宿主版本minHostVersion: 2026.6.8插件 API 兼容版本pluginApi: 2026.9.3插件入口为./index.ts即 插件入口文件。Provider 面Surface参考文档的 Surface 一节声明了两类接口面Providersqwen、qwencloud、modelstudio、dashscope、qwen-token-plan、bailian-token-planContractsmediaUnderstandingProviders、videoGenerationProviders六个 provider id 与家族映射插件清单openclaw.plugin.json中providers数组列出了全部六个 idproviderRequest字段则把它们统一归入modelstudio请求家族provider id角色家族映射qwen规范canonicalidmodelstudioqwencloud兼容别名modelstudiomodelstudio历史兼容别名modelstudiodashscopeDashScope 端点别名modelstudioqwen-token-planToken Plan团队版规范 idmodelstudiobailian-token-plan百炼 Token Plan 兼容所有者 idmodelstudio从 入口源码 的defineSingleProviderPluginEntry定义看主 provider 的id为qwenaliases显式包含modelstudio与qwenclouddashscope作为请求家族别名同样被流包装器识别——stream.ts 的isQwenProviderId将qwen、qwen-token-plan、bailian-token-plan、modelstudio、qwencloud、dashscope六个规范化 id 都视为 Qwen 家族。qwen-token-plan与bailian-token-plan并非在主入口注册而是在register(api)回调中以独立 provider 形式注册前者带完整认证与目录后者仅作为“遗留自定义配置的所有者”注册无认证方法、仅挂载流包装器见 register 回调。这意味着如果你已经在models.providers中手写了bailian-token-plan自定义条目它的传输与目录归属不会被插件合并插件只是“占有”这个 id 以避免冲突。端点声明清单中的providerEndpoints清单 L15-L27 对应openclaw.plugin.json的providerEndpoints字段声明了端点类modelstudio-native并列出六个基地址端点计划https://coding-intl.dashscope.aliyuncs.com/v1Coding PlanGlobalhttps://coding.dashscope.aliyuncs.com/v1Coding PlanChinahttps://dashscope.aliyuncs.com/compatible-mode/v1Standard 按量付费Chinahttps://dashscope-intl.aliyuncs.com/compatible-mode/v1Standard 按量付费Globalhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Token PlanGlobalhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1Token PlanChina这些常量在 models.ts 中有对应的导出QWEN_BASE_URL、QWEN_CN_BASE_URL、QWEN_STANDARD_CN_BASE_URL、QWEN_STANDARD_GLOBAL_BASE_URL、QWEN_TOKEN_PLAN_GLOBAL_BASE_URL、QWEN_TOKEN_PLAN_CN_BASE_URL。endpointClass: modelstudio-native的意义在于凡是命中这些原生主机的传输都会被授予“流式 usage 兼容”行为supportsNativeStreamingUsageCompat因此指向相同原生主机的 DashScope 兼容自定义 provider 也能继承该行为而不必使用内置qwenprovider id。认证选项与环境变量插件清单的setup字段清单 L429-L440声明了环境变量需求qwen计划接受QWEN_API_KEY、MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY三者互为兼容qwen-token-plan计划接受QWEN_TOKEN_PLAN_API_KEYproviderAuthChoices清单 L441-L536进一步定义了六个认证选项每个选项带choiceId、CLI 标志、optionKey与端点提示认证选项 choiceId计划 / 区域端点CLI 标志qwen-standard-api-key-cnStandard 按量付费 · Chinadashscope.aliyuncs.com--modelstudio-standard-api-key-cnqwen-standard-api-keyStandard 按量付费 · Global/Intldashscope-intl.aliyuncs.com--modelstudio-standard-api-keyqwen-api-key-cnCoding Plan 订阅 · Chinacoding.dashscope.aliyuncs.com--modelstudio-api-key-cnqwen-api-keyCoding Plan 订阅 · Global/Intlcoding-intl.dashscope.aliyuncs.com--modelstudio-api-keyqwen-token-planToken Plan · Global/Intltoken-plan.ap-southeast-1.maas.aliyuncs.com--qwen-token-plan-api-keyqwen-token-plan-cnToken Plan · Chinatoken-plan.cn-beijing.maas.aliyuncs.com--qwen-token-plan-api-key-cn注意qwen-*四个选项的deprecatedChoiceIds均指向旧的modelstudio-*id旧 id 仍按兼容别名工作但新的接入流程应使用规范的qwen-*id 与qwen/...模型引用。认证选项在 入口源码 中逐一落地为methodIdstandard-api-key-cn、standard-api-key、api-key-cn、api-key全部使用环境变量QWEN_API_KEY并通过applyConfig调用 onboard.ts 中的五个配置应用函数applyQwenConfig/applyQwenConfigCn写入 Coding Plan 的 Global / China 基地址applyQwenStandardConfig/applyQwenStandardConfigCn写入 Standard 的 Global / China 基地址applyQwenTokenPlanConfig(region)按区域解析 Token Plan 基地址见 resolveQwenTokenPlanBaseUrl。这些函数基于createModelCatalogPresetAppliers生成写入api: openai-completions传输、按认证选项确定的baseUrl、默认模型引用Coding/Standard 为qwen/qwen3.5-plusToken Plan 为qwen-token-plan/qwen3.7-plus并为每个目录模型生成qwen/model与modelstudio/model双别名。若用户配置了models.mode: replace则把完整目录模型行一并写入配置否则仅保留连接设置与别名不复制生成的目录行。Token Plan 认证选项在 createQwenTokenPlanAuthMethod 中按global/cn区域工厂化生成密钥提示为sk-sp-...前缀的专用密钥。相关文档特别强调Token Plan 的密钥、Coding Plan 的密钥与按量付费密钥互不通用且 Token Plan 仅适用于交互式 OpenClaw 会话用于定时任务、无人值守脚本或应用后端可能触发订阅暂停或密钥吊销。若 Gateway 以守护进程launchd/systemd方式运行需确保QWEN_API_KEY或QWEN_TOKEN_PLAN_API_KEY对该进程可见例如放在~/.openclaw/.env或通过env.shellEnv注入这一点在 Qwen 使用文档 的“Environment and daemon setup”一节中有明确说明。模型目录与按计划的目录抑制qwen provider 种子目录清单的modelCatalog.providers.qwen使用openai-completionsAPI声明了 13 个种子模型清单 L133-L273。运行时通过 models.ts 的QWEN_MODEL_CATALOG从清单构建默认模型引用为qwen/qwen3.5-plusQWEN_DEFAULT_MODEL_REF模型引用输入上下文窗口说明qwen/qwen3.5-plustext, image1,000,000默认模型非推理qwen/qwen3.6-flashtext, image1,000,000推理模型仅 Standard 端点qwen/qwen3.6-plustext, image1,000,000推理模型Coding Standardqwen/qwen3.7-maxtext1,000,000推理模型仅 Standard 端点qwen/qwen3.7-plustext, image1,000,000推理模型Coding Standardqwen/qwen3.8-maxtext, image1,000,000推理模型仅 Standard输出上限 131,072qwen/qwen3.8-flashtext, image1,000,000推理模型仅 Standard输出上限 131,072qwen/qwen3-max-2026-01-23text262,144Qwen Max 系qwen/qwen3-coder-nexttext262,144编码向qwen/qwen3-coder-plustext1,000,000编码向qwen/MiniMax-M2.5text1,000,000推理开启qwen/glm-5、qwen/glm-4.7text202,752输出上限 16,384qwen/kimi-k2.5text, image262,144Moonshot 模型经阿里云提供其中qwen3.8-max与qwen3.8-flash在清单中携带额外元数据maxTokens提升至 131,072并声明thinkingLevelMapminimal→low、high/max→xhigh与compat块codeMode: capable、supportsReasoningEffort: true、supportedReasoningEfforts: [low,medium,xhigh]、同样的reasoningEffortMap。Coding Plan 的目录抑制清单的modelCatalog.suppressions清单 L55-L132定义了 8 条按主机条件生效的抑制规则当baseUrl主机为coding.dashscope.aliyuncs.com或coding-intl.dashscope.aliyuncs.com时从目录中剔除qwen3.8-max、qwen3.8-flash、qwen3.6-flash、qwen3.7-max对qwen与modelstudio两个 provider 各写一条。抑制原因reason字段均说明这些模型不在 Qwen Coding Plan 端点支持范围应改用 Standard 按量付费或 Token Plan 端点。抑制逻辑在运行时有两处落点buildQwenModelCatalogForBaseUrlbuildQwenProvider构建 provider 时若 baseUrl 命中 isQwenCodingPlanBaseUrl解析 URL 主机并精确匹配两个 coding 主机则过滤掉 isQwenStandardOnlyModelId 标记的“仅 Standard”模型集合qwen3.6-flash、qwen3.7-max、qwen3.8-max、qwen3.8-flash入口的 normalizeConfig对已是 Coding Plan 基地址的 provider 配置再执行一次同样的模型过滤作为防御性收尾。Token Plan 目录与发现模式modelCatalog.providers[qwen-token-plan]使用新加坡区基地址与独立的精确字符串允许名单所有模型cost均为零Token Plan 为信用制计费按 token 标价不适用见 models.ts 注释模型引用输入上下文状态qwen-token-plan/qwen3.7-plustext, image1,000,000可见qwen-token-plan/qwen3.8-maxtext, image1,000,000可见131,072 输出qwen-token-plan/qwen3.8-flashtext, image1,000,000可见131,072 输出qwen-token-plan/qwen3.6-plustext, image1,000,000可见qwen-token-plan/qwen3-coder-nexttext262,144deprecated由qwen3.7-plus取代保留但隐藏qwen-token-plan/kimi-k2.5text, image262,144可见qwen-token-plan/glm-5text202,752可见qwen-token-plan/MiniMax-M2.5text196,608可见发现模式在清单discovery字段中声明为qwen采用runtime凭已配置密钥实时调用端点/models接口发现qwen-token-plan采用refreshable。modelsDev字段把两个 provider 分别映射到alibaba-coding-plan与alibaba-token-plan两个目录快照源。端点实时返回的模型即便不在种子目录中也可以出现buildOpenAICompatibleLiveProviderCatalog以discoveryMode: strict运行但“Standard 端点的模型列表不代表 Token Plan / Coding Plan 可用”这一边界仍然成立。Thinking 控制的数据线实现参考文档声明的 Surface 之外Qwen 插件在流层实现了一整套 thinking 载荷约束这是理解请求行为的关键。入口为 wrapQwenProviderStream底层实现在 stream.ts。通用规则enable_thinking 开关对openai-completions传输且reasoning: true或被强制 thinking的模型createQwenThinkingWrapper 在每次请求上把 OpenClaw 的 thinking 级别映射为 DashScope 的顶层enable_thinking布尔量关闭 thinking 发送enable_thinking: false其余任何级别发送enable_thinking: true。模型条目的compat.thinkingFormat: qwen-chat-template可切换到聊天模板载荷setQwenChatTemplateThinking用于自定义模型的替代传输格式。qwen3.8 家族reasoning_effort 映射patchQwen38Payload 对qwen3.8-max/qwen3.8-flash判断见 isQwen38ModelId级别minimal/low→reasoning_effort: lowmedium→mediumhigh/xhigh/max→xhigh若请求中已存在显式thinking_budget则删除reasoning_effort而保留调用方预算——Qwen 会拒绝同时携带两个字段的请求即显式 token 预算优先于映射出来的 effort入口处 resolveQwenThinkingProfile 为该家族暴露off / low / medium / xhigh四个档位默认xhigh。Token Plan 各模型家族的差异化契约resolveQwenThinkingContractstream.ts L82-L102按模型家族分派DeepSeek V4deepseek-v4*minimal–high映射为highxhigh/max映射为maxpatchTokenPlanDeepSeekV4PayloadKimithinking-only即使会话请求/think off也保持 thinking 开启GLMminimal–xhigh直接透传为reasoning_effortmax仅glm-5.2接受supportsQwenTokenPlanGlmMaxThinking其余版本降级为xhighpatchTokenPlanGlmPayload携带tools时追加tool_stream: truethinking-only 模型MiniMax-M2.5、kimi-k2.7-code*见 isQwenTokenPlanThinkingOnlyModelIdforceThinking置真禁止关闭tool_choice 归一化normalizeTokenPlanThinkingToolChoice 处理 Token Plan 端点下 thinking 与工具选择的组合——{type: auto|none}的对象形式被改写为字符串形式固定工具选择tool/function且非强制 thinking 时直接回退为enable_thinking: false而不是破坏固定选择。此外createQwenConstraintWrapper 会在调用方的onPayload钩子配置级extra_body等之后再次执行 enforceQwenPayloadAfterCaller确保无效字段reasoningEffort、reasoning等无法逃逸出插件边界。多模态契约媒体理解与视频生成Surface 一节声明的两个契约在注册时落地api.registerMediaUnderstandingProvider(buildQwenMediaUnderstandingProvider())与api.registerVideoGenerationProvider(qwenVideoGenerationProvider)。媒体理解buildQwenMediaUnderstandingProvider 声明capabilities: [image, video]图像与视频理解的默认模型均为qwen3.6-plus并设置autoPriority.video: 15与 清单 mediaUnderstandingProviderMetadata 一致。视频描述走 OpenAI 兼容传输默认基地址为Standard Global端点dashscope-intl.aliyuncs.com/compatible-mode/v1。媒体理解仅挂在 Standard DashScope 端点上Coding Plan 端点不支持且由已配置的 Qwen 认证自动解析密钥无需额外配置。视频生成Wan 系列qwenVideoGenerationProvider 基于buildDashscopeVideoGenerationProvider构建默认基地址为dashscope-intl.aliyuncs.com并实现了区域路由配置的 Qwen 区域Global/Intl 或 China会被映射到对应区域的 DashScope AIGC 主机后提交视频任务即使models.providers.qwen.baseUrl指向 Coding Plan 或 Standard 聊天主机视频生成仍路由到匹配区域的 DashScope 视频端点主机解析见 resolveDashscopeAigcApiBaseUrl。credentialPolicy明确了凭据边界acceptsApiKey拒绝以sk-sp-开头的密钥那是 Token Plan 专用前缀acceptsBaseUrl拒绝 Coding Plan 主机isQwenCodingPlanBaseUrl与token-plan.*.maas.aliyuncs.com主机不支持时的提示语Wan 视频生成要求 Standard DashScope 端点与同区域的 Standard 密钥Coding Plan 与 Token Plan 凭据均不支持。按 Qwen 使用文档 的 Wan 模型矩阵插件随附wan2.6-t2v默认文生视频15 s、wan2.6-i2v图生视频15 s、wan2.6-r2v/wan2.6-r2v-flash参考生视频10 s、wan2.7-r2v10 s音频恒开。可将 Qwen 设为默认视频提供方{ agents: { defaults: { mediaModels: { video: { primary: qwen/wan2.6-t2v } }, }, }, }参考图像/视频输入要求远程 http(s) URL本地文件路径会被提前拒绝因为 DashScope 视频端点不接受上传的本地缓冲作为参考素材。共享工具参数、provider 选择与故障转移行为见 视频生成文档。高级配置要点模型可用性边界qwen3.7-plus、qwen3.6-plus在 Coding Plan 与 Standard 均可用qwen3.8-max、qwen3.8-flash、qwen3.7-max、qwen3.6-flash仅限 Standard 或 Token Plan。若 Coding Plan 端点返回“不支持的模型”错误应切换到对应 Standard / Token Plan 端点及其专用密钥。baseUrl 覆盖认证选项自动选择端点也可在models.providers.qwen.baseUrl中自定义基地址入口的resolveConfiguredQwenBaseUrl会优先读取该配置见 index.ts L47-L65。models.mode: replace显式替换模式会保留目录播种并保留自定义模型行。流式 usage 兼容六个原生端点主机含 Token Plan 两个 maas 主机在共享openai-completions传输上启用流式 usage 兼容指向同一主机的自定义 provider id 自动继承。能力路线图文本/聊天模型、工具调用、结构化输出与 thinking 已可用继承自 OpenAI 兼容传输图像/视频理解在 Standard 端点可用视频生成已可用图像生成与语音/音频、内存嵌入与重排处于 provider 插件层规划中。认证历史qwen-oauthPortal 提供者及其 OAuth 流程已移除Portal 令牌与 Qwen Cloud / DashScope API 密钥不通用现有 Portal 凭据不会被自动转换必须用所选端点重新进行 API 密钥认证。相关文档Qwen 插件参考本文依据Qwen 使用指南模型选择与 provider视频生成工具Alibaba Model Studio 提供方Ollama 本地发现、LM Studio 本地发现故障排查插件源码索引入口、模型与端点常量、provider 构建、onboard 配置应用、流包装与 thinking 约束、视频生成 provider、媒体理解 provider、插件清单。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenClaw Qwen 插件参考：Qwen Cloud 多计划端点、模型目录与多模态契约全解析
OpenClaw Qwen 插件参考Qwen Cloud 多计划端点、模型目录与多模态契约全解析【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文以 OpenClaw 的 Qwen 插件参考文档为骨架完整解析openclaw/qwen-provider的分发方式、六个 provider 标识、端点与认证选项、按计费计划分层的模型目录、thinking 控制的数据线实现以及媒体理解与视频生成两项契约能力。读完后可独立完成 Qwen Cloud / DashScope 各计划的接入配置并理解插件在请求层做了哪些载荷约束。插件概述与分发Qwen 插件为 OpenClaw 增加Qwen、Qwen Cloud、Model Studio、DashScope、Qwen Token Plan、Bailian Token Plan模型提供者支持。它属于官方外部插件不随核心捆绑发行需要显式安装后重启 Gateway。参考文档给出的分发信息Distribution如下包名openclaw/qwen-provider安装路线npm 或 ClawHubclawhub:openclaw/qwen-provider结合 plugins 入口说明标准安装流程为openclaw plugins install openclaw/qwen-provider openclaw gateway restart从 package.json 可以确认该插件的版本约束与发布渠道当前版本2026.9.3同时发布到 npm 与 ClawHubpublishToNpm与publishToClawHub均为true默认安装渠道为 npm要求宿主版本minHostVersion: 2026.6.8插件 API 兼容版本pluginApi: 2026.9.3插件入口为./index.ts即 插件入口文件。Provider 面Surface参考文档的 Surface 一节声明了两类接口面Providersqwen、qwencloud、modelstudio、dashscope、qwen-token-plan、bailian-token-planContractsmediaUnderstandingProviders、videoGenerationProviders六个 provider id 与家族映射插件清单openclaw.plugin.json中providers数组列出了全部六个 idproviderRequest字段则把它们统一归入modelstudio请求家族provider id角色家族映射qwen规范canonicalidmodelstudioqwencloud兼容别名modelstudiomodelstudio历史兼容别名modelstudiodashscopeDashScope 端点别名modelstudioqwen-token-planToken Plan团队版规范 idmodelstudiobailian-token-plan百炼 Token Plan 兼容所有者 idmodelstudio从 入口源码 的defineSingleProviderPluginEntry定义看主 provider 的id为qwenaliases显式包含modelstudio与qwenclouddashscope作为请求家族别名同样被流包装器识别——stream.ts 的isQwenProviderId将qwen、qwen-token-plan、bailian-token-plan、modelstudio、qwencloud、dashscope六个规范化 id 都视为 Qwen 家族。qwen-token-plan与bailian-token-plan并非在主入口注册而是在register(api)回调中以独立 provider 形式注册前者带完整认证与目录后者仅作为“遗留自定义配置的所有者”注册无认证方法、仅挂载流包装器见 register 回调。这意味着如果你已经在models.providers中手写了bailian-token-plan自定义条目它的传输与目录归属不会被插件合并插件只是“占有”这个 id 以避免冲突。端点声明清单中的providerEndpoints清单 L15-L27 对应openclaw.plugin.json的providerEndpoints字段声明了端点类modelstudio-native并列出六个基地址端点计划https://coding-intl.dashscope.aliyuncs.com/v1Coding PlanGlobalhttps://coding.dashscope.aliyuncs.com/v1Coding PlanChinahttps://dashscope.aliyuncs.com/compatible-mode/v1Standard 按量付费Chinahttps://dashscope-intl.aliyuncs.com/compatible-mode/v1Standard 按量付费Globalhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Token PlanGlobalhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1Token PlanChina这些常量在 models.ts 中有对应的导出QWEN_BASE_URL、QWEN_CN_BASE_URL、QWEN_STANDARD_CN_BASE_URL、QWEN_STANDARD_GLOBAL_BASE_URL、QWEN_TOKEN_PLAN_GLOBAL_BASE_URL、QWEN_TOKEN_PLAN_CN_BASE_URL。endpointClass: modelstudio-native的意义在于凡是命中这些原生主机的传输都会被授予“流式 usage 兼容”行为supportsNativeStreamingUsageCompat因此指向相同原生主机的 DashScope 兼容自定义 provider 也能继承该行为而不必使用内置qwenprovider id。认证选项与环境变量插件清单的setup字段清单 L429-L440声明了环境变量需求qwen计划接受QWEN_API_KEY、MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY三者互为兼容qwen-token-plan计划接受QWEN_TOKEN_PLAN_API_KEYproviderAuthChoices清单 L441-L536进一步定义了六个认证选项每个选项带choiceId、CLI 标志、optionKey与端点提示认证选项 choiceId计划 / 区域端点CLI 标志qwen-standard-api-key-cnStandard 按量付费 · Chinadashscope.aliyuncs.com--modelstudio-standard-api-key-cnqwen-standard-api-keyStandard 按量付费 · Global/Intldashscope-intl.aliyuncs.com--modelstudio-standard-api-keyqwen-api-key-cnCoding Plan 订阅 · Chinacoding.dashscope.aliyuncs.com--modelstudio-api-key-cnqwen-api-keyCoding Plan 订阅 · Global/Intlcoding-intl.dashscope.aliyuncs.com--modelstudio-api-keyqwen-token-planToken Plan · Global/Intltoken-plan.ap-southeast-1.maas.aliyuncs.com--qwen-token-plan-api-keyqwen-token-plan-cnToken Plan · Chinatoken-plan.cn-beijing.maas.aliyuncs.com--qwen-token-plan-api-key-cn注意qwen-*四个选项的deprecatedChoiceIds均指向旧的modelstudio-*id旧 id 仍按兼容别名工作但新的接入流程应使用规范的qwen-*id 与qwen/...模型引用。认证选项在 入口源码 中逐一落地为methodIdstandard-api-key-cn、standard-api-key、api-key-cn、api-key全部使用环境变量QWEN_API_KEY并通过applyConfig调用 onboard.ts 中的五个配置应用函数applyQwenConfig/applyQwenConfigCn写入 Coding Plan 的 Global / China 基地址applyQwenStandardConfig/applyQwenStandardConfigCn写入 Standard 的 Global / China 基地址applyQwenTokenPlanConfig(region)按区域解析 Token Plan 基地址见 resolveQwenTokenPlanBaseUrl。这些函数基于createModelCatalogPresetAppliers生成写入api: openai-completions传输、按认证选项确定的baseUrl、默认模型引用Coding/Standard 为qwen/qwen3.5-plusToken Plan 为qwen-token-plan/qwen3.7-plus并为每个目录模型生成qwen/model与modelstudio/model双别名。若用户配置了models.mode: replace则把完整目录模型行一并写入配置否则仅保留连接设置与别名不复制生成的目录行。Token Plan 认证选项在 createQwenTokenPlanAuthMethod 中按global/cn区域工厂化生成密钥提示为sk-sp-...前缀的专用密钥。相关文档特别强调Token Plan 的密钥、Coding Plan 的密钥与按量付费密钥互不通用且 Token Plan 仅适用于交互式 OpenClaw 会话用于定时任务、无人值守脚本或应用后端可能触发订阅暂停或密钥吊销。若 Gateway 以守护进程launchd/systemd方式运行需确保QWEN_API_KEY或QWEN_TOKEN_PLAN_API_KEY对该进程可见例如放在~/.openclaw/.env或通过env.shellEnv注入这一点在 Qwen 使用文档 的“Environment and daemon setup”一节中有明确说明。模型目录与按计划的目录抑制qwen provider 种子目录清单的modelCatalog.providers.qwen使用openai-completionsAPI声明了 13 个种子模型清单 L133-L273。运行时通过 models.ts 的QWEN_MODEL_CATALOG从清单构建默认模型引用为qwen/qwen3.5-plusQWEN_DEFAULT_MODEL_REF模型引用输入上下文窗口说明qwen/qwen3.5-plustext, image1,000,000默认模型非推理qwen/qwen3.6-flashtext, image1,000,000推理模型仅 Standard 端点qwen/qwen3.6-plustext, image1,000,000推理模型Coding Standardqwen/qwen3.7-maxtext1,000,000推理模型仅 Standard 端点qwen/qwen3.7-plustext, image1,000,000推理模型Coding Standardqwen/qwen3.8-maxtext, image1,000,000推理模型仅 Standard输出上限 131,072qwen/qwen3.8-flashtext, image1,000,000推理模型仅 Standard输出上限 131,072qwen/qwen3-max-2026-01-23text262,144Qwen Max 系qwen/qwen3-coder-nexttext262,144编码向qwen/qwen3-coder-plustext1,000,000编码向qwen/MiniMax-M2.5text1,000,000推理开启qwen/glm-5、qwen/glm-4.7text202,752输出上限 16,384qwen/kimi-k2.5text, image262,144Moonshot 模型经阿里云提供其中qwen3.8-max与qwen3.8-flash在清单中携带额外元数据maxTokens提升至 131,072并声明thinkingLevelMapminimal→low、high/max→xhigh与compat块codeMode: capable、supportsReasoningEffort: true、supportedReasoningEfforts: [low,medium,xhigh]、同样的reasoningEffortMap。Coding Plan 的目录抑制清单的modelCatalog.suppressions清单 L55-L132定义了 8 条按主机条件生效的抑制规则当baseUrl主机为coding.dashscope.aliyuncs.com或coding-intl.dashscope.aliyuncs.com时从目录中剔除qwen3.8-max、qwen3.8-flash、qwen3.6-flash、qwen3.7-max对qwen与modelstudio两个 provider 各写一条。抑制原因reason字段均说明这些模型不在 Qwen Coding Plan 端点支持范围应改用 Standard 按量付费或 Token Plan 端点。抑制逻辑在运行时有两处落点buildQwenModelCatalogForBaseUrlbuildQwenProvider构建 provider 时若 baseUrl 命中 isQwenCodingPlanBaseUrl解析 URL 主机并精确匹配两个 coding 主机则过滤掉 isQwenStandardOnlyModelId 标记的“仅 Standard”模型集合qwen3.6-flash、qwen3.7-max、qwen3.8-max、qwen3.8-flash入口的 normalizeConfig对已是 Coding Plan 基地址的 provider 配置再执行一次同样的模型过滤作为防御性收尾。Token Plan 目录与发现模式modelCatalog.providers[qwen-token-plan]使用新加坡区基地址与独立的精确字符串允许名单所有模型cost均为零Token Plan 为信用制计费按 token 标价不适用见 models.ts 注释模型引用输入上下文状态qwen-token-plan/qwen3.7-plustext, image1,000,000可见qwen-token-plan/qwen3.8-maxtext, image1,000,000可见131,072 输出qwen-token-plan/qwen3.8-flashtext, image1,000,000可见131,072 输出qwen-token-plan/qwen3.6-plustext, image1,000,000可见qwen-token-plan/qwen3-coder-nexttext262,144deprecated由qwen3.7-plus取代保留但隐藏qwen-token-plan/kimi-k2.5text, image262,144可见qwen-token-plan/glm-5text202,752可见qwen-token-plan/MiniMax-M2.5text196,608可见发现模式在清单discovery字段中声明为qwen采用runtime凭已配置密钥实时调用端点/models接口发现qwen-token-plan采用refreshable。modelsDev字段把两个 provider 分别映射到alibaba-coding-plan与alibaba-token-plan两个目录快照源。端点实时返回的模型即便不在种子目录中也可以出现buildOpenAICompatibleLiveProviderCatalog以discoveryMode: strict运行但“Standard 端点的模型列表不代表 Token Plan / Coding Plan 可用”这一边界仍然成立。Thinking 控制的数据线实现参考文档声明的 Surface 之外Qwen 插件在流层实现了一整套 thinking 载荷约束这是理解请求行为的关键。入口为 wrapQwenProviderStream底层实现在 stream.ts。通用规则enable_thinking 开关对openai-completions传输且reasoning: true或被强制 thinking的模型createQwenThinkingWrapper 在每次请求上把 OpenClaw 的 thinking 级别映射为 DashScope 的顶层enable_thinking布尔量关闭 thinking 发送enable_thinking: false其余任何级别发送enable_thinking: true。模型条目的compat.thinkingFormat: qwen-chat-template可切换到聊天模板载荷setQwenChatTemplateThinking用于自定义模型的替代传输格式。qwen3.8 家族reasoning_effort 映射patchQwen38Payload 对qwen3.8-max/qwen3.8-flash判断见 isQwen38ModelId级别minimal/low→reasoning_effort: lowmedium→mediumhigh/xhigh/max→xhigh若请求中已存在显式thinking_budget则删除reasoning_effort而保留调用方预算——Qwen 会拒绝同时携带两个字段的请求即显式 token 预算优先于映射出来的 effort入口处 resolveQwenThinkingProfile 为该家族暴露off / low / medium / xhigh四个档位默认xhigh。Token Plan 各模型家族的差异化契约resolveQwenThinkingContractstream.ts L82-L102按模型家族分派DeepSeek V4deepseek-v4*minimal–high映射为highxhigh/max映射为maxpatchTokenPlanDeepSeekV4PayloadKimithinking-only即使会话请求/think off也保持 thinking 开启GLMminimal–xhigh直接透传为reasoning_effortmax仅glm-5.2接受supportsQwenTokenPlanGlmMaxThinking其余版本降级为xhighpatchTokenPlanGlmPayload携带tools时追加tool_stream: truethinking-only 模型MiniMax-M2.5、kimi-k2.7-code*见 isQwenTokenPlanThinkingOnlyModelIdforceThinking置真禁止关闭tool_choice 归一化normalizeTokenPlanThinkingToolChoice 处理 Token Plan 端点下 thinking 与工具选择的组合——{type: auto|none}的对象形式被改写为字符串形式固定工具选择tool/function且非强制 thinking 时直接回退为enable_thinking: false而不是破坏固定选择。此外createQwenConstraintWrapper 会在调用方的onPayload钩子配置级extra_body等之后再次执行 enforceQwenPayloadAfterCaller确保无效字段reasoningEffort、reasoning等无法逃逸出插件边界。多模态契约媒体理解与视频生成Surface 一节声明的两个契约在注册时落地api.registerMediaUnderstandingProvider(buildQwenMediaUnderstandingProvider())与api.registerVideoGenerationProvider(qwenVideoGenerationProvider)。媒体理解buildQwenMediaUnderstandingProvider 声明capabilities: [image, video]图像与视频理解的默认模型均为qwen3.6-plus并设置autoPriority.video: 15与 清单 mediaUnderstandingProviderMetadata 一致。视频描述走 OpenAI 兼容传输默认基地址为Standard Global端点dashscope-intl.aliyuncs.com/compatible-mode/v1。媒体理解仅挂在 Standard DashScope 端点上Coding Plan 端点不支持且由已配置的 Qwen 认证自动解析密钥无需额外配置。视频生成Wan 系列qwenVideoGenerationProvider 基于buildDashscopeVideoGenerationProvider构建默认基地址为dashscope-intl.aliyuncs.com并实现了区域路由配置的 Qwen 区域Global/Intl 或 China会被映射到对应区域的 DashScope AIGC 主机后提交视频任务即使models.providers.qwen.baseUrl指向 Coding Plan 或 Standard 聊天主机视频生成仍路由到匹配区域的 DashScope 视频端点主机解析见 resolveDashscopeAigcApiBaseUrl。credentialPolicy明确了凭据边界acceptsApiKey拒绝以sk-sp-开头的密钥那是 Token Plan 专用前缀acceptsBaseUrl拒绝 Coding Plan 主机isQwenCodingPlanBaseUrl与token-plan.*.maas.aliyuncs.com主机不支持时的提示语Wan 视频生成要求 Standard DashScope 端点与同区域的 Standard 密钥Coding Plan 与 Token Plan 凭据均不支持。按 Qwen 使用文档 的 Wan 模型矩阵插件随附wan2.6-t2v默认文生视频15 s、wan2.6-i2v图生视频15 s、wan2.6-r2v/wan2.6-r2v-flash参考生视频10 s、wan2.7-r2v10 s音频恒开。可将 Qwen 设为默认视频提供方{ agents: { defaults: { mediaModels: { video: { primary: qwen/wan2.6-t2v } }, }, }, }参考图像/视频输入要求远程 http(s) URL本地文件路径会被提前拒绝因为 DashScope 视频端点不接受上传的本地缓冲作为参考素材。共享工具参数、provider 选择与故障转移行为见 视频生成文档。高级配置要点模型可用性边界qwen3.7-plus、qwen3.6-plus在 Coding Plan 与 Standard 均可用qwen3.8-max、qwen3.8-flash、qwen3.7-max、qwen3.6-flash仅限 Standard 或 Token Plan。若 Coding Plan 端点返回“不支持的模型”错误应切换到对应 Standard / Token Plan 端点及其专用密钥。baseUrl 覆盖认证选项自动选择端点也可在models.providers.qwen.baseUrl中自定义基地址入口的resolveConfiguredQwenBaseUrl会优先读取该配置见 index.ts L47-L65。models.mode: replace显式替换模式会保留目录播种并保留自定义模型行。流式 usage 兼容六个原生端点主机含 Token Plan 两个 maas 主机在共享openai-completions传输上启用流式 usage 兼容指向同一主机的自定义 provider id 自动继承。能力路线图文本/聊天模型、工具调用、结构化输出与 thinking 已可用继承自 OpenAI 兼容传输图像/视频理解在 Standard 端点可用视频生成已可用图像生成与语音/音频、内存嵌入与重排处于 provider 插件层规划中。认证历史qwen-oauthPortal 提供者及其 OAuth 流程已移除Portal 令牌与 Qwen Cloud / DashScope API 密钥不通用现有 Portal 凭据不会被自动转换必须用所选端点重新进行 API 密钥认证。相关文档Qwen 插件参考本文依据Qwen 使用指南模型选择与 provider视频生成工具Alibaba Model Studio 提供方Ollama 本地发现、LM Studio 本地发现故障排查插件源码索引入口、模型与端点常量、provider 构建、onboard 配置应用、流包装与 thinking 约束、视频生成 provider、媒体理解 provider、插件清单。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考