裸机 JAR 运行——最轻量的部署方式

JAR 是最轻量的运行方式

如果你已经有 Java 17+ 环境、不想用 Docker、也不需要 Electron 桌面壳，直接跑 Spring Boot JAR 就好。适合已有 Spring 环境的运维团队。

前置条件

• Java 17 或更高版本（MateClaw 用了 Java 17 引入的语言特性）
• Maven 构建工具（如果从源码构建）
• 数据库三选一：H2（开发/测试）、PostgreSQL 16、MySQL 8

验证 Java 版本：java -version

两种方式获取 JAR

方式一：下载预编译 JAR

从 GitHub Releases 拿 mateclaw-server-x.y.z.jar。包含 Vue 前端的 build 产物，一个 JAR 同时跑后端 API 和前端页面。

方式二：从源码构建

克隆 mateclaw 仓库，分别构建前端和后端：

1. 前端 mateclaw-ui/：pnpm install && pnpm build，产物会被复制到后端 JAR 的 static/ 目录
2. 后端 mateclaw-server/：mvn spring-boot:run 或打包后 java -jar target/mateclaw-server.jar

默认端口 18088，访问 http://localhost:18088。

指定数据库 Profile

默认跑 H2 文件数据库（零配置）。生产换 PostgreSQL 或 MySQL 时，通过 Spring profile 切换——具体配置方式随版本变化，以官方最新版为准。

后端起不来怎么办

18088 端口被占了——加参数换端口：--server.port=19090。

H2 数据库锁错误（多见于桌面端/开发模式）——删掉 data/mateclaw.mv.db.lock，或者直接清空 data/ 目录重新开始。