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

作者：袖梨 2026-07-30

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

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

img_6a6af14b9e72430.webp

一、配置地狱

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

你想接个 DeepSeek，得：

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

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

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

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

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

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

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

img_6a6af14b9e72931.webp

二、工具简介

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. 本地模式：加载默认配置，修改自动保存

img_6a6af14b9e72c32.webp

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

img_6a6af14b9e72e33.webp

3.2 添加服务商

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

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

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

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

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

img_6a6af14b9e73034.webp

3.3 添加模型

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

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

img_6a6af14b9e73235.webp

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

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

3.4 切换模型

左侧「模型配置」区：

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

img_6a6af14b9e73436.webp

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

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

3.5 工具区

左侧底部三个按钮：

img_6a6af14b9e73737.webp

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

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

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

xattr -c /Applications/OpenClawSwitch.app

四、写在最后

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

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

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

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

相关文章

精彩推荐