核心用法
OpenClaw Model Switch 是一款面向 OpenClaw 网关的模型管理技能，允许用户通过自然语言指令快速切换和新增 AI 模型。核心功能包括：
切换模型：支持 use <model> 直接切换，或交互式引导选择当前可用模型，实时查看模型状态。
新增模型：优化版向导流程，智能判断模型是否支持图片输入、推理能力等特性，预置 contextWindow/maxTokens 默认参数，一键配置 API Key 并自动保存。
预置提供商：覆盖 Google Gemini、OpenAI GPT、Anthropic Claude、阿里通义千问、Moonshot Kimi、MiniMax、智谱 GLM、DeepSeek 及自定义 Provider 共 9 大类。
---
显著优点
1. 自然语言交互：无需记忆复杂命令，用日常语言完成模型管理
2. 智能化配置：自动识别模型能力边界，减少手动参数调试
3. 开箱即用：脚本内置，无需外部克隆，chmod 后即可运行
4. 配置安全备份：切换前自动创建 .bak 备份，降低误操作风险
5. 广泛兼容性：支持主流国内外大模型生态
---
潜在缺点与局限性
- 明文存储风险：API Key 以明文形式存储于
~/.openclaw/openclaw.json，未加密 - 服务中断代价：网关重启需 5-10 秒，正在进行的会话可能中断
- 单点配置依赖：所有配置集中在一个 JSON 文件，损坏后影响全部模型
- 无权限隔离：同一配置文件管理所有模型密钥，无法按用户/项目隔离
- 外部依赖：需 OpenClaw 网关已正确安装运行
---
适合人群
- OpenClaw 网关用户需要频繁切换多模型
- 开发者测试对比不同 AI 模型效果
- 团队需要统一管理多 Provider API Key
- 追求高效命令行工作流的技术用户
---
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | 明文存储 + 文件权限不当 | `chmod 600` + 定期轮换密钥 |
| 配置损坏 | 写入操作可能破坏 JSON 结构 | 依赖自动备份，重大变更前手动备份 |
| 服务不可用 | 重启期间中断 | 避开高峰期，提前通知协作者 |
| 误切换模型 | 自然语言可能识别错误 | 执行后用 `当前模型` 确认 |