【OpenClaw】更换阿里百炼完整配置指南

本文将带你完成 OpenClaw 从配置阿里百炼提供商到切换为 bailian/qwen-plus 模型的全流程操作。

---

一、前置准备：获取阿里百炼 API Key

1. 登录 阿里云百炼控制台，进入「API Key 管理」页面。
2. 生成新的 API Key（以 sk- 开头的字符串），请妥善保存，该密钥仅显示一次。
3. 确认你的账号已开通 qwen-plus 模型的使用权限。

---

二、配置阿里百炼模型提供商

1. 打开 OpenClaw 网关仪表盘，完成令牌认证并连接成功。
2. 进入顶部导航栏的「AI 与代理」→「Models」标签页。
3. 在「Model Providers」区域，点击「+ Add entry」，添加新的提供商配置：
   • 提供商 ID ：bailian
   • Model Provider API Adapter ：选择 openai-completions（百炼兼容 OpenAI 协议）
   • Model Provider Auth Mode ：选择 api-key
   • Model Provider API Key：粘贴你的阿里百炼 API Key
   • Model Provider Base URL ：填写 https://dashscope.aliyuncs.com/compatible-mode/v1
4. 在「Model Provider Model List」区域，点击「+ Add」添加 qwen-plus 模型：
   • Id ：qwen-plus
   • Context Window ：设置为 131072（匹配模型最大上下文）
5. 点击右上角「Save」保存配置，再点击「Apply」使配置生效。

---

三、设置 bailian/qwen-plus 为默认模型

1. 切换到「AI 与代理」→「Agents」标签页。

2. 在「Model」配置区域，输入以下 JSON 配置：

   {
     "primary": "bailian/qwen-plus"
   }

3. 点击右上角「Save」保存修改，再点击「Apply」让配置生效。

---

四、验证配置生效

1. 回到 OpenClaw 主界面，在「Quick Settings」的模型下拉列表中，能看到 bailian/qwen-plus 选项。
2. 查看 OpenClaw 终端日志，应显示类似：[gateway] agent model: bailian/qwen-plus (thinking=off, fast=off)。
3. 发起一次对话请求，模型正常响应即表示配置成功。

---

五、可选优化配置

• 调整上下文窗口 ：在 qwen-plus 模型配置中，可根据实际需求修改 Context Window 参数，最大支持 131072。

• 添加备用模型 ：在 Agents 的 Model 配置中，可添加 fallback 字段设置备用模型，例如：

  

{
  "primary": "bailian/qwen-plus",
  "fallback": "bailian/qwen-turbo"
}

---

---

---