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。

技术架构#

text

后端：Python FastAPI (端口 9131)
前端：Vue 3 + Element Plus (已构建为静态文件)
配置：~/.openclaw/openclaw.json

API 接口#

接口方法说明GET /api/configGET获取当前配置和模型列表POST /api/savePOST保存模型到通讯录（不重启）POST /api/switchPOST切换模型并重启服务POST /api/gateway/controlPOST控制 Gateway（stop/start/restart）POST /api/deletePOST删除模型或提供商GET /api/providersGET获取所有提供商

安全设计#

• 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）

文件结构#

text

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