OpenClaw 可通过阿里云百炼的 OpenAI 兼容接口接入通义千问（Qwen）大模型。以下是基于最新版 OpenClaw 的推荐配置方法。

📝 1. 准备工作

1. 安装 OpenClaw

   • 脚本安装 (macOS/Linux)

     bash

     curl -fsSL https://openclaw.ai/install.sh| bash

   • npm 安装 (跨平台)

     bash

     npm install -g openclaw@latest

   • Windows (PowerShell)

     powershell

     iwr -useb https://openclaw.ai/install.ps1| iex

   安装后，可通过 openclaw --version检查是否成功。

2. 获取百炼 API Key

   • 登录阿里云百炼控制台，进入「密钥管理」页面。

   • 创建或复制一个 API Key（通常以 sk-开头）并妥善保存。

⚙️ 2. 配置模型连接

推荐使用交互式向导进行配置，这是最简单的方式。

1. 启动配置向导

   在终端执行以下命令：

   bash

   openclaw config model --wizard

2. 按提示输入信息

   • 模型提供商：选择阿里云百炼（通常显示为 bailian或 qwen）。

   • API Key：粘贴你从百炼获取的 Key。

   • 地域：根据你的服务器或网络情况选择，例如：

     • 华北 2 (北京): https://dashscope.aliyuncs.com/compatible-mode/v1

     • 新加坡: https://dashscope-intl.aliyuncs.com/compatible-mode/v1

     • 美国 (弗吉尼亚): https://dashscope-us.aliyuncs.com/compatible-mode/v1

   • 默认模型：选择一个 Qwen 模型，如 qwen3.5-plus、qwen3-max或 qwen-turbo。

   • 确认保存：输入 Y完成配置。

3. 重启并验证

   • 重启服务：

     bash

     系统服务方式

     sudo systemctl restart openclaw

     或本地进程方式

     openclaw gateway restart

   • 测试连接：

     bash

     openclaw model test

     如果输出 “连接成功” 或类似字样，则表示配置正确。

💻 3. 手动编辑配置文件 (可选)

如果你熟悉 JSON 格式，也可以直接编辑配置文件。

1. 打开配置文件

   • Linux/macOS: ~/.openclaw/openclaw.json

   • Windows: %USERPROFILE%\.openclaw\openclaw.json

2. 修改配置内容

   将 models和 agents.defaults部分修改为以下内容（以北京地域的 qwen3.5-plus为例）：

   json

   {

   "models": {

   "mode": "merge",

   "providers": {

   "bailian": {

   "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",

   "apiKey": "你的API Key",

   "api": "openai-completions",

   "models": [

   {

   "id": "qwen3.5-plus",

   "name": "qwen3.5-plus",

   "reasoning": false,

   "input": ["text", "image"],

   "contextWindow": 1000000,

   "maxTokens": 65536

   }

   ]

   }

   }

   },

   "agents": {

   "defaults": {

   "model": {

   "primary": "bailian/qwen3.5-plus"

   },

   "models": {

   "bailian/qwen3.5-plus": {}

   }

   }

   }

   }

   关键参数说明：

   • baseUrl: 必须与你的 API Key 地域匹配。

   • reasoning: 建议设为 false，某些版本的 OpenClaw 在此模式下可能返回空内容。

3. 保存并重启

   保存文件后，执行 openclaw gateway restart重启服务使配置生效。

🤖 4. 测试对话

配置完成后，你可以通过命令行测试对话功能：

bash

openclaw chat "介绍一下你自己"

如果 OpenClaw 能使用你配置的千问模型正常回复，说明整个对接流程已成功完成。