OpenClaw 集成阿里云百炼模型（完整踩坑指南）

最近在用 OpenClaw 做本地 AI Agent把 Kimi 接上之后又顺手把阿里云百炼Qwen 系列也接进来了过程中踩了不少坑这里整理一份完整指南。一、核心思路非常重要OpenClaw 接百炼本质是通过 OpenAI 兼容接口接入 DashScope所以你需要三样东西Base URL百炼接口地址API KeyDASHSCOPE_API_KEY模型 ID比如qwen3.5-plus这里可以使用https://bailian.console.aliyun.com/cn-beijing?tabmodel#/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/model2️⃣ 环境变量没生效报错典型missing env var DASHSCOPE_API_KEY解决 写入~/.openclaw/.env3️⃣ Gateway 启动但连不上18789表现RPC probe failed port not listening原因 配置加载失败通常是 env 或 JSON 问题4️⃣ 模型不显示原因 99% 是agents.defaults.models没加进去5️⃣ reasoning 没关百炼必须reasoning: false否则可能出现空回复七、感悟1000000额度怎么一会就用完了呜呜呜