【记录】配置openclaw+千问大模型（为什么是千问，问就是免费）

OpenClaw支持通过OpenAI兼容接口接入阿里云百炼的文本生成模型，包括千问系列、开源版千问及第三方模型。配置需完成阿里云百炼账号注册、服务开通及免费额度领取，并安装Node.js 22+环境。提供两种配置方式：Web控制台或编辑配置文件，需设置Base URL、API Key和模型ID（注意地域匹配）。安装后可通过命令行或Web界面与AI交互。常见问题包括模型引用错误或命令未找到，需检查参

芳草萋萋鹦鹉洲哦

9018人浏览 · 2026-03-03 14:59:17

芳草萋萋鹦鹉洲哦 · 2026-03-03 14:59:17 发布

OpenClaw 通过 OpenAI 兼容接口接入阿里云百炼的文本生成模型，支持以下模型类型：

文本生成-千问：千问Max、千问Plus、千问Flash、千问Coder
文本生成-千问-开源版：Qwen3、QwQ-开源版、QwQ-Preview、Qwen2.5、Qwen2、Qwen1.5、Qwen-Coder
文本生成-第三方模型：DeepSeek、Kimi、GLM、MiniMax（仅支持北京地域）

注意：第三方模型仅支持北京地域，配置时需要使用北京地域的 Base URL 和 API Key。

配置步骤

1. 开通阿里云百炼

注册账号：若没有阿里云账号，请先注册。
开通服务：使用主账号访问阿里云百炼大模型服务平台，阅读并同意协议后自动开通。若提示“您尚未进行实名认证”，请先完成实名认证。
领取免费额度：首次开通可领取新人免费额度（有效期90天），用于模型推理测试。详情请查看新人免费额度页面。

超出额度或期限将产生费用，建议开启消费限额功能避免意外扣费。

2. 安装 OpenClaw

环境要求

OpenClaw 需要 Node.js 22 或更高版本。检查命令：

node --version

如未安装或版本过低，请访问 Node.js官网下载安装。

安装方式

macOS / Linux
推荐使用官方安装脚本：

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

或通过 npm 全局安装：

npm install -g openclaw@latest

Windows
使用 npm 安装（需先安装Node.js）：

npm install -g openclaw@latest

完成初始配置向导

首次安装后，OpenClaw 会自动启动配置向导。你也可以手动执行：

openclaw onboard

建议按以下选项快速完成初始设置：

配置项	建议配置
I understand this is powerful and inherently risky. Continue?	Yes
Onboarding mode	QuickStart
Model/auth provider	Skip for now
Filter models by provider	All providers
Default model	Keep current
Select channel (QuickStart)	Skip for now
Configure skills now? (recommended)	No
Enable hooks?	按空格选中，回车
How do you want to hatch your bot?	Do this later

接下来我们将为 OpenClaw 配置百炼模型。

3. 配置百炼模型

配置 OpenClaw 接入阿里云百炼需要三个关键参数：

Base URL：按地域区分
- 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
- 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1
API Key：访问凭证，从密钥管理页面获取（注意选择对应地域）。
模型 ID：例如 qwen3-max-2026-01-23、qwen3-coder-plus。各地域支持的模型列表请参考前文“模型支持与选型”。

重要提醒：

确保 Base URL、API Key 和模型都归属于同一地域。

配置时需将 reasoning 参数设为 false，否则会导致回复为空。

Coding Plan 用户请使用专属接入方式，详见 OpenClaw Coding Plan说明文档。

OpenClaw 提供了两种配置方式，推荐使用 Web 控制台。

方式一：Web 控制台配置

启动 Web 控制台
在终端执行：
```
openclaw dashboard
```
浏览器将自动打开控制台页面（通常是 http://127.0.0.1:18789）。
进入配置页面
在左侧菜单依次选择：Config > Authentication，然后点击下方的 Raw。

添加百炼配置
复制以下配置信息，替换 "agents": {...}, 部分，并将 DASHSCOPE_API_KEY 替换为你的百炼 API Key。

以下配置使用北京地域 Base URL，如需其他地域请相应修改。

"models": {
  "mode": "merge",
  "providers": {
    "bailian": {
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "DASHSCOPE_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3-max-2026-01-23",
          "name": "qwen3-max-thinking",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 262144,
          "maxTokens": 65536
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "bailian/qwen3-max-2026-01-23"
    },
    "models": {
      "bailian/qwen3-max-2026-01-23": {
        "alias": "qwen3-max-thinking"
      }
    },
    "maxConcurrent": 4,
    "subagents": {
      "maxConcurrent": 8
    }
  }
}