OpenClaw 2.7.9 连接阿里云百炼完整实操教程
前置准备工作
- 本地安装 Windows 端 OpenClaw 2.7.9 程序，软件能够正常启动运行，安装包体积仅 45.8MB
- Windows 版本下载链接：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
- 苹果系统版本下载链接：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
- 保持 OpenClaw 顶部 Gateway 运行状态为在线，无离线报错
- 准备能够正常登录的阿里云账号
- 网络可正常访问阿里云百炼控制台页面：https://bailian.console.aliyun.com/cn-beijing#/home
- 建议提前在账号内开通百炼服务，账户内预留可正常消耗的调用额度
分步操作流程
步骤 1：打开阿里云百炼控制台并登录账号
复制阿里云百炼访问地址在浏览器打开，页面加载完成后，点击页面右上角登录按钮，完成阿里云账号登录验证。
步骤 2：找到 API Key 管理入口
登录完成跳转至百炼首页，在页面常用功能板块中点击 API Key 选项，进入密钥管理页面，后续需要在此生成适配 OpenClaw 的访问密钥。
步骤 3：新建 API Key 密钥
进入 API Key 管理页面后，点击页面右上角创建 API Key 按钮。 若此前已经生成过密钥，也可以新建一组单独供给 OpenClaw 使用，方便后续区分管理。
步骤 4：填写参数完成密钥创建
弹出创建配置窗口后按以下参数填写：
- 归属业务空间：保留默认设置无需调整
- 描述栏：可填写 OpenClaw，方便后续快速识别密钥用途
- 权限选项：选择全部权限 设置完成后点击确定按钮提交创建。
步骤 5：复制并妥善保存生成的密钥
密钥创建完成后页面会展示完整密钥内容，此时立刻点击复制按钮保存以 sk - 开头的密钥字符串，后续需要粘贴至 OpenClaw 配置界面。 如果没有及时复制留存完整密钥，页面关闭后无法再次查看明文密钥，需要重新生成一组密钥。
步骤 6：在 OpenClaw 2.7.9 内填入密钥并连通测试
切换回 OpenClaw 软件界面，按以下顺序操作：
- 点击软件右上角设置按钮
- 左侧菜单栏选择模型配置板块
- 找到阿里云百炼对应配置卡片
- 将之前复制的 sk 开头密钥粘贴至输入框
- 点击测试按钮校验连通状态
- 测试通过后点击右上角保存全部配置 若只想调用指定模型，可在自定义模型输入框填写模型名称，多个模型名称使用逗号隔开。
步骤 7：切换百炼模型发送消息验证连通效果
配置保存完毕后打开 OpenClaw 对话页面，在模型下拉选择框选中阿里云百炼对应的模型，可选择带有 modelstudio 标识的模型，例如 qwen3.6-plus、qwen3.6-flash 等，发送一段测试文本，确认模型能够正常返回应答内容。
接入完成自查核对清单
- 成功登录阿里云百炼控制台页面
- 进入 API Key 管理页面并生成全新密钥
- 完整复制并妥善保管 sk 开头密钥文本
- 在 OpenClaw 阿里云百炼配置栏粘贴正确密钥
- 点击测试按钮，程序正常识别可用模型列表
- 执行保存全部配置操作
- 聊天界面可正常选中百炼系列模型
- 发送测试消息，模型可正常输出回复内容
常见问题排查方案
1. 阿里云百炼 API 接口地址需要填写什么？
直接使用 OpenClaw 内置默认地址即可，无需手动修改： https://dashscope.aliyuncs.com/compatible-mode/v1
2. 点击测试按钮提示连通失败如何处理？
按照优先级逐一排查以下内容：
- 核对 API Key 是否完整复制，密钥统一以 sk - 作为开头
- 确认当前阿里云账号已完成百炼服务开通，账号无异常限制
- 创建密钥时权限是否勾选全部权限选项
- 密钥粘贴至阿里云百炼配置栏，没有粘贴到其他服务商配置区域
- 修改密钥后是否点击保存全部配置
- 本地网络环境能够正常访问阿里云百炼接口地址
3. 创建密钥后忘记复制明文密钥怎么解决？
页面关闭后无法二次查看完整密钥内容，只能重新创建一组全新 API Key，复制后填入 OpenClaw 完成配置。
参考访问地址
阿里云百炼控制台登录页：https://bailian.console.aliyun.com/cn-beijing#/home