ClawPanel 安装教程：Windows/macOS/Linux 与 Web 部署完整指南

ClawPanel这个工具是给AI Agent用的, 它采用了多引擎的技术模式, 同时也为用户提供了一个可视化的管理面板。

它并不是一个庞大的人工智能模型, 相反地, 它是把包括 OpenClaw、Hermes Agent、DeepSeek Harness（RC）、OpenCode 以及实验版的 Pi 在内的这些能够跑的引擎, 全都放到到一个界面里面去了。

这么做呢, 是为了能够对引擎运行的状态、用来接模型的渠道、消息走的那些通道、还有那些智能代理也就是 Agents, 以及记录下来的日志, 进行统一的管理动作。这篇文章主要介绍如何完成桌面版安装这一步骤, 同时也涵盖了Linux Web部署的具体操作, 此外还说明了如何进行首次启动以及引擎配置。

一、ClawPanel 是什么

ClawPanel 这个面板的用途, 它是针对于 AI Agent 这种运行时候期的图形化管理工具。在桌面端这里, 它主要是基于 Tauri 来进行搭建的, 所以说它能提供 Windows、macOS、Linux 这些系统的电脑客户端。

同时, 它也支持把你直接部署到 Linux 服务器上面去, 然后通过那种叫浏览器的程序来访问它的 Web 界面。

它现在所负责管理的那种引擎, 种类一共有五种, 它们的具体名单是:

二、安装前准备

• 关于桌面端系统, 需要支持的是Windows 10 64位版本, 或者macOS 12 Monterey及比这个更高一点的系统版本, 另外还有Ubuntu 20.04或者更高的版本, Debian 11以及更高的这些Linux发行板也可以使用。
• Web版:指的是需要有一台 Linux 服务器, 还需要配备一个现代的浏览器；在服务器端的部分, 建议最好是准备好 Node.js 24.16.0+ 这个版本的 24.x 版本，同时还要准备好 npm。
• 模型服务:, ClawPanel 这个系统并不会直接提供模型本身, 所以用户必须要去准备一个目标引擎能够使用的东西, 这个东西需要包含 API Key, 还要有 Base URL, 同时还要准备好模型 ID。
• 下载渠道：认准 claw.qt.cool/download 或 GitHub 仓库，不要从第三方网盘下载。

三、桌面版安装

Windows

1. 请先进入指定的网页, 然后找到相关内容的下载界面, 接下来开始下载该程序的运行所需的基本文件包。

在官方提供下载的那个页面上, 选择针对 Microsoft Windows 操作系统所设计的版本内容, 然后执行下载操作, 以获取扩展名标识为 .exe 的可执行程序文件, 或者扩展名标识为 .msi 的安装包文件。

1. 运行安装程序

按照系统给出的提示一步一步去完成软件的安装过程。

如果在操作过程中出现了 SmartScreen 这个程序的提醒信息, 需要先认真检查一下正在安装的文件是不是确实来自于官方网站发布的版本, 并且要确保当前文件的版本号是匹配的, 在确认了这些信息无误之后, 再根据自己的判断来决定是否要继续执行接下来的步骤。

1. 先进行启动, 让 ClawPanel 能够开始运行。

你需要从那个叫做开始菜单的地方, 或者是桌面快捷方式中打开它, 然后把首次运行设置给完成掉。

macOS

下载这个后缀是强代码dmg的文件, 打开后找到ClawPanel并且把它拖拽进系统里的应用程序文件夹去。

要是电脑屏幕上出现了提示说没法验证开发者是哪个人的, 那么就进到系统设置这个区域里面去寻找隐私和安全性这一项选项, 在里面允许打开那个程序。假设安装文件的来源确实是可靠的, 但是应用还是处于被隔离的状态不能正常运行, 可以执行以下这个操作:

sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Linux 桌面

用户需要依据当前使用的发行版来做出选择, 选择的对象包括 AppImage、deb 以及 rpm, 接下来针对 deb 的安装流程, 具体内容如下:

sudo dpkg -i ClawPanel_*_amd64.deb

rpm 安装：

sudo rpm -i ClawPanel-*-1.x86_64.rpm

