OpenClaw 连接阿里云百炼 完整图文教程
一、前置准备
开始配置前，请务必确认以下条件全部满足，避免配置失败：
- 已成功安装并正常打开 OpenClaw Windows 客户端。
- OpenClaw 顶部 Gateway 状态保持在线，无离线、报错提示。
- 拥有可正常登录、状态正常的 阿里云账号。
- 电脑网络可正常访问阿里云百炼控制台：https://bailian.console.aliyun.com/cn-beijing#/home
- 阿里云账号已开通百炼（Model Studio）服务，账号内拥有可用付费额度或免费体验额度。
一键部署包如下图输入地址获取：
二、详细图文配置步骤
步骤 1：登录阿里云百炼控制台
打开浏览器，访问阿里云百炼官方控制台地址：https://bailian.console.aliyun.com/cn-beijing#/home
进入页面后，点击页面右上角登录按钮，输入阿里云账号密码完成登录。
步骤 2：进入 API Key 管理页面
登录成功进入百炼首页后，在页面常用功能区域，找到并点击 API Key 选项。
进入该页面后，即可管理、创建对接第三方工具的密钥，为后续 OpenClaw 接入做准备。
步骤 3：新建专属 API Key
在 API Key 管理页面，点击右上角 创建 API Key 按钮。
若你已有创建过的密钥，建议新建专属密钥单独供给 OpenClaw 使用，方便后续权限管理、密钥更换与问题排查。
步骤 4：填写参数并确认创建
在弹出的创建 API Key 窗口中，按以下要求填写参数（无需复杂修改，默认即可）：
- 归属业务空间：保持系统默认
- 描述：自定义填写，建议填写 OpenClaw，方便后续识别密钥用途
- 权限：必须选择 全部（权限不足会导致模型调用失败）
参数确认无误后，点击确定完成创建。
步骤 5：复制并保存密钥（关键步骤）
密钥创建成功后，页面会弹出完整密钥，密钥以 sk- 开头。
重要提醒：请立即点击复制并妥善保存！阿里云百炼密钥仅创建时展示一次完整内容，若未及时保存、关闭弹窗后，无法二次查看，只能重新创建新密钥。
步骤 6：OpenClaw 客户端配置密钥并测试连通性
回到 OpenClaw 客户端，按以下步骤完成配置：
- 点击客户端右上角 设置 按钮
- 在左侧菜单栏选择 模型配置
- 找到 阿里云百炼 配置卡片
- 粘贴刚刚复制的 sk- 开头完整 API Key
- 接口地址保持默认无需修改：https://dashscope.aliyuncs.com/compatible-mode/v1
- 点击 测试，提示测试成功后，点击右上角 保存全部配置
可选配置：可在「自定义模型」输入框中手动填写模型名称（多模型用英文逗号分隔），限制仅展示指定百炼模型。
步骤 7：选择模型并测试对话
配置保存完成后，返回 OpenClaw 聊天页面：
- 打开顶部模型下拉选择框
- 选择带有 modelstudio 标签的阿里云百炼模型（如 qwen3.6-plus、qwen3.6-flash 等）
- 发送任意测试消息，确认 AI 可正常回复，即代表接入成功
三、接入完成自检清单
可对照清单逐项核对，确保配置无遗漏：
- ✅ 成功登录阿里云百炼控制台，账号状态正常
- ✅ 已进入 API Key 页面，创建专属 OpenClaw 密钥
- ✅ 完整复制并保存 sk- 开头密钥
- ✅ OpenClaw 阿里云百炼模块已正确粘贴密钥
- ✅ 密钥测试通过，可正常识别模型
- ✅ 已保存全部配置参数
- ✅ 聊天页成功选中百炼模型，测试消息可正常回复
四、常见问题解决方案
- 阿里云百炼 API URL 需要手动修改吗？
无需手动修改，保持 OpenClaw 默认地址即可，官方通用接口地址：
https://dashscope.aliyuncs.com/compatible-mode/v1 - 点击测试提示失败如何排查？
按优先级逐项排查，90% 问题可解决：
- 检查 API Key 是否完整复制，确保无多余空格、无截断，必须为 sk- 开头完整密钥
- 确认阿里云账号已开通百炼服务，账号无欠费、无封禁，且有可用额度
- 核对创建密钥时，权限是否选择为「全部」，受限权限会导致调用失败
- 确认密钥粘贴在阿里云百炼配置栏，未粘贴到其他模型提供商配置中
- 配置修改后必须点击「保存全部配置」，未保存配置不生效
- 检查本地网络可正常访问阿里云百炼接口，无网络代理、防火墙拦截
- 创建密钥后忘记保存怎么办？
阿里云百炼 API Key 仅创建瞬间展示完整密钥，关闭弹窗后无法找回。只能删除旧密钥，重新创建新的 API Key，复制后重新配置到 OpenClaw 中。
五、官方参考地址
阿里云百炼控制台登录地址：https://bailian.console.aliyun.com/cn-beijing#/home
百炼官方接口地址：https://dashscope.aliyuncs.com/compatible-mode/v1
