back
loading skill details...
提供基于WebUI的快速AI模型切换工具,支持保存配置、一键切换、批量导入及API Key本地存储管理。
# OpenClaw Model Switcher(模型切换工具)
一个基于 WebUI 的 OpenClaw 模型切换工具,支持快速切换 AI 模型提供商。
## 功能特性
- **模型通讯录**:保存常用模型配置,方便重复使用
- **一键切换**:点击卡片快速切换当前使用模型
- **批量导入**:支持在线输入或 TXT 文件批量导入模型
- **API Key 记忆**:自动记住每个提供商的 API Key(本地浏览器 localStorage)
- **提供商筛选**:卡片太多时可按提供商筛选
- **内置预设**:阿里云、火山引擎、Kimi、DeepSeek、OpenAI、MiniMax 等
## 触发词
当用户提到以下内容时激活此技能:
- 「打开模型切换」「模型切换工具」「切换模型」
- 「切换到 xxx 模型」「换个模型」
- 「打开模型管理」「模型配置」
- 「切换 AI 模型」「换一个大模型」
## 使用方式
### 启动 WebUI(主要方式)
用户说「打开模型切换」后:
1. 启动后端服务(端口 9131)
2. 自动打开浏览器访问 http://127.0.0.1:9131
### 快速切换模型(对话式)
用户说「切换到 deepseek 模型」后,直接调用 OpenClaw 配置接口修改 `openclaw.json`。
## 技术架构
```
后端:Python FastAPI (端口 9131)
前端:Vue 3 + Element Plus (已构建为静态文件)
配置:~/.openclaw/openclaw.json
```
## API 接口
| 接口 | 方法 | 说明 |
|------|------|------|
| `GET /api/config` | GET | 获取当前配置和模型列表 |
| `POST /api/save` | POST | 保存模型到通讯录(不重启) |
| `POST /api/switch` | POST | 切换模型并重启服务 |
| `POST /api/gateway/control` | POST | 控制 Gateway(stop/start/restart) |
| `POST /api/delete` | POST | 删除模型或提供商 |
| `GET /api/providers` | GET | 获取所有提供商 |
## 安全设计
- API Key 仅保存在浏览器 localStorage(本地),不上传到任何服务器
- 后端只读写 openclaw.json(不含 API Key 的部分)
- API Key 同时写入 `~/.openclaw/agents/main/agent/auth-profiles.json` 供 OpenClaw 使用
## 依赖
- Python 3.10+
- fastapi, uvicorn, pydantic, psutil, pywin32
- Node.js(仅构建前端时需要,开发版已内置 dist)
## 文件结构
```
openclaw-model-switcher/
├── SKILL.md
├── scripts/
│ ├── start.ps1 # Windows 启动脚本
│ └── switch_model.py # 命令行快速切换
└── assets/
└── frontend/ # 已构建的前端静态文件
├── index.html
└── assets/
```
## 快速切换命令
无需启动 WebUI,直接用 Python 脚本切换模型:
```bash
# 切换模型
python switch_model.py --provider deepseek --model deepseek-chat
# 查看当前模型
python switch_model.py --status
# 重启 Gateway
python switch_model.py --restart
```
don't have the plugin yet? install it then click "run inline in claude" again.