先给AppImage版本加上执行权限, 然后再去运行它。

chmod +x ClawPanel_*_amd64.AppImage
./ClawPanel_*_amd64.AppImage

四、Linux Web 版部署

假如大家是想要把 ClawPanel 这个玩意儿给放到服务器上去进行运行, 并且打算通过浏览器来进行管理操作的话, 那么是可以去使用官方提供的那个一键部署脚本的。

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

部署工作完成之后, 使用浏览器去访问http://服务器IP:1420这个地址。在这里需要注意的是, 数字1420是ClawPanelWeb软件默认的端口好。

手动部署

首先, 得先把Node.js的版本确定到24.x这一点上把, 然后才能去克隆那个仓库, 并且在进行构建的操作。

cd /opt
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install
npm run build
npm run serve -- --port 1420

在生产环境里, 我们建议使用systemd来运行守护进程, 同时还要利用Nginx反向代理这个工具去配置HTTPS加密传输。需要特别注意的一点是, ClawPanel Web这个软件默认的情况之下是要去监听网络接口的, 所以绝对不能把1420这个裸端口直接裸露着连接到公网上去进行访问。

五、首次启动与引擎配置

1. 完成首次设置

你第一次打开 Clapanel 这个软件的时候, 请按照界面上的引导步骤, 把初始设置给完成掉, 这样就可以进入到主界面中了。

1. 进行这个操作的时候, 你需要从可用的选项里面, 做出一个决定, 就是选定你要用哪一个作为核心的目标引擎。

你可以在侧栏位置选择像是 OpenClaw 以及 Hermes Agent 这些引擎, 然后进入到它们对应的页面里面去, 接着就在那里安装好运行时的环境, 或者直接建立起连接的关联。

1. 安装 OpenClaw（可选）

官方文档给出的基线命令是：npm install -g openclaw@2026.9.8 --registry https://registry.npmmirror.com，安装后用 openclaw --version 检查。当那个镜像没有办法使用的时候, 你可以把配置切换回官方的npm源去用。

1. 配置模型渠道

第一步是先把页面点开, 具体做法就是进入那个叫通用设置的地方, 然后找到模型渠道这一项, 紧接着你要去把服务商的名字填上去, 还有那个Base URL也要写上, 别忘了把API Key也填完整, 最后再把模型ID给输进去, 等所有内容都搞定了, 再点击保存按钮把这个设定给存下来。

1. 先把东西同步好, 然后再把各种情况都测试一遍。

回到目标引擎页面，点击同步按钮, 让引擎去读取模型配置信息, 然后打开聊天页面或者工作台, 发送测试消息。

六、常见问题排查

七、安全建议

• 只在受信任的网络中运行 ClawPanel，给面板设置强密码。
• Web 服务会利用独立用户以及 systemd 守护进程, 来对配置目录进行定期备份这一件事情。
• 大家千万不要把那啥的api_key放到那些公开的项目里面去, 也不要发表在各种文章里了, 更不要直接截那种有它的图给外人看。
• 在升级环节里面, 大家要把完整的 Web 包给用上。这个举动就是用来把前端、Node 后端以及 WebSocket 代理这些全部进行替换的。这么做的目的是为了去避免一种情况发生, 也就是说, 千万不要只把 dist/目录下的东西进行了替换, 因为要是那样做的话, 很容易就会导致版本混用的现象出现, 所以要避免这种错误操作。
• 在开放公网访问之前, 需要先做一个端口扫描的操作, 并且还需要检查访问控制是否设置得当；而在使用那些来自第三方的脚本之前, 应当先仔细阅读并理解其中的具体内容。

八、常见问题

完成检查清单

• ClawPanel 已安装并能启动
• 用户能够通过网页来访问端口号为1420的那个地址, 或者也能够通过反向代理的地址来进行连接和访问操作。
• 可以确认的是, 目标引擎中的至少有一个已经被成功安装完毕。
• 模型渠道这一部分的情况已经得到了保存, 而且同时也被同步。
• 已经发送了测试消息, 目的是来验证一下连通的情况。
• 已经进行了访问密码的设定操作, 同时还完成了网络限制方面的设置工作。

官方入口