AQBot 是一款本地优先的开源桌面 AI 工作台(AGPL-3.0),统一了多服务商对话、ACP Agent、知识库、MCP 工具和本地 API 网关,应用数据和用户文件都保留在本机。

核心特性

  • 多服务商对话:连接 OpenAI、Claude、Gemini、DeepSeek、Qwen 以及任意 OpenAI 兼容端点。
  • 服务商快速导入:通过 aqbot:// 链接导入服务商,确认后写入本地配置。
  • 模型管理:同步远程模型列表、能力标签和延迟测试。
  • Agent:对话内 Agent 和 ACP Agent 工作台。
  • 本地数据:应用状态位于 ~/.aqbot/,用户文件位于 ~/Documents/aqbot/。

接入 ZeroCat

方式一:一键导入

如果 ZeroCat 控制台中提供 AQBot 一键导入:
  1. 安装并至少打开过一次 AQBot 桌面端,系统才会注册 aqbot:// 协议。
  2. 在 ZeroCat「API 密钥」页面,点击目标密钥旁的「…」→「聊天」→ AQBot。
  3. 浏览器唤起 AQBot,在确认框中核对服务商名称、API 地址、类型和密钥前缀。
  4. 确认后 AQBot 会进入「设置 → 服务商管理」;相同地址和类型的服务商会被复用,否则新建。
  5. 打开该服务商,点击「同步模型」,再回到对话页选择模型。
导入后不会自动验证密钥,也不会自动同步模型,需要手动点击「同步模型」。

方式二:手动配置

  1. 在 ZeroCat「API 密钥」页面复制密钥。
  2. 打开 AQBot →「设置 → 服务商管理」→「添加服务商」。
  3. 填写以下字段:
  1. 点击「同步模型」,拉取 ZeroCat 当前可用的模型。
  2. 回到对话页,选择刚同步的模型开始使用。

API 地址说明

  • 推荐只填 https://zero.cat,AQBot 会对 OpenAI 类型自动补上 /v1。
  • 如果地址已经以 /v1 结尾,AQBot 不会重复追加。
  • 只有在必须禁用自动补全时,才在地址末尾加 !。

可选:原生协议

需要直接使用 Claude 或 Gemini 原生接口时,可以再添加服务商,同一个 API 密钥可以用在多个服务商上:

常见问题

  • 点击 AQBot 没有唤起应用:先安装并启动过一次桌面端,只打开官网不会注册 aqbot:// 协议。
  • 导入成功但无法对话:先点击「同步模型」,并确认模型 ID 与 ZeroCat 中的模型 ID 一致。
  • macOS 提示「已损坏」或「无法验证开发者」:按 AQBot README 和 官方快速开始 放行当前应用即可,不必关闭整个 Gatekeeper。
  • 一键导入链接里带有 API 密钥:不要把带真实密钥的链接分享到公开场合。