Openclaw Model Switch

OpenClaw AI 模型切换技能 - 用自然语言切换和添加 AI 模型。 支持 9+ 预置提供商（Gemini/GPT/Claude/Qwen/Kimi 等），智能判断模型特性，一键配置 API Key。 自动备份配置，安全重启网关。 关键词：openclaw, model, switch, ai, multi-model, configuration, api

Model Switch 技能

用自然语言指令切换和添加 AI 模型。

功能

切换模型

• use <model> - 切换到指定模型
• 切换模型 - 进入交互式引导
• 当前模型 - 查看当前模型

新增模型（优化版）

• 新增模型 - 进入优化后的新增流程
• 智能判断模型特性
• 一键配置 API Key
• 自动保存配置

🚀 安装

bash

cd ~/.openclaw/workspace/skills
# 技能已安装在：~/.openclaw/workspace/skills/model-switch
chmod +x model-switch/scripts/*.py

就这么简单！所有脚本已包含，无需外部克隆。

---

📖 使用

bash

# 切换模型
python3 scripts/switch-model.py gemini

# 新增模型（优化版）
python3 scripts/add-model-guide.py

# 查看模型列表
python3 scripts/check-status.py

预置提供商

1. Google (Gemini)
2. OpenAI (GPT)
3. Anthropic (Claude)
4. Qwen (通义千问)
5. Moonshot (Kimi)
6. MiniMax
7. GLM (智谱)
8. DeepSeek
9. Custom Provider

优化特性

• ✅ 智能判断模型特性（图片/推理支持）
• ✅ 预置默认参数（contextWindow/maxTokens）
• ✅ 简化操作流程（一轮对话完成）
• ✅ 自动配置 API Key
• ✅ Endpoint compatibility 支持

---

🔒 安全说明

配置修改 ⚠️

本技能会修改 OpenClaw 配置文件：

读取：

• ~/.openclaw/openclaw.json - 主配置文件
• ~/.openclaw/workspace/skills/model-switch/config/models.json - 模型预设

写入：

• ~/.openclaw/openclaw.json - 更新模型配置和 API Key
• ~/.openclaw/openclaw.json.bak - 自动备份（切换前）

系统操作 ⚠️

本技能会执行系统命令：

• openclaw gateway restart - 重启网关（应用新配置）
• openclaw gateway status - 检查网关状态

影响：

• 重启期间服务短暂不可用（约 5-10 秒）
• 正在进行的会话可能中断

API 密钥存储 ⚠️

API Key 存储方式：

• 位置： ~/.openclaw/openclaw.json
• 格式： 明文存储（未加密）
• 权限： 取决于文件权限（建议 chmod 600）

安全建议：

1. 备份配置文件：cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
2. 设置文件权限：chmod 600 ~/.openclaw/openclaw.json
3. 不要将配置文件提交到 Git
4. 如需要更安全的存储，手动编辑 openclaw.json 并使用外部密钥管理

网络访问

• 脚本调用 OpenClaw CLI - 执行 openclaw gateway restart 会触发网络请求
• 网关重启后 - OpenClaw 会连接配置的模型 API（这是预期行为）
• 不直接联网 - 脚本本身不直接发送 HTTP 请求

数据安全

• 不上传： 不发送数据到外部服务器（除模型 API 调用外）
• 本地存储： 所有配置保存在本地

使用建议

1. 备份配置： 运行前备份 ~/.openclaw/openclaw.json
2. 测试环境： 先在测试环境验证
3. 检查配置： 新增模型后检查 openclaw.json 确认配置正确
4. 权限控制： 确保 openclaw.json 权限正确（chmod 600）

---

作者： @williamwg2025
版本： 1.0.1
许可证： MIT-0