Alibaba Cloud Model Setup

核心用法

该技能通过交互式脚本完成阿里云百炼模型平台的接入配置，支持北京中国站、新加坡国际站、弗吉尼亚美国站三站点选择。用户需提供 Access Key，选择密钥存储方式（推荐环境变量），并配置默认模型集（qwen-max、qwen-flash、qwen3-coder-plus）。脚本会自动探测 OpenClaw/Moltbot/Clawdbot 历史配置路径，创建带时间戳的备份，以 balian 提供商名称写入 OpenAI 兼容模式配置。

显著优点

• 零手动编辑：避免直接修改 JSON 配置文件的格式错误风险
• 多站点原生支持：内置三站点 endpoint 映射，自动匹配 baseUrl
• 安全备份机制：覆盖前自动创建时间戳备份，支持配置回滚
• 历史兼容：无缝迁移 Moltbot/Clawdbot 遗留配置路径
• 实时模型发现：支持从 API 拉取可用模型列表，避免硬编码过期 ID
• 非交互模式：完整 CLI 参数支持，便于 CI/CD 自动化部署

潜在缺点与局限性

• 密钥暴露风险：若选择 inline 存储模式，API key 将以明文写入配置文件
• 站点选择不可逆：切换站点需重新运行脚本，无法热切换
• 默认模型偏置：预设模型列表可能滞后于阿里云实际发布节奏
• 无代理配置：脚本未内置 HTTP/HTTPS 代理参数，企业内网需额外配置
• 单租户限制：不支持多阿里云账号同时配置，需手动切换

适合人群

• OpenClaw/Clawdbot/Moltbot 用户需接入阿里云 Qwen 系列模型
• 团队管理员需批量标准化配置开发环境
• 偏好交互式引导而非手动编辑配置文件的开发者

常规风险

• 凭证泄露：环境变量未正确设置时，inline 模式可能导致密钥入 git
• 站点误配：选择错误站点会导致 API 调用失败或跨境延迟
• 模型 ID 漂移：阿里云模型迭代频繁，硬编码 ID 可能突然失效
• 配置覆盖：备份机制虽存在，但误操作仍可能丢失自定义配置片段

建议生产环境强制使用 --api-key-source env 模式，并将 DASHSCOPE_API_KEY 纳入秘密管理系统。

核心用法

本 Skill 用于为 OpenClaw（含历史版本 Moltbot/Clawdbot）配置阿里云 DashScope 模型服务。通过交互式脚本收集用户凭证，支持选择中国站（CN）、国际站（INTL）或美国站（US），自动将配置写入本地 JSON 文件，无需手动编辑配置文件。

使用方式分为交互模式与非交互模式：

• 交互模式：运行 python3 scripts/alibaba_cloud_model_setup.py，按提示输入 Access Key、选择站点、确认模型列表
• 非交互模式：通过命令行参数一次性完成配置，适合 CI/CD 场景
• 模型查询：可单独调用 --list-models 获取实时可用模型列表，不写入配置

脚本会自动检测现有配置路径（优先 OpenClaw，兼容旧版本），创建带时间戳的备份，保留非相关配置段落，确保数据安全。

显著优点

1. 零第三方依赖：仅使用 Python 标准库（argparse/json/os/pathlib/urllib），彻底规避供应链攻击风险
2. 多站点原生支持：内置北京、新加坡、弗吉尼亚三地域端点，自动匹配 OpenAI-compatible API 模式
3. 密钥管理灵活：优先推荐环境变量存储（DASHSCOPE_API_KEY），同时支持内联配置并附带风险提示
4. 配置安全机制：写入前自动备份、JSON 格式校验、模型 ID 在线验证，降低配置错误导致的服务中断
5. 向后兼容：自动识别 Moltbot/Clawdbot 历史配置路径，方便老用户迁移

潜在缺点与局限性

1. 维护者可信度：当前为社区个人开发者（extraterrest）维护的未授权项目，非阿里云官方出品，长期维护稳定性存疑
2. 功能边界：仅覆盖配置初始化与模型列表获取，不涉及用量监控、成本控制、故障诊断等运维功能
3. 站点认知门槛：用户需自行理解 CN/INTL/US 三站点的账号体系差异（如中国站需实名认证，国际站计费独立），脚本本身不做业务规则校验
4. 模型预设固定：默认仅包含 qwen-max/qwen-flash/qwen3-coder-plus，其他模型需手动添加或依赖 --list-models 后人工筛选
5. 非交互模式复杂度：命令行参数较多，对新手不够友好，误配可能导致配置写入失败

适合的目标群体

• OpenClaw/Moltbot/Clawdbot 用户需要快速接入阿里云 Qwen 系列模型
• 具备基础 Python 环境、能获取阿里云 Access Key 的技术用户
• 需要在多地域部署中快速切换站点配置的开发者或运维人员
• 希望避免手动编辑 JSON 配置、降低语法错误风险的效率导向用户

使用风险

性能风险：首次运行需调用阿里云 API 验证密钥有效性，网络延迟或 DNS 解析问题可能导致交互卡顿，建议配置国内镜像或代理。

凭证泄露风险：虽然脚本推荐环境变量存储，但若用户选择内联模式且后续将配置文件提交至 Git，可能造成密钥泄露。建议配合 .gitignore 规则使用。

配置覆盖风险：自动备份机制虽存在，但用户若频繁运行脚本可能累积大量备份文件，需定期清理避免磁盘占用。

API 变更风险：阿里云 DashScope API 端点或字段格式可能升级，脚本硬编码的端点列表需要维护者及时更新，否则可能导致连接失败。

权限风险：脚本本身不校验 API Key 的权限范围，若用户使用了过高权限的密钥，一旦泄露影响面较大，建议遵循最小权限原则创建子账号专用密钥。