最近在用 OpenClaw 做本地 AI Agent，把 Kimi 接上之后，又顺手把阿里云百炼（Qwen 系列）也接进来了，过程中踩了不少坑，这里整理一份完整指南。

一、核心思路（非常重要）

OpenClaw 接百炼，本质是：

👉 通过 OpenAI 兼容接口接入 DashScope

所以你需要三样东西：

• Base URL（百炼接口地址）

• API Key（DASHSCOPE_API_KEY）

• 模型 ID（比如 qwen3.5-plus）

这里可以使用https://bailian.console.aliyun.com/cn-beijing?tab=model#/model-usage/free-quota这个阿里百炼的官网进去，可以看到有很多模型会送1000000免费额度。注册自己的账号并且创建apikey就可以使用。

---

二、环境变量配置（关键步骤）

⚠️ 重点：不要只在终端 export，一定要让 Gateway 能读到

推荐方式：

nano ~/.openclaw/.env

写入：

DASHSCOPE_API_KEY=你的百炼Key

如果你有别的key也可以加进去。比如说我已经有了moonshot的kimi2.5，我的就是下面的。

MOONSHOT_API_KEY=你的KimiKey
DASHSCOPE_API_KEY=你的百炼Key

👉 原因：
OpenClaw Gateway 是 LaunchAgent 进程，不一定继承你 shell 的环境变量

---

三、OpenClaw 配置示例

providers 配置

"models": {
  "mode": "merge",
  "providers": {
    "moonshot": {
      "baseUrl": "https://api.moonshot.cn/v1",
      "apiKey": "${MOONSHOT_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "kimi-k2.5",
          "name": "Kimi K2.5",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 256000,
          "maxTokens": 8192
        }
      ]
    },
    "bailian": {
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "${DASHSCOPE_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.5-plus",
          "name": "Qwen 3.5 Plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536
        }
      ]
    }
  }
}

这里如果你有多个模型的话可以都加进去

---

四、agents 配置（最容易踩坑）

"agents": {
  "defaults": {
    "model": {
      "primary": "moonshot/kimi-k2.5"
    },
    "models": {
      "moonshot/kimi-k2.5": {
        "alias": "Kimi"
      },
      "bailian/qwen3.5-plus": {}
    }
  }
}

⚠️ 重点：

• models 这里是 白名单（allowlist）

• 不写进去的模型 = 用不了

---

五、启动 & 验证

openclaw gateway restart
openclaw models list

你应该能看到：

moonshot/kimi-k2.5
bailian/qwen3.5-plus

切换模型：

openclaw models set bailian/qwen3.5-plus

---

六、常见坑总结（血泪）

1️⃣ 模型前缀写错

❌ 错误：

moonshot/qwen3.5-plus

✅ 正确：

bailian/qwen3.5-plus

👉 格式必须是：provider/model

---

2️⃣ 环境变量没生效

报错典型：

missing env var "DASHSCOPE_API_KEY"

解决：

👉 写入 ~/.openclaw/.env

---

3️⃣ Gateway 启动但连不上（18789）

表现：

RPC probe failed
port not listening

原因：

👉 配置加载失败（通常是 env 或 JSON 问题）

---

4️⃣ 模型不显示

原因 99% 是：

👉 agents.defaults.models 没加进去

---

5️⃣ reasoning 没关

百炼必须：

"reasoning": false

否则可能出现空回复

---

七、感悟

1000000额度怎么一会就用完了呜呜呜😭