以上內容由 AI 根據官方 README 整理，未經實測；指令以官方文件為準。
A local-first desktop workspace for persistent AI teammates. Run Codex, Claude, and Grok with dedicated workspaces, task queues, file sharing, browser control, and agent-to-agent collaboration.
macOS：從 GitHub Releases 下載對應 arm64 或 x64 的 dmg，拖進 Applications 後開啟
Windows：從 GitHub Releases 下載 x64 的 exe 安裝檔並執行
Linux：從 GitHub Releases 下載 AppImage 後加上執行權限，再直接執行
chmod +x OpenBot-*.AppImageUbuntu 23.10 以上與 Debian 13 需安裝 AppArmor profile
sudo install -m 0644 build/linux/openbot.apparmor /etc/apparmor.d/openbot重新載入 AppArmor 讓 profile 生效
sudo systemctl reload apparmor無螢幕的 Ubuntu 伺服器：用安裝腳本裝成常駐服務
curl -fsSL https://raw.githubusercontent.com/nightly-labs/openbot/main/scripts/install-server.sh | sudo bash伺服器安裝後用 email 驗證碼登入
sudo openbot loginNix：直接從 flake 執行，或改用 nix profile install 安裝
nix run github:nightly-labs/openbotdocker compose up -d桌面版從 Releases 下載安裝檔即可，首次啟動要同意 agent 全權限警告，並在 onboarding 選擇或下載 Codex、Claude、Grok 等 provider CLI。自架伺服器需先登入帳號；遠端 Signal 服務則要備妥 remote/.env 內的網域、TLS 與 TURN 密鑰。
| 變數 | 用途 | 必填 | 範例／預設值 |
|---|---|---|---|
XAI_API_KEY | 啟動 OpenBot 的環境需帶此金鑰，Grok 才能通過 xAI 認證 | 否 | — |
CURSOR_API_KEY | Cursor 的 API 金鑰，讓 Cursor agent 免去瀏覽器登入 | 否 | — |
CLINE_API_KEY | Cline 的 API 金鑰，讓 Cline agent 免去瀏覽器登入 | 否 | — |
OPENBOT_CODEX_PATH | 指定非標準路徑的 Codex 執行檔，優先於內建管理的 CLI | 否 | — |
OPENBOT_CLAUDE_PATH | 指定非標準路徑的 Claude 執行檔 | 否 | — |
OPENBOT_OPENCODE_PATH | 指定不在 PATH 上的 OpenCode 執行檔 | 否 | — |
OPENBOT_ANTIGRAVITY_PATH | 指定 Gemini 用的 Antigravity ACP 伺服器執行檔 | 否 | — |
OPENBOT_CURSOR_PATH | 指定 Cursor CLI（cursor-agent）的執行檔路徑 | 否 | — |
OPENBOT_CLINE_PATH | 指定 Cline CLI 的執行檔路徑 | 否 | — |
OPENBOT_CUA_DRIVER_PATH | 開發版指定 Computer Use 驅動程式路徑，安裝版會忽略 | 否 | — |
OPENBOT_DISABLE_GPU | 設為 1 強制用 CPU 繪製，設為 0 強制使用 GPU | 否 | — |
CUA_DRIVER_RS_ENABLE_WAYLAND | Linux Wayland 下控制 Computer Use 驅動是否啟用 Wayland 支援 | 否 | — |
OPENBOT_SERVER | 設為 1 表示以伺服器模式執行，固定用 CPU 繪製 | 否 | — |
ACME_EMAIL | 遠端服務申請 TLS 憑證用的聯絡信箱 | 是 | admin@openbot.run |
TURN_SHARED_SECRET | coturn 與 Signal 共用的 TURN 認證密鑰 | 是 | — |
docker/compose.yaml — 自架 Docker 伺服器的服務定義、seccomp 設定與資料 volumeremote/.env.example — Signal、TURN、Slack、Discord、Telegram 等遠端連線服務的環境變數範本apps/auth-api/.env.example — 帳號 API 的 SMTP、Stripe、遠端票證金鑰與推播設定範本docker/instances/compose.yaml — 同一台主機跑多個 OpenBot 實例時的資源上限與掛載設定設定內容整理自 repository 內的設定檔與文件，未經實測；變數名稱與指令以官方檔案為準。
不用。使用安裝版時不需要 Bun 或 Node.js，只有從原始碼開發才需要 Bun 1.4.2 與 Node.js 24 以上。
agent 會以 danger-full-access 搭配 approvalPolicy: never 執行，首次啟動同意後就能讀寫檔案、跑指令、連網並操作內嵌瀏覽器，不會逐動作詢問。只跑你信任的 agent 與任務，並先備份。
資料存在本機，Docker 部署時放在 openbot-data volume，容器內對應 /data。帳號選單可匯出本機資料與去識別化的診斷資訊。
OpenBot 是 local-first 但非離線。Codex 連 OpenAI、Claude 連 Anthropic、Grok 連 xAI、Gemini 連 Google，造訪的頁面也會走網路。
可以。它會偵測本機的 Ollama、LM Studio 等模型伺服器，也支援自訂 OpenAI 相容端點與自訂 ACP agent。
Ubuntu 23.10 以上與 Debian 13 預設限制非特權 user namespace，需先安裝隨附的 AppArmor profile 並重新載入 apparmor。不要用 --no-sandbox 啟動。