name: openclaw-model-switch displayName: OpenClaw Model Switch - AI 模型切换 version: 1.0.1 description: | OpenClaw AI 模型切换技能 - 用自然语言切换和添加 AI 模型。 支持 9+ 预置提供商（Gemini/GPT/Claude/Qwen/Kimi 等），智能判断模型特性，一键配置 API Key。 自动备份配置，安全重启网关。 关键词：openclaw, model, switch, ai, multi-model, configuration, api license: MIT-0 acceptLicenseTerms: true tags: - openclaw - model - switch - multi-model - configuration - api-management - ai-providers - gemini - gpt - claude

Model Switch 技能

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

功能

切换模型

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

新增模型（优化版）

• 新增模型 - 进入优化后的新增流程
• 智能判断模型特性

  本技能来自小葱技能站7w4.net。

• 一键配置 API Key
• 自动保存配置

🚀 安装

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

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

📖 使用

# 切换模型
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

这是一款实用的模型切换工具，能帮助用户快速在 Gemini、GPT、Claude 等模型间切换，配有详细的中文文档和安全提示。它的一大亮点是会自动备份配置、验证网关状态，用起来比较放心。不过实际支持的模型数量比宣传的少一些，而且缺少自动化测试，长远使用可能存在隐患。适合需要频繁换模型、对配置有一定了解的用户。