# 常见问题

关于 AQBot 是什么、如何处理你的数据以及如何上手的简明解答。

Source: https://app.aqbot.top/zh/faq

## 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 Key 使用 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 Key 和文件附件。

## 备份是怎么工作的？

你可以手动或定时备份与恢复，目标可以是本地目录、WebDAV 服务器或 S3 兼容存储。本地备份默认保存在 ~/Documents/aqbot/backups。

## macOS 提示 AQBot 已损坏或无法验证开发者，怎么办？

AQBot 使用项目自签名的证书，而不是 Apple Developer ID 证书。在 Finder 中按住 Control 点击 AQBot.app 并选择「打开」，或在「系统设置 → 隐私与安全性」中点击「仍要打开」即可，不需要关闭 Gatekeeper。

## 界面支持哪些语言？

简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语、俄语、印地语和阿拉伯语。