Alibaba Cloud Model Setup

核心用法

Alibaba Cloud Model Setup 是一个专为 OpenClaw（含历史 Moltbot/Clawdbot 兼容路径）设计的配置自动化技能。通过交互式脚本或命令行参数，引导用户完成 Alibaba Cloud 模型提供商的接入配置，支持北京中国站（CN）、新加坡国际站（INTL）、弗吉尼亚美国站（US）三站点选择。

显著优点

• 零手动编辑：通过 python3 scripts/alibaba_cloud_model_setup.py 一键完成配置，自动检测并备份现有配置文件
• 安全优先：强烈推荐环境变量模式存储 API 密钥，支持自动持久化到 ~/.bashrc 和 systemd 用户服务，避免密钥硬编码
• 智能检测：自动识别 ~/.openclaw/openclaw.json、~/.moltbot/moltbot.json、~/.clawdbot/clawdbot.json 等历史配置路径
• 实时验证：配置前验证 API 密钥有效性，支持实时拉取可用模型列表
• 非交互式支持：完整的 CLI 参数支持，便于 CI/CD 集成

潜在缺点与局限性

• 依赖本地 Python 环境：需要 python3 及依赖库可用
• Shell 配置分散：跨多种 shell（zsh/fish）的用户需手动调整持久化路径
• systemd 限制：自动检测仅支持 systemd --user 环境，系统级服务需手动配置
• 站点切换成本：变更站点需重新验证并可能更换 API 密钥

适合人群

• OpenClaw/Moltbot/Clawdbot 用户需要接入 Qwen 系列模型
• 追求配置自动化、避免手动 JSON 编辑的开发者
• 有多站点部署需求（国内/国际/美国）的跨国团队

常规风险

• 密钥泄露风险：若选择内联模式存储 API 密钥，配置文件需严格限制权限（chmod 600）
• 环境变量作用域：子进程可能无法继承 shell 环境变量，导致运行时认证失败
• 配置覆盖风险：虽有自动备份，但频繁运行可能产生过多备份文件

Alibaba Cloud Model Setup 是一款专为 OpenClaw（及历史版本 Moltbot/Clawdbot）设计的交互式配置技能，旨在简化阿里云大模型服务的接入流程。

核心用法

该技能通过 Python 脚本实现全自动配置：用户运行脚本后，系统会自动检测现有配置文件（按 ~/.openclaw/openclaw.json → ~/.moltbot/moltbot.json → ~/.clawdbot/clawdbot.json 优先级），并引导完成 Access Key 录入、存储模式选择（推荐环境变量）、站点选择（北京 CN / 新加坡 INTL / 弗吉尼亚 US）、API 密钥验证、预设模型配置（qwen-max、qwen-flash、qwen3-coder-plus）及默认模型设置。脚本支持交互式与非交互式两种模式，后者可通过命令行参数完成无人值守部署。配置过程中会自动创建带时间戳的备份，确保数据安全。

显著优点

1. 零依赖轻量化：纯 Python 标准库实现，无第三方包，彻底规避供应链攻击风险
2. 多区域智能适配：内置阿里云三个官方站点（CN/INTL/US）的端点映射，自动匹配最优接入点
3. 环境变量优先：推荐并支持环境变量存储 API Key，避免密钥硬编码；可选自动持久化到 ~/.bashrc 及 systemd 用户服务
4. 实时模型发现：支持调用阿里云 API 获取实时可用模型列表，避免手动查找 model ID
5. 配置无损迁移：兼容 OpenClaw、Moltbot、Clawdbot 三种历史配置路径，自动识别并平滑升级

潜在缺点与局限性

1. Shell 覆盖有限：当前仅原生支持 ~/.bashrc，Zsh（.zshrc）、Fish 等用户需手动适配
2. systemd 绑定场景：自动检测并修改 openclaw.service 虽便利，但非 systemd 环境用户可能困惑
3. T3 来源信任度：作为个人/社区项目（非企业官方维护），长期维护连续性存在不确定性
4. 无 GUI 界面：纯命令行交互，对非技术用户友好度有限

适合的目标群体

• OpenClaw/Moltbot/Clawdbot 终端用户，需快速接入阿里云 Qwen 系列大模型
• DevOps/平台工程师，需在服务器环境批量部署标准化配置
• 多区域业务团队，需灵活切换中国站与国际站模型服务
• 安全敏感型用户，倾向环境变量隔离凭证而非明文存储

使用风险

• 服务重启风险：启用 --persist-env-systemd 时会自动重启 openclaw.service，可能导致短暂服务中断
• Shell 配置污染：若用户误选不匹配的 shell 配置文件，可能引入语法错误；建议配置后执行 source ~/.bashrc 验证
• API Key 泄露：inline 模式下密钥以明文写入 JSON，日志输出建议启用掩码（当前版本已建议改进）
• 区域合规注意：中国站（CN）与国际站（INTL/US）的模型可用性及计费策略存在差异，切换前需确认账号权限