# 下載 Universe Bot

> 下載 Universe Bot：Mac（Apple 晶片、Intel）與 Linux AppImage。三步驟安裝，再登入你已經有的 Claude、ChatGPT 或 Gemini 帳號就能開始。

目前版本 0.2.5。測試期間免費；模型費用依你使用的服務計算。

## Mac（Apple 晶片或 Intel）

1. 下載符合你電腦的版本。不確定是哪一種？打開左上角蘋果選單的「關於這台 Mac」：寫「晶片 Apple M…」就選 Apple 晶片版，寫「處理器 Intel…」就選 Intel 版。
2. 打開 dmg，把 Universe Bot 拖進「應用程式」資料夾。
3. 從「應用程式」打開 Universe Bot。目前封閉測試版尚未公證，第一次打開要到「系統設定 → 隱私權與安全性」按「強制打開」。
4. macOS 會詢問 app 能不能使用鑰匙圈裡的「universe-bot Safe Storage」：輸入你的 Mac 登入密碼，按「永遠允許」。這是用來加密你存進 app 的 API key 和密碼。

- [Mac（Apple 晶片）](https://download.universebot.si/latest/UniverseBot-arm64.dmg)
- [Mac（Intel）](https://download.universebot.si/latest/UniverseBot-x64.dmg)

## Linux（x64，AppImage）

1. 下載 AppImage 檔。
2. 在檔案管理員對它按右鍵 →「內容 → 權限」，勾選「允許作為程式執行」。也可以在終端機執行 chmod +x UniverseBot-*.AppImage。
3. 雙擊打開。如果有裝 AppImageLauncher，它會先問要不要整合進選單，選哪個都可以。

- [Linux（AppImage）](https://download.universebot.si/latest/UniverseBot-x86_64.AppImage)

## 系統需求

| 項目 | 需求 |
|---|---|
| macOS | macOS 13 以上；Apple 晶片或 Intel（Intel 約 2017 年以後的機型） |
| Linux | x64、能執行 AppImage 的桌面環境 |
| 加密儲存 | macOS 用鑰匙圈；Linux 需要系統金鑰圈（例如 GNOME Keyring），沒有的話 app 會拒絕儲存 API key，不會用明文存 |
| Google Chrome | 選用；要讓 agent 操作網頁才需要 |
| 沙箱工具（Linux） | 選用；要用「讀寫工作區」檔位需要 `bubblewrap` 和 `socat` |

## 需要先準備的 AI 工具（至少一家）

| 想用的帳號 | 要裝的工具 | 安裝指令 | 登入 |
|---|---|---|---|
| Claude 訂閱 | Claude Code | `curl -fsSL https://claude.ai/install.sh \| bash` | 終端機打 `claude`，再打 `/login` |
| ChatGPT 訂閱 | Codex CLI | `npm install -g @openai/codex`（需要 Node.js） | 在 app 的開始畫面按「登入 ChatGPT」 |
| Google 帳號 | Gemini CLI | `npm install -g @google/gemini-cli`（需要 Node.js） | 終端機打 `gemini`，選「Login with Google」 |
| 自己的 API key | 不用裝 | — | 在 agent 的「進階設定 → 模型」填入 |

不用先背這些。第一次打開 app 時，開始畫面會檢查你的電腦缺什麼，並提供可以直接複製的安裝指令。