OpenClaw 接入通义千问（DashScope）配置指南¶

OpenClaw 支持通过自定义 provider 接入任何 OpenAI 兼容的接口，阿里云 DashScope 正好提供这样的兼容层，可以直接跑通义千问系列模型。

前置条件¶

已安装 OpenClaw（参考 OpenClaw 安装与配置指南）
已有阿里云 DashScope API Key（在 DashScope 控制台创建）
API Key 格式：sk-sp-xxxxxxxx

配置步骤¶

第一步：写入 API Key¶

在 OpenClaw 项目目录下创建 .env 文件（或追加到已有文件）：

# ~/Documents/OpenClaw/openclaw/.env
DASHSCOPE_API_KEY=sk-sp-你的key

.env 不要提交到 git，确认 .gitignore 已包含该文件。

第二步：创建 openclaw.json 配置文件¶

OpenClaw 的主配置文件放在 ~/.openclaw/openclaw.json：

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-sp-你的key"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "dashscope/qwen3.6-plus"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "dashscope": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.6-plus",
            "name": "Qwen 3.6 Plus",
            "contextWindow": 131072,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

字段说明：

字段	说明
`baseUrl`	DashScope OpenAI 兼容接口地址
`apiKey`	引用 env 变量，避免硬编码
`api`	固定填 `openai-completions`，告诉 OpenClaw 用 OpenAI 协议
`contextWindow`	qwen3.6-plus 支持 128K 上下文
`maxTokens`	单次最大输出 token 数

第三步：验证配置¶

# 查看当前可用模型
openclaw models list

# 查看当前默认模型
openclaw models list --default

# 手动切换模型（如需）
openclaw models set dashscope/qwen3.6-plus

可用的 Qwen 模型¶

DashScope 提供多个通义千问模型，按需替换 models[].id 和 primary 字段：

模型 ID	说明
`qwen-max`	最强，适合复杂推理任务
`qwen-plus`	均衡性价比
`qwen-turbo`	速度最快，适合简单对话
`qwen3.6-plus`	新版 Plus，支持长上下文
`qwen-long`	超长上下文（最高 1M token）

最新模型列表以 DashScope 文档为准。

常见问题¶

Q：报错 401 Unauthorized

检查 DASHSCOPE_API_KEY 是否正确，以及 DashScope 控制台该 Key 是否已开通对应模型权限。

Q：报错 model not found

模型 ID 填写错误，去 DashScope 控制台确认实际 model id（区分大小写）。

Q：想同时保留多个 provider

models.mode: "merge" 模式下可以在 providers 里同时添加多个 provider，互不影响。