核心用法
本 Skill 用于在 OpenClaw(含历史 Moltbot/Clawdbot 配置)中集成阿里云 Model Studio(百炼)模型服务。核心入口为 python3 scripts/alibaba_cloud_model_setup.py 脚本,提供交互式与命令行两种模式。
交互式流程关键步骤:
1. 终端能力确认:首先询问用户是否可立即执行终端命令,据此决定采用环境变量模式(推荐)或内联密钥模式
2. 环境变量模式:展示 export DASHSCOPE_API_KEY=xxx 及追加到 ~/.bashrc 的命令,用户执行后验证,最多重试 2 次;若失败且用户拒绝内联回退,则终止流程
3. 站点选择:北京(CN)、新加坡(INTL)、弗吉尼亚(US)三选一
4. 密钥验证:内联模式需输入 Access Key,实时校验有效性后才写入配置
5. 模型配置:默认预设 qwen-max、qwen-flash、qwen3-coder-plus,可选从 API 拉取实时模型列表追加,可设默认模型
非交互式参数:支持 --site、--api-key-source、--env-var、--models、--model、--set-default、--list-models 等完整参数化调用。
显著优点
- 配置安全:强制使用脚本写入,禁止手动编辑 JSON,带时间戳备份,保留无关配置
- 多站点支持:覆盖阿里云国内外三大区域,自动匹配对应 endpoint
- 环境变量优先:推荐的安全凭证管理方式,支持 systemd 用户服务环境变量检测
- 模型发现:可实时拉取百炼平台可用模型 ID,避免硬编码过时模型
- 向后兼容:自动识别
~/.openclaw、~/.moltbot、~/.clawdbot历史路径
潜在缺点与局限性
- 依赖终端交互:完整功能需用户具备即时终端操作能力,否则流程阻塞或降级
- systemd 限制:若使用 systemd 部署,需确保
systemctl --user show-environment已含目标变量,否则拒绝写入,增加配置复杂度 - 验证重试有限:环境变量检测仅 2 次重试,网络延迟或 shell 配置延迟可能导致流程中断
- 非交互式需预置密钥:自动化场景需提前暴露
DASHSCOPE_API_KEY,存在 CI/日志泄露风险
适合人群
- 使用 OpenClaw/Moltbot/Clawdbot 需接入阿里云 Qwen 系列模型的开发者
- 偏好交互式配置向导、不愿手动维护 JSON 的终端用户
- 需在多区域(CN/INTL/US)间切换模型源的团队
常规风险
- 密钥泄露:内联模式在命令历史中留存密钥;环境变量模式在共享机器上可能被其他用户读取
/proc/*/environ - 配置覆盖:虽有时间戳备份,但误操作仍可能导致服务短暂中断
- API 可用性:实时模型拉取依赖百炼 API,若服务异常则模型发现失败