OpenClaw v2.7.9 对接阿里云百炼图文实操教程

前期部署与账号准备条件

在进行模型对接配置前，需要提前完成全部基础环境准备工作，避免配置流程出现阻断：

1. 本地电脑已完成 OpenClaw v2.7.9 完整安装，客户端能够正常启动运行
2. Windows 安装包：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. MacOS 苹果系统安装包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
4. 安装压缩包整体体积 45.8MB，解压后即可完成整套环境部署，无需额外配置依赖。
5. 软件顶部 Gateway 网关服务持续保持在线状态，无离线报错提示
6. 持有状态正常、可顺利登录的阿里云账号
7. 网络环境可正常访问阿里云百炼管理后台：https://bailian.console.aliyun.com/cn-beijing#/home
8. 账号已完成百炼服务开通，账户内具备可用模型调用额度，保障模型正常发起请求

分步骤图文配置流程

步骤 1：进入阿里云百炼控制台并完成账号登录

复制百炼平台后台地址至浏览器打开，页面右上角点击登录按钮，完成阿里云账号身份校验登录。 

步骤 2：跳转至 API 密钥管理功能页面

登录进入百炼首页后，在页面常用功能板块找到 API Key 入口并点击，进入密钥统一管理界面，后续将在此生成 OpenClaw 对接所需身份凭证。

步骤 3：新建专属 API 密钥

打开密钥管理页面后，点击页面右上角创建 API Key 按钮。 若账号内已存在历史密钥记录，建议单独新建一组密钥专供 OpenClaw 调用，方便后期权限管控、密钥更换与故障排查。 

步骤 4：填写密钥创建参数并确认生成

弹出新建密钥配置弹窗后，按照以下规范填写对应内容：

• 归属业务空间：保持系统默认设置，无需手动调整
• 描述备注栏：填写 OpenClaw，便于快速区分密钥使用场景
• 权限范围选项：选择全部权限 参数核对无误后点击确定，完成密钥生成操作。 

步骤 5：复制留存完整 sk 开头密钥

密钥创建完成后页面会临时展示完整密钥字符串，建议立刻点击复制按钮妥善保存该凭证，后续需要粘贴至 OpenClaw 配置栏。 重要提示：该完整密钥仅弹窗单次展示，关闭弹窗后无法再次查看，只能重新创建新密钥。

步骤 6：OpenClaw 客户端填入密钥并执行连通测试

切换回 OpenClaw 客户端，按顺序完成以下操作：

1. 点击软件右上角设置功能入口
2. 左侧菜单栏切换至模型配置分类页面
3. 在服务商列表找到阿里云百炼配置卡片
4. 将之前复制的 sk 开头密钥完整粘贴至输入框
5. 点击测试按钮校验接口连通状态
6. 测试提示正常后，点击右上角保存全部配置 拓展自定义设置：若仅需要调用指定模型，可在自定义模型输入框填写模型名称，多模型名称使用英文逗号分隔。

步骤 7：切换百炼模型发送消息验证调用效果

参数保存完毕后回到软件对话页面，点击顶部模型下拉选择框，选中带有 modelstudio 标识的通义系列模型，例如 qwen3.6-plus、qwen3.6-flash 等，任意发送一段测试文本，能够正常接收 AI 回复即代表接入流程全部完成。 

接入完成自检核对清单

• 可正常登录阿里云百炼控制台后台页面
• 成功进入 API Key 管理页面并生成全新专属密钥
• 完整备份以 sk 为前缀的密钥字符串，无字符缺失
• OpenClaw 阿里云百炼配置卡片内已粘贴正确密钥内容
• 连通测试执行通过，程序可正常读取账户内可用模型列表
• 全部配置参数执行保存全部配置操作
• 对话面板成功选中阿里云百炼提供的大模型
• 发送测试消息可获取稳定、正常的 AI 应答内容

高频配置异常排查方案

1. 阿里云百炼 API 接口地址是否需要手动修改？

无需手动变更接口地址，直接沿用 OpenClaw 内置默认地址即可： https://dashscope.aliyuncs.com/compatible-mode/v1

2. 点击测试按钮提示连通失败，多维度排查方向

1. 核对密钥是否完整复制，确认密钥开头为 sk-，不存在截断、多余空格
2. 确认阿里云账号已成功开通百炼服务，账户无风控、欠费等异常限制
3. 创建密钥时权限选项是否勾选全部权限，权限不足会直接拦截模型调用
4. 密钥粘贴至阿里云百炼对应配置模块，未错填至其他 AI 服务商栏目
5. 修改密钥参数后是否执行保存全部配置操作，未保存会导致参数不生效
6. 当前本地网络环境能够正常访问阿里云官方接口服务

3. 密钥创建后未及时复制备份如何处理？

密钥展示弹窗关闭后，平台不再提供完整密钥查看入口，只能重新创建全新 API Key，复制新生成密钥填入 OpenClaw 完成对接配置。

阿里云百炼平台访问地址

阿里云百炼控制台登录页：https://bailian.console.aliyun.com/cn-beijing#/home