常見問題
簡要說明 AQBot 是什麼、如何處理你的資料,以及如何開始使用。
AQBot 是什麼?
AQBot 是一款免費開源的 AI 桌面用戶端,支援 macOS、Windows 與 Linux。它在單一應用程式中整合了多服務商對話、Agent、MCP 工具、本機知識庫與本機 API 閘道,應用程式資料與使用者檔案都保存在你自己的電腦上。
AQBot 免費嗎?
免費。AQBot 可免費下載與使用,原始碼以 AGPL-3.0 授權發布在 GitHub 上。你只需支付自己選擇串接的模型服務商費用;若使用本機模型,則完全不必付費。
可以使用哪些 AI 服務商與模型?
AQBot 支援 OpenAI、Claude、Gemini、DeepSeek、通義千問,以及任何 OpenAI 相容端點,包括 Ollama 這類本機伺服器。每個服務商都能個別設定 Base URL、API 路徑、請求標頭與代理伺服器,也能透過 aqbot:// 連結或 CC Switch 匯入服務商。
支援哪些作業系統?
支援 Apple 晶片與 Intel 晶片的 macOS、x64 與 ARM64 架構的 Windows 10 和 11,以及 x64 與 ARM64 架構的 Linux(提供 AppImage、deb 與 rpm 套件)。
AQBot 把我的資料存放在哪裡?
資料庫、加密金鑰、向量資料庫等應用程式狀態存放在 ~/.aqbot;圖片、附件與備份存放在 ~/Documents/aqbot。API 金鑰會以 AES-256 搭配本機主金鑰加密儲存。
如何讓 Claude Code、Codex CLI 或 Gemini CLI 使用 AQBot?
在 AQBot 中啟動 API 閘道並產生閘道金鑰,再用「快速連接」把位址與金鑰寫入 Claude Code、Codex、OpenCode、Gemini CLI 或 Cursor 的設定。若手動設定,Claude Code 需要設定 ANTHROPIC_BASE_URL=http://localhost:8080/v1,並將 ANTHROPIC_AUTH_TOKEN 設為閘道金鑰。
AQBot 支援 MCP 嗎?
支援。AQBot 是 MCP 用戶端,可透過 stdio、SSE 或 StreamableHTTP 執行 Model Context Protocol 伺服器,並內建 @aqbot/fetch 等工具。工具呼叫的最大輪數可以自行設定。
對話 Agent 與 ACP 工作台有什麼不同?
對話 Agent 使用你在 AQBot 中設定的服務商,在你選定的資料夾中讀寫檔案、執行指令,並提供多種核准模式;該資料夾只是起始工作目錄,並非沙箱。ACP 工作台則執行支援 Agent Client Protocol 的外部 Agent,例如 Codex、Claude Agent、Gemini CLI、Cline 與 OpenCode。
可以匯入我現有的對話嗎?
可以。AQBot 支援匯入 ChatGPT 官方匯出檔、Cherry Studio 備份與 Kelivo 備份,匯入前會顯示預覽與警告,並處理重複內容。匯入 Cherry Studio 與 Kelivo 時,還能一併移轉服務商、API 金鑰與附件。
備份如何運作?
你可以手動或排程備份與還原,目的地可以是本機資料夾、WebDAV 伺服器或 S3 相容儲存空間。本機備份預設存放在 ~/Documents/aqbot/backups。
macOS 顯示 AQBot 已損毀或無法驗證,該怎麼辦?
AQBot 使用專案自有的憑證簽署,而非 Apple Developer ID。請在 Finder 中按住 Control 點按 AQBot.app 並選擇「打開」,或到「系統設定 → 隱私權與安全性」中允許開啟,不需要關閉 Gatekeeper。
介面支援哪些語言?
簡體中文、繁體中文、英文、日文、韓文、法文、德文、西班牙文、俄文、印地文與阿拉伯文。