OpenClaw 接入阿里云百炼模型教程：开箱即用，国内网络最友好

对于大多数国内 OpenClaw 用户来说，阿里云百炼（Model Studio）是配置门槛最低的选择之一——支付宝直接充值、API 端点国内直连、新人 90 天免费额度、通义千问中文表现一流，还有 Coding Plan 包月套餐可以控制成本。

阿里云官方也把百炼作为 OpenClaw 的首推国内接入方案，出了专门的对接文档，并且提供了”轻量应用服务器 + OpenClaw 预装镜像”的一键部署方式。

本文是完整的配置教程，覆盖三种接入模式，附可直接使用的 JSON 配置。更多资源请访问 OpenClaw 中文版官网。

一、百炼接入的三种模式，先搞清楚用哪个

接入百炼之前，先弄清楚你打算用哪种方式——三种模式的 API Key 格式、Base URL、支持的模型都不同，混用会报错：

模式	计费方式	API Key 格式	适合场景
按量付费（标准）	按 Token 用量计费	`sk-xxxxxxxxxxxx`	轻度用户、测试阶段、不确定用量
Coding Plan（包月）	月费固定，每月最多 90,000 次请求	`sk-sp-xxxxxxxxxxxx`（以 `sk-sp-` 开头）	重度用户、每天高频使用
新人免费额度	开通后 90 天内免费（消耗完后转按量）	同按量付费，`sk-` 开头	新用户试用阶段

重要区别：按量付费的标准 Key（sk- 开头）和 Coding Plan 专属 Key（sk-sp- 开头）完全不通用，Base URL 也不同。填错 Key 会收到 401 报错，填对 Key 但用了错误的 Base URL 同样会失败。

二、第一步：开通百炼并获取 API Key

国内用户（bailian.aliyun.com）

访问 bailian.aliyun.com，使用阿里云账号（支付宝扫码登录）
首次进入会提示开通服务，按步骤完成开通
开通后自动获得新人免费额度（90 天有效）——无需充值即可开始使用
进入控制台 → API Key 管理 → 点击「创建 API Key」
选择工作空间（默认工作空间可调用所有模型），立即复制 Key（只显示一次）

如需充值（免费额度用完之后）

在阿里云控制台 → 费用中心，支持支付宝、微信支付、银行卡
建议开通”消费限额”功能，防止意外超额扣费：控制台 → 费用 → 消费控制 → 设置月度上限

Coding Plan 订阅（高频用户）

如果你每天都要用 OpenClaw，按量付费成本可能不低。Coding Plan 提供月费固定、每月 90,000 次请求的套餐，适合重度用户：

在百炼控制台找到「Coding Plan」入口或访问对应页面
选择套餐（有 Lite 和 Pro 两档）并订阅
订阅成功后，在 Coding Plan 页面单独生成专属 API Key（格式 sk-sp- 开头）
这个 Key 和普通 Key 分开存放，配置时使用不同的 Base URL

三、地区端点选哪个？

百炼有北京（国内）和新加坡（国际）两个地区端点，API Key 与地区绑定，不能跨区使用：

地区	Base URL（按量付费）	特别说明
北京（国内）	`https://dashscope.aliyuncs.com/compatible-mode/v1`	国内访问延迟最低；支持第三方文本生成模型（如 GLM-5、MiniMax）
新加坡（国际）	`https://dashscope-intl.aliyuncs.com/compatible-mode/v1`	香港/海外用户首选；不支持部分第三方模型
Coding Plan（国内）	`https://coding.dashscope.aliyuncs.com/v1`	Coding Plan 专属 URL
Coding Plan（国际）	`https://coding-intl.dashscope.aliyuncs.com/v1`	Coding Plan 国际版专属 URL

中国大陆用户：按量付费选北京，Coding Plan 选 coding.dashscope.aliyuncs.com。

四、完整配置示例

模式一：按量付费（北京地区）

在 ~/.openclaw/.env 里添加：

DASHSCOPE_API_KEY=sk-你的百炼APIKey

编辑 ~/.openclaw/openclaw.json：

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的百炼APIKey"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen3.5 Plus（通用首选）",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "Qwen3 Max（深度推理）",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-coder-next",
            "name": "Qwen3 Coder Next（代码专用）",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536
          },
          {
            "id": "qwen-turbo",
            "name": "Qwen Turbo（高速轻量）",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus",
        "fallbacks": [
          "bailian/qwen-turbo"
        ]
      },
      "models": {
        "bailian/qwen3.5-plus": { "alias": "qwen" },
        "bailian/qwen3-max-2026-01-23": { "alias": "qwen-max" },
        "bailian/qwen3-coder-next": { "alias": "qwen-coder" },
        "bailian/qwen-turbo": { "alias": "qwen-turbo" }
      }
    }
  }
}

