快速开始:安装与首次登录
产品先做演示?无需安装 Docker 与平台
如果只需在本地做出可点击、可切角色的产品前端(Mock 运行时),只需要 Git、Node 22 和 pnpm 10。直接克隆 kaiwu-web-starter 起步,见产品先做前端与纳管和无平台一句话起步。需要完整平台与后端联调时,继续按下方启动 Kaiwu。
推荐使用 AI 编码工具自动完成
如果你正在使用 Claude Code、Codex、Cursor 等支持本地终端的 AI 工具,可以直接复制 AI 开工提示词,让它自动检查环境、启动平台并引导你建仓。
1. 准备环境
本机需要安装:Git、Docker(含 Compose v2)、OpenSSL 和 curl。
2. 克隆并启动平台(以 v0.3.0 为例)
bash
git clone --branch v0.3.0 --depth 1 https://github.com/kaiwuzaidao/kaiwu.git
cd kaiwu
./kaiwu doctor
KAIWU_DB_TYPE=mysql ./kaiwu up使用 Gitee 可将仓库地址替换为
https://gitee.com/wujm12138/kaiwu.git。./kaiwu up会自动拉取运行仓、初始化本地 MySQL、执行迁移并启动平台。
常见环境补充说明(Colima / 源码构建 / 已有数据库)
- macOS Colima 用户:请将代码克隆在虚拟机可共享挂载的目录下(如
$HOME子目录)。 - 镜像与源码构建:发行版默认从 GHCR 拉取
amd64 / arm64镜像,拉取失败会自动回退到源码构建;也可追加--build强制从源码构建。 - 已有 MySQL 或达梦 DM8:如需连接外部数据库或启动第二套实例,见数据库与部署排错。
3. 登录与验证
启动完成后,浏览器打开 http://127.0.0.1:8000:
- 使用默认账号
admin和终端打印的随机初始密码登录(首次登录按提示修改密码)。 - 如果忘记初始密码,可在
kaiwu目录执行./kaiwu credentials重新查看(改密后请使用新密码)。 - 进入工作台后,可用以下命令快速核对服务健康状态:
bash
./kaiwu status
curl -fsS http://127.0.0.1:8088/actuator/health停止平台执行 ./kaiwu down;下次在同一目录运行 ./kaiwu up 会自动复用已有数据卷。
