[TOOLS] 5 min readOraCore Editors

OpenClaw配置百炼Qwen3.7-Max接入模板

我把 OpenClaw 接阿里云百炼 Qwen3.7-Max 的配置拆成了可直接复制的 JSON。

Share LinkedIn
OpenClaw配置百炼Qwen3.7-Max接入模板

我把 OpenClaw 接阿里云百炼 Qwen3.7-Max 的配置拆成了可直接复制的 JSON。

我最近在给本地 AI 工具接模型的时候,最烦的不是“能不能跑”,而是“为什么这玩意儿老是绕远路”。接口地址、模型名、鉴权方式、默认模型,明明就几项配置,偏偏每个项目都爱自己发明一套写法。你一边想把工具链接上阿里云百炼,一边还得翻配置文件、对兼容模式、查 Token Plan 的 endpoint,最后常常不是报 401,就是模型名写错,或者默认模型根本没切过去。

这次我看到的这段配置,反而很干脆。它不是长篇介绍,也不是空话堆砌,就是一段能直接塞进 ~/.openclaw/openclaw.json 的 provider 配置。说白了,这才是开发者真正需要的东西:别讲概念,先让我把 OpenClaw 跟阿里云百炼连起来,再谈别的。

原始来源是知乎专栏文章《2026年阿里云618:阿里云百炼大模型Qwen3.7-Max功能、订阅计费、配置接入详解》,我这里主要拆的是其中那段 OpenClaw 配置示例。原文给出的关键点很直接:编辑 ~/.openclaw/openclaw.json,增加百炼 Token Plan 的 provider,使用兼容模式接口和 qwen3.7-max 作为默认模型。来源链接我放在文末,也会顺手把相关官方入口一起标出来。

先别折腾流程,先把配置写对

Get the latest AI news in your inbox

Weekly picks of model releases, tools, and deep dives — no spam, unsubscribe anytime.

No spam. Unsubscribe at any time.

编辑配置文件 ~/.openclaw/openclaw.json,添加百炼 Token Plan 配置。

这句话看着像一句废话,但我真踩过太多坑了。很多人接新模型时第一反应是去看文档、找 SDK、看示例代码,结果忽略了最基础的配置层。到最后不是代码错,是配置没生效。OpenClaw 这种工具,本质上就是读一个本地 JSON,然后把 provider 映射到模型调用入口。你把入口、Key、默认模型写对了,后面才有资格谈别的。

OpenClaw配置百炼Qwen3.7-Max接入模板

我自己的经验是,配置文件越短,越容易出错。不是因为内容多,而是因为你会下意识觉得“这么简单应该没问题”,于是把路径、字段名、URL 少写一个字符。尤其是这种本地配置,出错时往往没有很友好的提示,只会表现为模型不可用、请求失败、或者工具直接回退到别的 provider。

怎么用:先确认 OpenClaw 真的是读 ~/.openclaw/openclaw.json,不是别的路径。然后只做一件事,先把百炼 provider 加进去,别急着同时改一堆模型配置。最小化变更,最容易定位问题。

  • 先备份原文件
  • 只新增一个 provider
  • 确认默认模型名和接口地址完全一致

如果你已经有多个 provider,先别乱删。先把百炼这一项加进去,跑通后再决定要不要把它设成默认。

Token Plan 不是“换个 Key”这么简单