模式二：Coding Plan（包月套餐，国内）

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-sp-你的CodingPlan专属Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-2026-01-23",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "bailian/qwen3.5-plus" },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-max-2026-01-23": {},
        "bailian/qwen3-coder-next": {}
      }
    }
  }
}

Coding Plan 按次计费，cost 字段填 0 即可，便于 OpenClaw 的用量统计正确显示。

重启并验证

openclaw daemon restart

# 验证模型已加载
openclaw models list | grep bailian

# 发送测试消息
/status
# 确认 model 字段显示 bailian/qwen3.5-plus

五、三个必须注意的细节

细节一：reasoning 必须设为 false

这是最容易踩的坑，官方文档专门标红说明：配置 Qwen 模型时 reasoning 参数必须为 false，设为 true 或省略会导致 AI 回复内容为空。

细节二：模型引用必须带服务商前缀

如果配置文件里服务商叫 bailian，那么模型引用必须写成 bailian/qwen3.5-plus，而不是单独的 qwen3.5-plus，否则 OpenClaw 找不到这个模型。

细节三：Base URL、API Key、模型必须属于同一地区

用北京地区注册的 API Key，必须配北京地区的 Base URL，不能用新加坡 URL；反之亦然。如果跨区使用，会收到认证失败或模型不存在的报错。

六、模型选型速查

模型	上下文	价格（国内按量）	推荐场景
qwen3.5-plus	100 万 Token	$0.40/M 输入	日常首选，通用对话，支持图文输入
qwen3-max-2026-01-23	26.2 万 Token	$1.20/M 输入	复杂推理，重要分析任务
qwen3-coder-next	26.2 万 Token	—	代码生成与调试专用
qwen-turbo	100 万 Token	$0.05/M 输入	Cron 心跳任务，轻量高频场景

七、阿里云轻量服务器一键部署（最省事的方式）

如果你不想在自己的电脑上跑 OpenClaw，阿里云提供了轻量应用服务器 + OpenClaw 预装镜像的一键部署方案：

访问阿里云 OpenClaw 一键部署专题页面
选购轻量应用服务器，镜像选”OpenClaw（Moltbot）”
服务器创建完成后，在实例详情页的”应用详情”里直接配置百炼 API Key（图形化界面，不用改配置文件）
系统会自动列出你的百炼 Coding Plan API Key 供直接选择
点击”访问 Web UI”即可打开 OpenClaw 控制面板

这种方式适合不熟悉命令行、希望 24 小时在线运行的用户。从购买服务器到配置完成通常不超过 15 分钟。

地域建议：阿里云轻量应用服务器选海外地域（如香港、新加坡）的 OpenClaw，联网搜索功能不受限，并内置了 SearXNG 搜索技能。国内地域的服务器联网搜索有限制，需额外配置。

八、常见报错排查

报错：401 Unauthorized

API Key 无效、填错或账户欠费。检查：

Key 是否复制完整（有时候末尾空格被漏掉）
按量付费 Key（sk-）有没有误用到 Coding Plan 的 URL
账户是否有欠费，登录百炼控制台查看余额

报错：AI 回复内容为空

几乎必然是 reasoning: true 的问题。检查配置文件中所有 Qwen 模型的 reasoning 字段，全部改为 false。

报错：Unknown model: qwen3.5-plus

模型引用缺少服务商前缀。把 agents.defaults.model.primary 改为 "bailian/qwen3.5-plus"（包含服务商名）。

报错：qwen3-max-2026-01-23 不存在或无权限

可能是非默认工作空间的 API Key 没有开启该模型的调用权限。登录百炼控制台 → API Key 管理 → 查看 Key 所属工作空间 → 进入工作空间设置 → 手动开启对应模型的调用权限。

报错：Coding Plan 额度超限

Coding Plan 每月最多 90,000 次请求，超限后不会转为按量付费，而是直接返回错误。在 Coding Plan 页面查看用量，等额度重置或升级套餐。

报错：模型列表查询失败（不影响使用）

OpenClaw 启动时有时会尝试查询百炼的模型列表，但百炼 Coding Plan 不支持接口查询模型列表，会出现一条警告。这条警告不影响正常使用，可以忽略。如果想消除这条提示，删除 ~/.openclaw/agents/main/agent/auth-profiles.json 里的 alibaba-cloud:default profile，然后重启。

总结

阿里云百炼对国内 OpenClaw 用户最大的优势是：

零代理需求：API 端点国内直连，延迟低，连接稳定
人民币充值：支付宝/微信直接付，不用操心汇率和境外信用卡
新人免费额度：开通后 90 天可以免费试用，不用马上掏钱
千问中文表现好：阿里云专门优化了中文场景，对话和长文处理都很稳
Coding Plan 成本可控：月费固定，重度用户不用担心按量计费超额

三条关键配置规则记住：reasoning: false、模型前缀带 bailian/、Base URL 和 Key 同地区。按这三条配置，基本不会踩坑。

想了解更多 OpenClaw 国内模型接入教程，欢迎访问 OpenClaw 中文版官网。