OpenClawSwitch：基于 Tauri+Vue3 的 OpenClaw 模型配置工具实战解析

本文围绕OpenClawSwitch：基于 Tauri+Vue3 的 OpenClaw 模型配置工具实战解析展开，先梳理核心概念，再结合实践场景说明步骤、代码思路和容易忽略的细节，方便后续直接参考。

OpenClawSwitch 是一个基于 Tauri 和 Vue3 开发的开源项目，旨在为 OpenClaw 模型提供一个直观易用的配置工具。OpenClaw 是一个开源的机器人控制系统，通常用于教育和研究领域，特别是在机器人和自动化技术中。这个工具可以帮助用户轻松地配置和测试他们的 OpenClaw 模型，从而提高开发效率并简化配置过程。

一、配置地狱

OpenClaw 很好玩，但接入自定义模型时，配置文件能改到你怀疑人生。

你想接个 DeepSeek，得：

1. 先找到 ~/.openclaw/openclaw.json
2. 手写 JSON 配置 baseUrl、apiKey、models 列表
3. 保存后重启网关
4. 报错了？检查逗号、括号、引号……

想换个模型试试？重复一遍。

想加个备用模型？继续手撸 JSON。

OpenClaw 的内置服务商（OpenAI、Anthropic）用着很方便，但国内用户常用的 DeepSeek、硅基流动、通义千问这些，都得在 models.providers 里自己配。

虽然 WebUI 也有模型配置，但是那个交互体验我宁愿改 JSON 配置文件。

我懂代码的配起来都麻烦，别说很多想体验 OpenClaw 的小白用户了。

我实在不想每次都手写 JSON，于是加班（违背了咱们不加班的宗旨）写了个小工具。

二、工具简介

OpenClawSwitch 是一个配置文件可视化编辑器，目前的核心功能：

把 openclaw.json 的编辑变成点选操作。

1. 添加服务商：填名称、URL、Key，点一下
2. 添加模型：输入 ID 或从 API 获取，选一下
3. 切换模型：下拉菜单选择，秒切
4. 备用模型：点「添加备用」，多选

技术栈：Tauri + Rust + Vue 3，打包后 3-5MB。

开源地址：https://github.com/RongleCat/OpenClawSwitch

后续会围绕 OpenClaw 便捷使用的放心加入更多功能。

三、怎么用

3.1 启动

下载安装运行，自动加载 ~/.openclaw/openclaw.json。

顶部显示当前文件路径和模式（本地/远程）：

1. 本地模式：加载默认配置，修改自动保存

1. 远程模式：加载你选的文件，手动保存，适用于云端部署的朋友，下载修改完以后再上传回服务器覆盖。

3.2 添加服务商

点击「添加」，填三个字段：

服务商名称：服务商名称，比如 deepseek

Base URL：API 地址，填服务商提供的请求地址，带不带 /v1 要看服务商文档

API Key：请求凭证，在服务商处获取

国内用户福音：DeepSeek、硅基流动、英伟达的基本信息支持一键填充，只需要填上 API Key 即可。

3.3 添加模型

服务商卡片里点「+」，两种方式：

1. 手动输入：deepseek-chat、Qwen/Qwen2.5-72B-Instruct，在模型列表加载失败且你确定有这个模型的时候可以直接填写模型 ID。

2. API 获取：配了 Key 就能从服务商拉取模型列表，支持搜索

提示：模型 ID 不用加前缀。填 Qwen/Qwen2.5-72B-Instruct，系统自动组合成 siliconflow/Qwen/Qwen2.5-72B-Instruct。

3.4 切换模型

左侧「模型配置」区：

1. 主要模型：下拉选择，如 deepseek/deepseek-chat

1. 备用模型：点「添加备用」，主模型挂了自动切 (经过测试能切换模型进行对话，但是消息输出异常，感觉是 OpenClaw 的问题)

主模型切换以后是直接生效的，可以通过给 OpenClaw 发送 /new 命令新建会话以后在新的会话里询问 OpenClaw 现在使用的是什么模型，如果觉得不放心可以使用下面的重启网关功能。

3.5 工具区

左侧底部三个按钮：

1. 重启网关：后台执行网关重启命令。
2. 打开 TUI：自动打开终端进入 OpenClaw TUI 模式，可以直接与 OpenClaw 对话交互。
3. Minimax 国服修复：一键切到国内地址。

3.6 ⚠️macOS/苹果电脑用户注意

软件安装完打开以后会提示应用损坏，在终端执行下面的代码，再尝试打开应用：

xattr -c /Applications/OpenClawSwitch.app

四、写在最后

这个工具已经开源，希望能帮大家降低 OpenClaw 的入门门槛。

技术不复杂，但解决了我自己的痛点，如果对你也有用，那就更好了。

可以直接去 GitHub：https://github.com/RongleCat/OpenClawSwitch

实际使用时，建议结合项目规模、依赖环境和团队习惯做取舍；先保证流程清晰和结果可验证，再逐步优化细节。