一、前置准备
在开始接入配置前，请提前核对完成全部前置条件，避免配置成功但无法调用模型：
-
已安装并可正常启动运行 OpenClaw Windows 客户端。
-
OpenClaw 顶部 Gateway 状态保持在线，无离线、报错异常。
-
电脑网络正常，可稳定访问阿里云百炼开放平台。
-
拥有可正常登录、状态正常的 阿里云账号。
-
提前开通阿里云百炼服务，账号内拥有可用免费额度或付费额度，保障模型可正常调用。
-
可正常访问百炼官方控制台：https://bailian.console.aliyun.com/cn-beijing#/home
openclaw一键部署包下载如下图：
二、详细图文接入步骤
步骤 1：打开阿里云百炼控制台并登录账号
打开浏览器，访问阿里云百炼官方控制台地址：https://bailian.console.aliyun.com/cn-beijing#/home
进入首页后，点击页面右上角登录按钮，完成阿里云账号登录，进入百炼控制台后台。
步骤 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 客户端，按流程完成参数配置：
-
点击客户端右上角 设置；
-
左侧菜单栏选择 模型配置；
-
找到 阿里云百炼 配置卡片；
-
粘贴刚刚复制的 sk- 开头完整 API Key；
-
接口地址保持默认无需修改；
-
点击 测试，等待提示连接成功、识别可用模型；
-
最后点击右上角 保存全部配置。
可选配置：可在「自定义模型」输入框手动填写模型名称（多模型用英文逗号分隔），限制仅展示指定百炼模型。
步骤 7：选择百炼模型并发送消息测试
配置保存完成后，进入 OpenClaw 左侧聊天页面。
在顶部模型下拉选择框中，选择带有 modelstudio 标签的阿里云百炼模型，日常推荐：qwen3.6-plus、qwen3.6-flash 等主流模型。
选中模型后，发送任意测试消息，能正常返回 AI 回复即代表接入成功。
三、接入完成自检清单
逐项核对排查，杜绝遗漏问题，保障长期稳定调用：
-
✅ 成功登录阿里云百炼控制台，账号状态正常、服务已开通
-
✅ 成功进入 API Key 页面并创建 OpenClaw 专属密钥
-
✅ 完整复制、妥善保存 sk- 开头完整密钥
-
✅ OpenClaw 阿里云百炼配置卡片密钥粘贴准确无误
-
✅ 密钥测试成功，客户端正常识别可用模型
-
✅ 已点击保存全部配置，参数正式生效
-
✅ 聊天页面成功选中带 modelstudio 标签的百炼模型
-
✅ 发送测试消息，模型可正常回复、调用无异常
四、常见问题解答
1. 阿里云百炼需要填写哪个 API URL？
无需手动修改，保持 OpenClaw 默认接口地址即可，官方通用兼容地址：https://dashscope.aliyuncs.com/compatible-mode/v1。
2. 点击测试失败，如何快速排查？
优先排查高频故障点，覆盖绝大多数报错问题：
-
检查 API Key 是否完整复制，以 sk- 开头，无截断、无空格、无字符错误；
-
确认阿里云账号已开通百炼服务，账号无欠费、无封禁、额度正常；
-
核对创建密钥时权限已选择「全部」，受限权限会直接调用失败；
-
确认密钥粘贴在阿里云百炼专属配置栏，未混淆其他模型渠道；
-
配置修改后已点击「保存全部配置」，参数正常生效；
-
本地网络可正常访问阿里云百炼官方接口，无网络拦截。
3. 创建密钥后忘记保存完整 Key 怎么办？
阿里云百炼密钥仅创建弹窗展示一次完整内容，关闭后无法查看完整密钥。唯一解决方法：删除旧密钥，重新创建新的 API Key，复制后重新配置至 OpenClaw。
五、官方参考地址
阿里云百炼官方控制台：https://bailian.console.aliyun.com/cn-beijing#/home
百炼默认兼容接口地址：https://dashscope.aliyuncs.com/compatible-mode/v1
openclaw一键部署包如图下载：
