安装 ChatLab

ChatLab 提供 Desktop、CLI 和 Docker 三种安装方式。

Desktop

前往 ChatLab 官网 或 GitHub Releases 下载对应操作系统的安装包，双击安装即可。

CLI

CLI 需要 Node.js 20 或更高版本：

npm install --global chatlab-cli

安装后运行：

chatlab start             # 启动 API + Web UI，并在浏览器中打开
chatlab start --no-open   # 启动 API + Web UI，但不自动打开浏览器
chatlab start --headless  # 仅启动 API，不提供 Web UI（供脚本 / AI Agent 调用）

常用选项：--port <端口>（默认 3110）、--host <地址>、--token <令牌>。

如果希望服务常驻后台，可以使用：

chatlab start --daemon  # 注册为系统服务，开机自启（macOS / Linux）
chatlab status          # 查看常驻状态
chatlab stop            # 停止并取消常驻

TIP

clb 是 chatlab 的简写，两者完全等价。

Docker

需要容器部署时，请查看 Docker 部署。如果希望以后与同一台电脑上的 Desktop 或本地 CLI 共用数据，请使用其中推荐的宿主机目录挂载方式。

安装完成后，继续阅读 快速开始。