一、前置准备条件

在正式配置前，请提前备好以下环境与账号资源，保障配置流程顺畅无误：

• 1、本地已安装 OpenClaw Windows 版本，软件可正常启动运行

• 2、OpenClaw 顶部 Gateway 服务状态正常，保持全程在线

• 3、拥有可正常登录、状态正常的阿里云账号

• 4、设备网络可正常访问阿里云百炼官方控制台

• 5、提前开通阿里云百炼服务，账号具备有效可用额度

二、详细图文配置步骤

步骤1：登录阿里云百炼控制台

浏览器打开阿里云百炼官方登录地址：大模型服务平台百炼控制台

进入官网首页后，点击页面右上角登录按钮，完成阿里云账号登录，进入百炼控制台后台。

步骤2：进入API Key管理页面

登录成功后，在百炼首页的常用功能板块中，找到并点击「API Key」选项，进入密钥管理页面，后续将在此创建对接OpenClaw的专属密钥。

步骤3：新建API Key密钥

跳转至API Key管理页面后，点击页面右上角「创建 API Key」按钮。若账号已有存量密钥，也可新建专属密钥用于OpenClaw，方便后续权限管理与运维。

步骤4：配置密钥参数并完成创建

在弹出的密钥创建窗口中，按以下规范填写配置，无需额外修改多余参数：

• 归属业务空间：保持系统默认配置即可

• 描述：自定义填写，建议填写「OpenClaw」，便于后续区分密钥用途

• 权限：选择「全部」权限，保障模型调用无权限限制

• 最后点击「确定」，完成密钥创建

步骤5：复制保存百炼API Key

密钥创建成功后，页面会展示完整的密钥内容。需要注意的是，该密钥仅展示一次，请立刻点击复制按钮，妥善保存以 sk- 开头的完整密钥。

若未及时保存密钥，页面刷新后将无法查看完整明文密钥，只能重新创建新的API Key。

步骤6：OpenClaw配置百炼密钥并测试连通性

打开本地OpenClaw客户端，按以下步骤完成参数配置：

1. 点击客户端右上角「设置」

2. 进入左侧菜单栏「模型配置」页面

3. 在模型列表中找到「阿里云百炼」配置卡片

4. 将此前复制的sk-开头API Key完整粘贴至对应输入框

5. 点击「测试」按钮，校验密钥有效性与模型连通性

6. 测试通过后，点击右上角「保存全部配置」

如需限定调用模型，可在「自定义模型（多个用逗号分隔）」输入对应模型名称，精准控制可用模型范围。

步骤7：选择模型并发送消息核验效果

配置保存完成后，切换至OpenClaw聊天页面，在顶部模型下拉选择框中，选中阿里云百炼系列模型，优先选择带有modelstudio标签的模型，例如 qwen3.6-plus、qwen3.6-flash 等主流模型。

发送任意测试消息，若模型可正常响应回复，即代表阿里云百炼模型已成功接入OpenClaw。

三、接入完成自检清单

配置全部完成后，可通过以下清单逐项核验，规避配置遗漏与参数错误：

• 1、已成功登录阿里云百炼控制台，账号状态正常

• 2、已进入API Key管理页面，完成专属密钥创建

• 3、已完整复制并妥善保存sk-开头的明文密钥

• 4、OpenClaw阿里云百炼模块已正确粘贴密钥，无字符缺失、多余空格

• 5、密钥测试通过，客户端可正常识别可用模型

• 6、已保存全部模型配置，参数正式生效

• 7、聊天界面已成功选中阿里云百炼模型

• 8、消息测试正常，模型可稳定回复消息

四、常见问题与解决方案

1、阿里云百炼API URL需要手动填写吗？

无需手动修改，直接沿用OpenClaw默认接口地址即可，标准地址如下： https://dashscope.aliyuncs.com/compatible-mode/v1

2、密钥测试失败、模型无法调用如何排查？

可按优先级逐一排查核心问题：

• 核查API Key是否完整复制，确认密钥以sk-开头，无截断、空格、字符错误

• 确认阿里云账号已开通百炼服务，账号无异常、可用额度充足

• 核对创建API Key时，权限已选择「全部」，无权限缺失问题

• 确认密钥粘贴至阿里云百炼专属配置卡片，未填错其他模型渠道

• 配置修改后已点击保存全部配置，参数正常生效

• 本地网络可正常访问阿里云百炼官方接口，无网络拦截

3、创建密钥后忘记复制保存怎么办？

阿里云百炼API Key仅在创建成功瞬间展示完整明文，刷新页面后无法二次查看。出现该问题时，只需在控制台重新创建新的API Key，复制新密钥配置到OpenClaw即可。

五、官方参考链接

阿里云百炼控制台登录地址：大模型服务平台百炼控制台

OpenClaw一键获取：http://b.m6z.cn/hayK4