核心用法
alibaba-cloud-model-setup 是 OpenClaw 生态中专用于接入阿里云百炼（Bailian）大模型平台的配置技能。用户通过交互式脚本或命令行参数，可在数分钟内完成从 API 密钥验证到模型列表写入的全流程，无需手动编辑 JSON 配置文件。
关键步骤：
1. 选择计费模式：按量付费（Pay-As-You-Go）或 订阅制（Coding Plan），决定可用模型范围与站点地址
2. 选择接入站点：根据网络环境从 5 个预设站点（CN/INTL/US 等）中选择最优线路
3. 执行配置脚本：python3 scripts/alibaba_cloud_model_setup.py 交互式收集 API Key、存储方式（环境变量优先）、主模型选择
4. 自动备份与写入：脚本自动备份旧配置，以 merge 模式写入新 provider，保留其他服务商配置
5. 验证与生效：JSON 语法校验、端点可达性测试、最终启动 Dashboard 验证调用
模型覆盖：
- 按量付费：11 款模型，涵盖 Qwen-Max/Plus/Flash/Coder 四大旗舰系列及最新 Qwen3.5+
- 订阅制：额外解锁 MiniMax-M2.5、GLM-5/4.7、Kimi-K2.5 等第三方闭源模型，共 15 款
显著优点
- 配置零门槛：完全屏蔽 JSON 手动编辑，降低配置错误导致的启动失败风险
- 安全设计：强制 API Key 前置验证、环境变量存储推荐、写入前自动备份、配置完成后 JSON 语法校验
- 网络灵活：5 个站点覆盖中国大陆、国际、美国，自动适配最优接入点
- 模型即开即用：内置模型元数据（context window、多模态能力、成本档位），无需用户自行查阅文档
- 向后兼容：
merge模式确保新增 provider 不破坏既有 OpenAI/Anthropic 等配置
潜在局限
- 地域限制：部分国际站点需境外网络环境，国内用户可能需额外配置代理
- 计费复杂度：同一账户可同时拥有按量付费与订阅制资源，脚本不会自动处理余额不足或欠费场景
- 模型版本漂移：
qwen3-max-2026-01-23等日期版本模型可能随阿里云迭代下线，需关注官方公告 - 第三方模型稳定性：Coding Plan 附带的 MiniMax/GLM/Kimi 模型由阿里云转售，SLA 与官方直签存在差异
适合人群
- 寻求在 OpenClaw 中快速接入国产顶级大模型的开发者
- 已持有阿里云百炼 API Key、希望避免手动配置 JSON 的运维人员
- 需要同时对比 Qwen、Kimi、GLM、MiniMax 多模型效果的 AI 应用团队
- 对配置安全性有要求、偏好环境变量隔离密钥的合规敏感型用户
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| **密钥泄露** | 选择 inline 存储模式时 API Key 明文写入磁盘 | 优先使用 `--api-key-source env` 并配合 `DASHSCOPE_API_KEY` 环境变量 |
| **配置覆盖** | 异常中断可能导致 JSON 损坏 | 脚本内置原子写入与备份机制，恢复时从 `~/.openclaw/backups/` 取回 |
| **网络不可达** | 误选国际站点导致国内请求超时 | 脚本提供站点延迟探测建议，首次配置后运行 `openclaw doctor` 诊断 |
| **模型计费误算** | 高频调用下按量费用失控 | 启用 OpenClaw 内置 cost-tracking 插件或设置阿里云预算告警 |
| **订阅过期** | Coding Plan 到期后模型调用 403 | 脚本提示有效期，建议日历提醒续费 |