阿里云百炼对接OpenClaw完整图文教程(附安装包)
OpenClaw 对接阿里云百炼:完整图文接入指南
本教程将阿里云百炼与 OpenClaw 2.7.5 的集成流程逐一拆解,并附有截图说明,即便是零基础用户也能按步骤快速完成配置。
前置条件与环境要求
- OpenClaw Windows 版已安装并可正常启动
- OpenClaw 顶部显示 Gateway 状态为在线
- 拥有可正常登录的阿里云账号
- 可顺利访问阿里云百炼控制台
- 建议提前开通百炼服务并确认账户余额充足
详细配置步骤
第一步:登录阿里云百炼控制台
访问阿里云百炼登录页面:
https://bailian.console.aliyun.com/cn-beijing#/home
点击页面右上角的“登录”按钮,使用阿里云账号完成身份验证。
第二步:进入 API Key 管理界面
登录成功后,在百炼控制台首页的常用功能区域中,单击“API Key”,即可跳转至密钥管理页面。
第三步:创建新的 API Key
在 API Key 管理页面上,点击右上角的“创建 API Key”,即可生成一个专用于 OpenClaw 的密钥。
第四步:填写配置信息并确认创建
在弹出窗口中,按如下参数进行设置:
- 归属业务空间:保留默认选项
- 描述:填写“OpenClaw”以便后续识别
- 权限:选择“全部”
填写完毕后,单击“确定”。
第五步:复制并妥善保存 API Key
创建成功后,页面将展示完整的密钥串。请立即点击“复制”按钮,将 sk- 开头的密钥保存至安全位置。该密钥仅显示一次,丢失后需重新创建。
第六步:在 OpenClaw 中配置阿里云百炼集成
启动 OpenClaw 2.7.5,依次执行以下操作:
- 单击右上角的“设置”图标
- 进入左侧导航栏的“模型配置”
- 找到“阿里云百炼”配置项
- 将刚才复制的 API Key 粘贴到对应输入框中
- 单击“测试”按钮
- 测试通过后,单击“保存全部配置”
阿里云百炼默认的接口地址为:
https://dashscope.aliyuncs.com/compatible-mode/v1
测试成功后,系统将自动拉取百炼平台所有可用的模型列表。
第七步:选择模型并验证接入效果
配置保存后,进入 OpenClaw 的聊天界面。在模型下拉列表中,选择带有 modelstudio 标签的百炼模型(如 qwen3.6-plus、qwen3.6-flash 等)。发送任意消息进行测试,若收到正常回复,即表示集成配置成功。
接入验证自检清单
- 是否已登录阿里云百炼控制台
- 是否已创建并复制 API Key
- 是否已在 OpenClaw 的阿里云百炼配置中填入密钥
- 测试是否能正常获取模型列表
- 是否已保存全部配置
- 聊天页面是否已切换至百炼模型
- 是否能正常收发消息
常见问题排查
问题1:阿里云百炼的 API 地址如何填写?
默认地址为 https://dashscope.aliyuncs.com/compatible-mode/v1,通常无需手动更改。
问题2:测试失败应如何处理?
请从以下角度逐一排查:
- 确认 API Key 是否完整复制
- 确认百炼服务已开通且账号状态正常
- 密钥权限是否已设为“全部”
- 密钥是否已粘贴至阿里云百炼配置项
- 是否已单击“保存全部配置”
- 网络能否正常访问阿里云接口
问题3:忘记保存 API Key 如何解决?
重新创建一个新的 API Key,并将新密钥复制到 OpenClaw 中使用即可。
相关链接
阿里云百炼控制台地址:
https://bailian.console.aliyun.com/cn-beijing#/home
