【开源】🦞 OpenClaw 配套工具第二弹 ClawPanel：一键部署可视化桌面管理面板，支持 LinuxDocker 网页管理，内置 AI 助手自动处理环境与安装
- 内容介绍
- 文章标签
- 相关推荐
各位佬友好，之前发过 ClawApp 手机聊天客户端 和 OpenClaw 中文汉化版部署教程，感谢大家的支持
ClawApp 解决了手机端聊天的问题，但用了一段时间发现日常管理 OpenClaw 还是很痛苦——改个模型虽然可以后台操作，但比较麻烦——要手动编辑 ~/.openclaw/openclaw.json，记住 JSON 结构往里填，改完还得确认运行时配置也同步了。看日志要 tail -f，重启服务要敲命令，换个 API Key 又得翻配置文件。来回折腾几次就烦了
所以又搞了一个桌面管理面板——ClawPanel，这些操作全做成 GUI，点点鼠标就行
项目地址：GitHub - qingchencloud/clawpanel: 🦀 OpenClaw 可视化管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装配置，跨平台桌面应用 | Built-in AI Assistant with tool calling & image recognition · GitHub
ClawPanel 是什么
一句话：给 OpenClaw 套一个桌面管理面板，不用再手动改 JSON 了
架构也很简单：
ClawPanel 桌面应用（Tauri v2）
├── 前端 UI（Vanilla JS + Vite）
│ ↓ Tauri IPC
├── Rust 后端（读写配置文件、执行系统命令）
│ ↓ 直接操作
├── ~/.openclaw/openclaw.json（全局配置）
│ ↓ 同步
└── ~/.openclaw/agents/*/models.json（运行时配置）
↕ WebSocket
OpenClaw Gateway（端口 18789）
跟 ClawApp 不一样，ClawPanel 不是代理转发，而是直接在本地读写 OpenClaw 的配置文件 + 通过 WebSocket 跟 Gateway 通信。所以它必须装在跑 OpenClaw 的那台机器上
技术栈
跟 ClawApp 一样没用 React/Vue，前端纯原生 JS + Vite，后端 Rust + Tauri v2。选 Tauri 不选 Electron 就一个原因：小。Windows 安装包不到 10MB，Electron 随便就 100MB+。内存占用也低，Rust + 系统自带 WebView，不用额外带一个 Chromium
功能
前前后后做了 12 个页面，挨个说
AI助手
fe60bcf6578e5f77f6fdfc5b0fd8ea6e1995×1363 239 KB
安装使用过程中，碰到问题， 可以直接问内置的AI助手！
仪表盘
011925×1225 178 KB
打开就是仪表盘，Gateway 跑没跑、系统信息、快捷操作都在这。状态变了会自动刷新
模型配置
image1650×1050 259 KB
用得最多的一个页面。OpenAI / DeepSeek / Anthropic / Kimi 这些渠道都支持：
- 多渠道管理，每个渠道单独配 API Key 和 Base URL
- 一键批量测试所有模型的连通性和延迟
- 拖拽调整模型优先级
- 主模型 + 备选，主的挂了自动切备选
- 删除渠道或模型后自动切换主模型，不会把服务搞崩（v0.4.0 踩过的坑）
实时聊天
021923×1223 296 KB
WebSocket 直连本地 Gateway，流式输出，支持 Markdown 和代码高亮。可以同时开多个会话跟不同 Agent 聊
v0.4.0 加了响应耗时显示，比如 20:09 · 1.7s，切模型的时候看看哪个快
服务管理
031923×1223 167 KB
OpenClaw 启停、版本检测、升级、配置备份还原。Gateway 意外挂了会自动拉起来（最多 3 次，60 秒冷却），不用盯着
Agent 管理 + 记忆管理
061923×1223 119 KB
081923×1223 184 KB
多 Agent 管理，每个 Agent 的身份、指令、模型都能单独调。记忆文件也能直接编辑，或者 ZIP 打包导下来
更多截图
041923×1223 285 KB
071923×1223 168 KB
091923×1223 144 KB
101923×1223 136 KB
下载安装
去 GitHub Releases 下载，三个系统都有：
| 系统 | 安装包 | 说明 |
|---|---|---|
| macOS (Apple Silicon) | ClawPanel_x.x.x_aarch64.dmg |
M1/M2/M3/M4 |
| macOS (Intel) | ClawPanel_x.x.x_x64.dmg |
2020 年及之前的 Mac |
| Windows | ClawPanel_x.x.x_x64-setup.exe |
双击安装 |
| Linux | ClawPanel_x.x.x_amd64.AppImage |
chmod +x 直接跑 |
| Linux | ClawPanel_x.x.x_amd64.deb |
sudo dpkg -i 安装 |
有需要补充的平台，可以留言或者提issue，我也在考虑制作集群管理功能，时间仓促，后续再完善吧，配合docker搞集群应该挺好玩的，但是他这个内置的agent模块，好像也可以顶一下，具体的需求大家可以讨论讨论，我后面再研究
macOS 首次打开会被拦截（没买 $99/年的苹果签名），终端跑一下就行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app
装好打开，如果你还没装过 OpenClaw，不用去命令行折腾——ClawPanel 有个完整的安装引导：
- 自动检测 Node.js 环境（没装的话给你下载链接）
- 选择安装版本——汉化优化版或者官方原版，点一下就行
- 可以选 npm 镜像源（淘宝/华为/官方），国内用淘宝镜像快很多
- CLI 装完自动装 Gateway 服务
- 全部完成自动跳转仪表盘
还支持汉化版和官方版一键互切、版本检测、一键升级，都在「服务管理」页面里
配置模型
装好之后进「模型配置」页面：
- 添加你的 API 渠道（填渠道名、Base URL、API Key）
- 在渠道下添加具体模型
- 点「测试」确认能通
- 设置主模型，保存
保存后自动同步到 Gateway 运行时，不用手动重启。然后去「聊天」页面就能跟你的 Agent 对话了
一些踩过的坑
写这个东西的时候踩了不少坑，捡几个印象深的说说
1. OpenClaw 的双配置文件问题
这个坑卡了很久。OpenClaw 有两套模型配置：openclaw.json（全局配置）和 models.json（Agent 运行时注册表）。ClawPanel 改的是 openclaw.json，但 Gateway 实际发请求用的是 models.json。如果只改了前者没同步后者，就会出现"面板上测试没问题但实际聊天 401"的鬼畜情况
v0.4.0 在 Rust 后端加了 sync_providers_to_agent_models 函数，每次保存配置都把 openclaw.json 的 provider 信息同步过去，包括新增、修改、删除。删除渠道的时候还得把 models.json 里对应的 provider 和 model 条目都清掉，不然残留的旧配置会导致 Gateway 崩溃
2. Tauri WebView 里的拖拽排序
原来用 HTML5 Drag and Drop API 做模型拖拽排序，在浏览器里好好的，到 Tauri 的 WebView2（Windows）和 WKWebView（macOS）里就各种抽风——dragover 事件不触发、drop 位置偏移、有时候整个拖拽直接没反应
最后全部改用 Pointer Events 重写，pointerdown 记录起点，pointermove 算偏移量手动移动 DOM，pointerup 结算位置。代码多写了不少但至少三个平台表现一致了
3. 删除模型导致 Gateway 崩溃
在面板上删掉某个模型渠道之后，如果当前主模型恰好属于那个渠道，Gateway 重启时找不到主模型就直接挂了。修复方式是在前端加了 ensureValidPrimary 函数——每次删除操作后检查主模型是否还存在，不存在就自动切到第一个可用的
v0.4.0 更新
刚发的版本，主要修的都是实际用着碰到的问题：
- Gateway 进程守护 — 挂了自动拉起来，最多 3 次，60 秒冷却期。主动停止不干预
- 配置自愈 — JSON 坏了自动从
.bak恢复，UTF-8 BOM 自动剥离 - 双配置同步 — 改配置自动同步
openclaw.json→models.json，不用手动openclaw config apply - 流式超时 — 90 秒没新数据自动断开，不会卡在"正在输出…"不动
- 响应耗时显示 — 每条 AI 回复后面显示耗时，跨天消息显示日期
项目信息
- GitHub：GitHub - qingchencloud/clawpanel: 🦀 OpenClaw 可视化管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装配置，跨平台桌面应用 | Built-in AI Assistant with tool calling & image recognition · GitHub
- 产品主页：https://claw.qt.cool/
- 协议：MIT
- 技术栈：Rust + Tauri v2 + Vanilla JS + Vite
- 前置依赖：需要先跑 OpenClaw Gateway（还没装的佬友看 中文汉化版部署教程）
- 配套项目：ClawApp 手机聊天客户端 / cftunnel 内网穿透
项目刚发布不久，可能还有不少问题没发现，用着遇到 bug 或者觉得哪里不好用直接 提 Issue 就行，我会尽快处理。会写代码的佬友也欢迎提 PR
纯开源项目，MIT 协议，没有任何商业目的，和 中文汉化版 搭配使用体验最佳，希望对佬友们有帮助
网友解答：--【壹】--：
大佬厉害~
--【贰】--：
解决痛点，必须尝试下，支持大佬
--【叁】--：
必须给个Star
--【肆】--：
大佬！！！
--【伍】--：
给佬点赞
--【陆】--：
太强啦佬。
--【柒】--：
插个眼，明天试试
--【捌】--：
这种挺好
--【玖】--：
好东西啊，我明天来试试看
--【拾】--：
太强了~
--【拾壹】--：
太强了，大佬
--【拾贰】--：
太强了佬，立即体验一下看看
--【拾叁】--：
就缺这种了，每天都在手动改配置和我的缠斗
--【拾肆】--：
学习ing
--【拾伍】--：
大佬，tql
--【拾陆】--：
佬友太强了，那是不是可以直接用这个开始openclaw
--【拾柒】--：
感觉很厉害，先收藏了
--【拾捌】--：
想请教下大佬，看说明这个必须装在带龙虾的机器上，那这台机器是不是得有GUI桌面？我这龙虾是装在Linux server无桌面环境的，这可咋整啊，求大佬更新适配！
--【拾玖】--：
太强大了
各位佬友好，之前发过 ClawApp 手机聊天客户端 和 OpenClaw 中文汉化版部署教程，感谢大家的支持
ClawApp 解决了手机端聊天的问题，但用了一段时间发现日常管理 OpenClaw 还是很痛苦——改个模型虽然可以后台操作，但比较麻烦——要手动编辑 ~/.openclaw/openclaw.json，记住 JSON 结构往里填，改完还得确认运行时配置也同步了。看日志要 tail -f，重启服务要敲命令，换个 API Key 又得翻配置文件。来回折腾几次就烦了
所以又搞了一个桌面管理面板——ClawPanel，这些操作全做成 GUI，点点鼠标就行
项目地址：GitHub - qingchencloud/clawpanel: 🦀 OpenClaw 可视化管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装配置，跨平台桌面应用 | Built-in AI Assistant with tool calling & image recognition · GitHub
ClawPanel 是什么
一句话：给 OpenClaw 套一个桌面管理面板，不用再手动改 JSON 了
架构也很简单：
ClawPanel 桌面应用（Tauri v2）
├── 前端 UI（Vanilla JS + Vite）
│ ↓ Tauri IPC
├── Rust 后端（读写配置文件、执行系统命令）
│ ↓ 直接操作
├── ~/.openclaw/openclaw.json（全局配置）
│ ↓ 同步
└── ~/.openclaw/agents/*/models.json（运行时配置）
↕ WebSocket
OpenClaw Gateway（端口 18789）
跟 ClawApp 不一样，ClawPanel 不是代理转发，而是直接在本地读写 OpenClaw 的配置文件 + 通过 WebSocket 跟 Gateway 通信。所以它必须装在跑 OpenClaw 的那台机器上
技术栈
跟 ClawApp 一样没用 React/Vue，前端纯原生 JS + Vite，后端 Rust + Tauri v2。选 Tauri 不选 Electron 就一个原因：小。Windows 安装包不到 10MB，Electron 随便就 100MB+。内存占用也低，Rust + 系统自带 WebView，不用额外带一个 Chromium
功能
前前后后做了 12 个页面，挨个说
AI助手
fe60bcf6578e5f77f6fdfc5b0fd8ea6e1995×1363 239 KB
安装使用过程中，碰到问题， 可以直接问内置的AI助手！
仪表盘
011925×1225 178 KB
打开就是仪表盘，Gateway 跑没跑、系统信息、快捷操作都在这。状态变了会自动刷新
模型配置
image1650×1050 259 KB
用得最多的一个页面。OpenAI / DeepSeek / Anthropic / Kimi 这些渠道都支持：
- 多渠道管理，每个渠道单独配 API Key 和 Base URL
- 一键批量测试所有模型的连通性和延迟
- 拖拽调整模型优先级
- 主模型 + 备选，主的挂了自动切备选
- 删除渠道或模型后自动切换主模型，不会把服务搞崩（v0.4.0 踩过的坑）
实时聊天
021923×1223 296 KB
WebSocket 直连本地 Gateway，流式输出，支持 Markdown 和代码高亮。可以同时开多个会话跟不同 Agent 聊
v0.4.0 加了响应耗时显示，比如 20:09 · 1.7s，切模型的时候看看哪个快
服务管理
031923×1223 167 KB
OpenClaw 启停、版本检测、升级、配置备份还原。Gateway 意外挂了会自动拉起来（最多 3 次，60 秒冷却），不用盯着
Agent 管理 + 记忆管理
061923×1223 119 KB
081923×1223 184 KB
多 Agent 管理，每个 Agent 的身份、指令、模型都能单独调。记忆文件也能直接编辑，或者 ZIP 打包导下来
更多截图
041923×1223 285 KB
071923×1223 168 KB
091923×1223 144 KB
101923×1223 136 KB
下载安装
去 GitHub Releases 下载，三个系统都有：
| 系统 | 安装包 | 说明 |
|---|---|---|
| macOS (Apple Silicon) | ClawPanel_x.x.x_aarch64.dmg |
M1/M2/M3/M4 |
| macOS (Intel) | ClawPanel_x.x.x_x64.dmg |
2020 年及之前的 Mac |
| Windows | ClawPanel_x.x.x_x64-setup.exe |
双击安装 |
| Linux | ClawPanel_x.x.x_amd64.AppImage |
chmod +x 直接跑 |
| Linux | ClawPanel_x.x.x_amd64.deb |
sudo dpkg -i 安装 |
有需要补充的平台，可以留言或者提issue，我也在考虑制作集群管理功能，时间仓促，后续再完善吧，配合docker搞集群应该挺好玩的，但是他这个内置的agent模块，好像也可以顶一下，具体的需求大家可以讨论讨论，我后面再研究
macOS 首次打开会被拦截（没买 $99/年的苹果签名），终端跑一下就行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app
装好打开，如果你还没装过 OpenClaw，不用去命令行折腾——ClawPanel 有个完整的安装引导：
- 自动检测 Node.js 环境（没装的话给你下载链接）
- 选择安装版本——汉化优化版或者官方原版，点一下就行
- 可以选 npm 镜像源（淘宝/华为/官方），国内用淘宝镜像快很多
- CLI 装完自动装 Gateway 服务
- 全部完成自动跳转仪表盘
还支持汉化版和官方版一键互切、版本检测、一键升级，都在「服务管理」页面里
配置模型
装好之后进「模型配置」页面：
- 添加你的 API 渠道（填渠道名、Base URL、API Key）
- 在渠道下添加具体模型
- 点「测试」确认能通
- 设置主模型，保存
保存后自动同步到 Gateway 运行时，不用手动重启。然后去「聊天」页面就能跟你的 Agent 对话了
一些踩过的坑
写这个东西的时候踩了不少坑，捡几个印象深的说说
1. OpenClaw 的双配置文件问题
这个坑卡了很久。OpenClaw 有两套模型配置：openclaw.json（全局配置）和 models.json（Agent 运行时注册表）。ClawPanel 改的是 openclaw.json，但 Gateway 实际发请求用的是 models.json。如果只改了前者没同步后者，就会出现"面板上测试没问题但实际聊天 401"的鬼畜情况
v0.4.0 在 Rust 后端加了 sync_providers_to_agent_models 函数，每次保存配置都把 openclaw.json 的 provider 信息同步过去，包括新增、修改、删除。删除渠道的时候还得把 models.json 里对应的 provider 和 model 条目都清掉，不然残留的旧配置会导致 Gateway 崩溃
2. Tauri WebView 里的拖拽排序
原来用 HTML5 Drag and Drop API 做模型拖拽排序，在浏览器里好好的，到 Tauri 的 WebView2（Windows）和 WKWebView（macOS）里就各种抽风——dragover 事件不触发、drop 位置偏移、有时候整个拖拽直接没反应
最后全部改用 Pointer Events 重写，pointerdown 记录起点，pointermove 算偏移量手动移动 DOM，pointerup 结算位置。代码多写了不少但至少三个平台表现一致了
3. 删除模型导致 Gateway 崩溃
在面板上删掉某个模型渠道之后，如果当前主模型恰好属于那个渠道，Gateway 重启时找不到主模型就直接挂了。修复方式是在前端加了 ensureValidPrimary 函数——每次删除操作后检查主模型是否还存在，不存在就自动切到第一个可用的
v0.4.0 更新
刚发的版本，主要修的都是实际用着碰到的问题：
- Gateway 进程守护 — 挂了自动拉起来，最多 3 次，60 秒冷却期。主动停止不干预
- 配置自愈 — JSON 坏了自动从
.bak恢复，UTF-8 BOM 自动剥离 - 双配置同步 — 改配置自动同步
openclaw.json→models.json，不用手动openclaw config apply - 流式超时 — 90 秒没新数据自动断开，不会卡在"正在输出…"不动
- 响应耗时显示 — 每条 AI 回复后面显示耗时，跨天消息显示日期
项目信息
- GitHub：GitHub - qingchencloud/clawpanel: 🦀 OpenClaw 可视化管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装配置，跨平台桌面应用 | Built-in AI Assistant with tool calling & image recognition · GitHub
- 产品主页：https://claw.qt.cool/
- 协议：MIT
- 技术栈：Rust + Tauri v2 + Vanilla JS + Vite
- 前置依赖：需要先跑 OpenClaw Gateway（还没装的佬友看 中文汉化版部署教程）
- 配套项目：ClawApp 手机聊天客户端 / cftunnel 内网穿透
项目刚发布不久，可能还有不少问题没发现，用着遇到 bug 或者觉得哪里不好用直接 提 Issue 就行，我会尽快处理。会写代码的佬友也欢迎提 PR
纯开源项目，MIT 协议，没有任何商业目的，和 中文汉化版 搭配使用体验最佳，希望对佬友们有帮助
网友解答：--【壹】--：
大佬厉害~
--【贰】--：
解决痛点，必须尝试下，支持大佬
--【叁】--：
必须给个Star
--【肆】--：
大佬！！！
--【伍】--：
给佬点赞
--【陆】--：
太强啦佬。
--【柒】--：
插个眼，明天试试
--【捌】--：
这种挺好
--【玖】--：
好东西啊，我明天来试试看
--【拾】--：
太强了~
--【拾壹】--：
太强了，大佬
--【拾贰】--：
太强了佬，立即体验一下看看
--【拾叁】--：
就缺这种了，每天都在手动改配置和我的缠斗
--【拾肆】--：
学习ing
--【拾伍】--：
大佬，tql
--【拾陆】--：
佬友太强了，那是不是可以直接用这个开始openclaw
--【拾柒】--：
感觉很厉害，先收藏了
--【拾捌】--：
想请教下大佬，看说明这个必须装在带龙虾的机器上，那这台机器是不是得有GUI桌面？我这龙虾是装在Linux server无桌面环境的，这可咋整啊，求大佬更新适配！
--【拾玖】--：
太强大了