OpenClaw 2.7.1 接入阿里云百炼 超详细图文配置教程
前置准备
- 本地已安装并能正常运行 OpenClaw 2.7.1 Windows 版本
- OpenClaw 顶部 Gateway 运行状态保持在线
- 拥有可正常登录的阿里云账号
- 网络可正常访问阿里云百炼控制台地址:https://bailian.console.aliyun.com/cn-beijing#/home
- 提前完成百炼服务开通,账号内具备可用调用额度
完整图文配置步骤
步骤 1:访问阿里云百炼控制台并登录
打开阿里云百炼官方控制台地址:
https://bailian.console.aliyun.com/cn-beijing#/home进入页面后,点击页面右上角登录按钮,完成个人阿里云账号登录操作。
步骤 2:进入 API Key 管理入口
登录成功进入百炼首页后,在常用功能板块中,找到并点击 API Key 选项,进入密钥管理页面,后续需要在此创建接入 OpenClaw 所需的调用密钥。
步骤 3:新建专属 API Key
进入 API Key 管理界面后,点击页面右上角 创建 API Key。
若已有创建过密钥,也可以新建一条单独供给 OpenClaw 使用,方便后期管理与权限管控。
步骤 4:配置密钥参数并确认创建
在弹出的创建窗口中按如下设置:
- 归属业务空间:保持默认配置即可
- 描述:自定义填写,例如填写
OpenClaw2.7.1便于识别 - 权限:选择 全部填写完成后点击确定完成创建。
步骤 5:复制保存 sk 开头密钥
密钥生成成功后,页面会展示完整密钥串,立即点击复制 妥善保存。
密钥以 sk- 开头,后续需要粘贴到 OpenClaw 配置面板;若关闭弹窗后未留存完整密钥,只能重新创建新的 API Key。
步骤 6:OpenClaw 2.7.1 配置阿里云百炼密钥
回到 OpenClaw 2.7.1 软件界面,按路径操作:
- 点击软件右上角 设置
- 左侧选择 模型配置
- 在模型提供商列表找到 阿里云百炼
- 将刚才复制的 sk 开头 API Key 粘贴到输入框
- 点击 测试 按钮校验连通性
- 测试通过后,点击右上角 保存全部配置
如需只加载指定模型,可在「自定义模型」输入框中填写模型名称,多个模型用英文逗号分隔即可。
步骤 7:选择百炼模型发起对话测试
配置保存完成后,进入 OpenClaw 聊天界面,在模型下拉选择框中挑选阿里云百炼系列模型。
可选 qwen3.6-plus、qwen3.6-flash 等带 modelstudio 标识的模型,发送任意文本消息,能够正常回复即代表接入成功。
接入完成自检清单
- ✅ 成功登录阿里云百炼控制台后台
- ✅ 进入 API Key 页面并生成专属密钥
- ✅ 完整复制保存 sk 开头密钥字符串
- ✅ 在 OpenClaw 2.7.1 正确粘贴百炼密钥
- ✅ 点击测试并成功拉取到可用模型列表
- ✅ 保存全部配置参数
- ✅ 聊天界面正常选中百炼模型
- ✅ 发送测试消息可正常交互回复
常见问题解决方案
1. 阿里云百炼 API URL 需要手动填写吗?
无需手动修改,保持 OpenClaw 默认地址即可:
https://dashscope.aliyuncs.com/compatible-mode/v1
2. 点击测试连通性失败如何排查?
- 检查 API Key 是否完整复制,确认以 sk- 开头无多余空格
- 核实阿里云账号已开通百炼服务,账号状态无异常限制
- 创建密钥时权限务必选择「全部」权限
- 确认密钥填入阿里云百炼配置栏,未填错其他模型服务商
- 配置修改后务必点击保存全部配置
- 检查本地网络能否正常访问阿里云百炼接口服务
3. 密钥创建后没有及时复制怎么办?
完整密钥仅创建弹窗时可见,关闭后无法查看完整内容,只能重新创建新 API Key 再配置。
相关参考地址
阿里云百炼控制台登录地址:https://bailian.console.aliyun.com/cn-beijing#/home
openclaw v2.7.1 下载地址(复制到浏览器下载):https://xiake.yun/api/download/package/14?promoCode=IV6234E91773