OpenClaw 连接阿里云百炼图文实操教程
前置环境准备
- 设备已部署 OpenClaw v2.7.9 Windows 客户端，软件能够正常启动运行；
- OpenClaw 顶部 Gateway 服务状态保持在线；
- 准备可正常登录的阿里云账号；
- 网络环境通畅，能够正常访问阿里云百炼控制台：https://bailian.console.aliyun.com/cn-beijing#/home
- 建议提前开通百炼相关服务，确认账户具备可用调用额度。
OpenClaw 整合资源包大小 45.8MB
Windows 版本下载地址： https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
macOS 版本下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
完整图文操作步骤
步骤 1：访问阿里云百炼控制台并登录账号
打开浏览器跳转阿里云百炼访问地址：https://bailian.console.aliyun.com/cn-beijing#/home 进入页面后，点击页面右上角登录按钮，完成阿里云账号登录操作。
步骤 2：进入 API Key 管理页面
登录成功进入百炼控制台首页，在常用功能板块找到 API Key 入口点击进入。 该页面用于管理调用大模型所需密钥，后续创建的密钥将在此统一维护。
步骤 3：发起创建 API Key 操作
进入 API Key 管理页面后，点击右上角创建 API Key。 如果名下已有可用密钥，也可以新建独立密钥专供 OpenClaw 使用，方便后期权限管理。
步骤 4：填写参数信息并确认创建
在弹出的配置窗口中完成设置： 归属业务空间：维持默认选项无需改动； 描述栏：自定义填写标识，例如 OpenClaw，方便区分密钥用途； 权限选项：选择全部； 信息填写完毕后点击确定完成创建。
步骤 5：复制密钥并做好备份留存
密钥生成之后页面会展示完整字符串，请立刻点击复制进行保存。 该密钥以 sk - 作为开头，后续需要粘贴至 OpenClaw 配置面板。 一旦关闭弹窗，平台不会再次展示完整密钥，若未及时备份，只能重新生成新密钥。
步骤 6：在 OpenClaw v2.7.9 填入密钥并执行连通测试
切换至 OpenClaw 客户端进行配置：
- 点击软件右上角设置；
- 在左侧菜单栏选择模型配置；
- 在列表找到阿里云百炼配置项，粘贴刚刚复制完成的 API Key；
- 点击测试按钮校验连通状态；
- 测试正常后点击右上角保存全部配置。
拓展设置：如果需要限定程序加载指定模型，可以在自定义模型输入框填写模型名称，多个模型名称使用逗号隔开。
步骤 7：聊天界面选择百炼模型，发送消息验证连通效果
参数保存完成后，打开 OpenClaw 聊天页面，在模型下拉列表选择阿里云百炼提供的模型。 优先选择带有 modelstudio 标签的模型，例如 qwen3.6-plus、qwen3.6-flash 等。选定模型后发送测试对话，确认程序能够正常返回内容。
接入完成自检核对清单
✅ 顺利登录阿里云百炼控制台
✅ 进入 API Key 管理页面，完成新密钥创建
✅ 完整复制并妥善保存 sk 开头密钥
✅ 在 OpenClaw v2.7.9 阿里云百炼栏目填入正确密钥
✅ 点击测试，系统识别到可用模型
✅ 执行保存全部配置操作
✅ 聊天页面成功选中阿里云百炼对应的模型
✅ 发送测试消息，客户端正常输出回复内容
常见问题解决方案
1. 阿里云百炼接口地址需要填写什么？
常规场景直接使用 OpenClaw 默认地址即可： https://dashscope.aliyuncs.com/compatible-mode/v1
2. 点击测试按钮提示连接失败，如何排查？
按照顺序逐项核对： ① API Key 复制完整，前后不存在多余空格、换行符号，密钥以 sk - 开头； ② 阿里云账号已经开通百炼服务，账号状态正常； ③ 创建密钥阶段权限选择为全部； ④ 密钥粘贴在阿里云百炼配置分类，没有填入其他模型服务商栏目； ⑤ 参数修改完成后点击保存全部配置； ⑥ 当前网络能够正常访问阿里云百炼接口。
3. 创建密钥之后忘记复制保存怎么办？
弹窗关闭后无法查看完整密钥文本，只能删除旧密钥，重新创建全新 API Key，再复制配置到 OpenClaw v2.7.9 中。
参考链接
阿里云百炼控制台地址：https://bailian.console.aliyun.com/cn-beijing#/home
