ChatLab/docs/tw/usage/installation.md

outline

outline
deep

安裝 ChatLab

ChatLab 提供 Desktop、CLI 和 Docker 三種安裝方式。

Desktop

前往 ChatLab 官網 或 GitHub Releases 下載對應作業系統的安裝程式，執行安裝即可。

macOS Desktop 目前僅支援搭載 Apple 晶片（M 系列）的 Mac。Intel Mac 使用者可以改用下方的 CLI Web。

CLI

CLI 需要 Node.js 22.19 或更新版本：

npm install --global chatlab-cli

安裝完成後執行：

clb web             # 啟動 API + Web UI，並在瀏覽器中開啟
clb web --no-open   # 啟動 API + Web UI，但不自動開啟瀏覽器
clb web --headless  # 僅啟動 API，不提供 Web UI（供腳本 / AI Agent 呼叫）

常用選項：--port <連接埠>（預設 3110）、--host <位址>、--token <令牌>。

若要讓服務常駐後台，可以使用：

clb web --daemon  # 註冊為系統服務，登入時自動啟動（macOS / Linux）
clb status          # 查看常駐狀態
clb stop            # 停止並移除系統服務

::: tip 建議使用 clb。舊的 chatlab 指令仍會保留，以相容既有腳本與使用習慣。 :::

Docker

需要容器部署時，請查看 Docker 部署。如果希望日後與同一台電腦上的 Desktop 或本機 CLI 共用資料，請使用其中建議的主機目錄掛載方式。

安裝完成後，繼續閱讀 快速開始。