{ "name": "bailian-token-plan", "api_key": "你的Token Plan API Key", "base_url": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1", "default_model": "qwen3.7-max" }

这里最值得注意的不是 api_key,而是 base_url。很多人看到“兼容模式”四个字,就默认它跟 OpenAI 风格 API 一样随便填个地址就行。不是。你得把它当成一个明确的服务入口,而不是“某个能通的 URL”。这个地址决定了请求到底走到哪条链路上,也决定了你的工具要不要额外做适配。

我以前接类似服务时,最常见的误区就是只换 Key,不换 base URL。结果 Key 是对的,请求还是打到旧环境,日志看起来像“认证失败”,其实根本是打错地方了。还有一种更烦:你以为模型名随便写个别名就行,最后服务端并不认。这里原文直接给了 qwen3.7-max,这就省掉了很多猜测成本。

怎么用:把 provider 当成一组强绑定字段来理解,Key、URL、默认模型必须一起看。只要其中一个不匹配,整个调用链就会歪掉。我的建议是先从原文给出的值原样复制,再在确认可用后做你自己的抽象。

  • name 是你本地识别这个 provider 的标签
  • api_key 是百炼 Token Plan 的访问凭证
  • base_url 必须指向兼容模式入口
  • default_model 决定默认调用哪个模型

如果你要接别的工具,也可以先对照这个结构看它是不是支持类似的 provider 抽象。很多本地 AI 工具都差不多,只是字段名字略有差异。

默认模型别乱猜,直接写死最省事

原文里把 default_model 设成了 qwen3.7-max,这其实是个很实用的选择。因为在本地工具里,默认模型不是“装饰字段”,它会直接影响你第一次打开工具时调用哪一个后端。你要是留空,或者写个模糊别名,最后就会出现“我明明配置了,怎么还是没走新模型”的错觉。

OpenClaw配置百炼Qwen3.7-Max接入模板

我遇到过最烦的情况,就是一个工具支持多个 provider,结果默认模型还停在旧的便宜模型上。表面上配置成功了,实际上根本没切过去。你以为自己在测新模型,实际上一直在跟老模型对话。那种浪费时间的感觉,真的很糟。

怎么用:先把默认模型写成你最确定要用的那个版本。不要先追求“灵活”,先追求“可验证”。等你确认请求确实打到了百炼,再考虑把模型名做成环境变量或者 profile 切换。

如果你在团队里共享这套配置,我会建议你把默认模型写得更保守一点,避免别人打开工具就误调用高成本模型。先明确谁是默认入口,再谈个性化。

兼容模式是为了少改代码,不是让你偷懒

OpenClaw 这类工具之所以好接,是因为它们通常支持兼容模式 provider。原文给出的 compatible-mode/v1 路径,就是典型的“尽量少改调用侧”的做法。你不需要重写整套模型调用逻辑,只要把请求发到兼容入口,工具就能按既有结构工作。

但我得泼点冷水:兼容模式不等于完全兼容。它只是把最常见的请求形状对齐了,具体到流式输出、工具调用、消息格式、错误码,还是可能有差异。所以别一看“compatible”就开始偷懒,觉得以后都不用测了。真要上线到工作流里,还是得跑几轮实际对话。

怎么用:把兼容模式当成迁移桥梁,而不是最终状态。先让现有工具链跑起来,再根据真实使用场景去补边界。比如你要看长上下文、函数调用、流式响应,就分别做一次验证,不要只测“能返回一句话”。

我自己的习惯是,接入这种服务后先做三件事:

  • 发一条最短消息,确认鉴权和路由
  • 发一条长一点的消息,确认上下文传递
  • 如果工具支持流式,再测一次流式输出

这三步足够把大多数“看起来接上了,其实没接稳”的问题揪出来。

本地 JSON 配置,别写得像临时笔记

这段原始配置最有价值的地方,不是它接了哪个模型,而是它的结构很适合直接复制。很多人写本地配置时喜欢加注释、加临时备注、加一堆自己看得懂别人看不懂的字段,结果过两天自己也不认了。JSON 这种东西,本来就不适合写脑内备忘录。

我建议你把 ~/.openclaw/openclaw.json 当成正式配置文件对待。字段层级要稳定,provider 命名要统一,路径不要乱改。尤其是这种用户目录下的隐藏文件,一旦工具升级或者你切换机器,最容易因为路径约定不一致而出问题。

怎么用:如果你目前已经有别的 provider,就用同样的格式新增一项,不要为了“看起来更整洁”去改整个结构。保持一致性,比所谓优雅重要得多。开发工具的配置,最怕的就是每个人都觉得自己那种写法更聪明。

我会建议你把配置文件和一份可复制模板一起保存,最好再放一个最小可运行版本。这样你以后换机器,只需要改 Key,不需要重新理解整个结构。

把接入步骤压缩成一次性动作

如果我要把这篇原文压缩成一句开发者能执行的话,那就是:把百炼 Token Plan 当成一个标准 provider,按兼容模式接进 OpenClaw,然后把 qwen3.7-max 设成默认模型。别把它想复杂了。你不是在重建一套模型平台,你只是想让本地工具能稳定发请求。

这也是我一直偏好的接入方式。先把“路径”打通,再把“体验”做细。很多人反过来,先想 UI、再想切换、再想缓存、再想多模型路由,最后连最基本的请求都没发出去。顺序错了,后面全是返工。

怎么用:把这次配置当成一个标准化动作,以后接类似服务时都复用同一套路。你甚至可以把 provider 模板抽出来,遇到新服务只替换 Key、URL 和模型名。

如果你已经在用其他兼容服务,比如 OpenAI 兼容接口、其他云厂商的推理入口,建议你也统一成同一套本地配置风格。这样切换成本会低很多,排错也更直接。

你可以直接复制的模板

{
  "models": {
    "providers": [
      {
        "name": "bailian-token-plan",
        "api_key": "你的Token Plan API Key",
        "base_url": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "default_model": "qwen3.7-max"
      }
    ]
  }
}

如果你已经有现成的 ~/.openclaw/openclaw.json,那就不要整份替换,直接把这个 provider 合并进去。最稳的方式是保留你原来的 providers 数组结构,只新增这一项。要是你是从零开始配置,那就直接用上面的内容做起点。

我再说一次,真正要复制的不是“百炼”这两个字,而是这个结构:nameapi_keybase_urldefault_model。这四个字段就是你以后接类似模型服务时最常见的骨架。别把它写散了,写散了以后你自己都不好维护。

如果你想把这段配置放进团队文档,我建议你顺手加一句说明:这个 provider 使用阿里云百炼 Token Plan 兼容模式,默认模型为 qwen3.7-max,配置文件路径为 ~/.openclaw/openclaw.json。这样别人看一眼就知道该改哪里。

原始内容来自知乎专栏文章 《2026年阿里云618:阿里云百炼大模型Qwen3.7-Max功能、订阅计费、配置接入详解》。我这里做的是开发者视角的拆解和模板化整理,不是原文逐字复述。