5分钟快速上手AQBot:从下载安装到第一次AI对话的新手教程

原创2026-10-23 17:46:242,253 阅读

5分钟快速上手AQBot:从下载安装到第一次AI对话的新手教程

AQBot 是一款轻量级、高性能的跨平台 AI 对话桌面客户端,集成了多服务商 AI 对话、AI Agent、本地知识库与 API 网关。这篇新手教程将带你从下载安装、配置 AI 服务商,到完成第一次 AI 对话,全程只需 5 分钟。

AQBot 是什么?

AQBot 是一个"本地优先"的桌面 AI 工作台,你可以把它理解为一款集多种 AI 能力于一身的对话工具:

  • 多服务商 AI 对话 — 连接 OpenAI、Claude、Gemini、DeepSeek、Qwen 等,也支持任意 OpenAI 兼容端点;
  • AI Agent — 让 AI 在对话中直接读写文件、执行命令、分析代码;
  • 本地知识库与记忆 — 私有文档本地索引,AI 回答可引用你的资料;
  • API 网关 — 把本机配置的服务商一键暴露为 OpenAI 兼容接口;
  • 数据完全在本地 — 应用数据位于 ~/.aqbot/,用户文件位于 ~/Documents/aqbot/,API Key 使用 AES-256 本地加密保护。

下面这张图就是 AQBot 的 AI 对话主界面:左侧是对话列表,中间是流式回答(支持代码、图表、信息图渲染),顶部可快速切换模型与界面语言。

AQBot AI对话桌面客户端主界面与对话列表

第一步:下载安装包,30秒完成安装

AQBot 支持 macOS、Windows 和 Linux 三大平台,打开 官网下载页 选择对应安装包即可:

平台 架构 安装文件
macOS Apple Silicon (M1~M4) AQBot_x.x.x_aarch64.dmg
macOS Intel AQBot_x.x.x_x64.dmg
Windows 10/11 x64 AQBot_x.x.x_x64-setup.exe
Windows 10/11 ARM64 AQBot_x.x.x_arm64-setup.exe
Linux (Debian/Ubuntu) x64 / ARM64 AQBot_x.x.x_amd64.deb
Linux (Fedora/openSUSE) x64 / ARM64 AQBot_x.x.x_x86_64.rpm
Linux (通用) x64 / ARM64 AQBot_x.x.x_amd64.AppImage

安装很简单:

  • macOS:打开 .dmg,把 AQBot 拖进"应用程序"文件夹即可;
  • Windows:运行 .exe 安装包,按向导点下一步;
  • Linux:.deb 用 sudo dpkg -i 安装,.rpm 用 sudo rpm -i 安装,AppImage 直接赋予执行权限后运行。

⚠️ macOS 用户注意:如果首次打开提示"已损坏"或"无法验证开发者",请在 Finder 中按住 Control 键点击 AQBot.app 选择「打开」,或在「系统设置 → 隐私与安全性」中点击「仍要打开」。详见 getting-started.md。

第二步:添加 AI 服务商与 API Key

安装后启动 AQBot,点击侧边栏底部的齿轮图标(或按 Cmd/Ctrl + ,)打开设置,进入服务商管理页面:

  1. 点击 + 按钮新增服务商;
  2. 填写显示名称(如 OpenAI);
  3. 选择服务商类型(OpenAI、Anthropic、Google Gemini、DeepSeek、Qwen 等,内置类型会自动预填官方 Base URL);
  4. 粘贴你的 API Key;
  5. 如果你使用第三方中转服务,只需保持类型为 OpenAI,把 Base URL 改为中转地址即可。

AQBot服务商管理界面配置API密钥与模型列表

💡 小提示:你可以添加任意多个服务商,每个服务商独立管理自己的 API Key 和模型列表。更多细节可参考 providers.md。

第三步:同步模型并设置默认模型

在服务商详情中点击拉取模型(Fetch Models),AQBot 会自动从服务商 API 拉取可用模型列表,你也可以手动补充模型 ID。

随后进入默认模型设置,选择新对话默认使用哪个服务商的哪个模型。之后在对话区点击顶部模型选择器,即可随时在已配置的模型间快速切换,支持置顶常用模型、按服务商分组浏览:

AQBot模型选择面板切换AI对话模型

第四步:完成你的第一次AI对话

一切就绪,开始对话:

  1. 点击侧边栏新建对话(或按 Cmd/Ctrl + N);
  2. 在输入框中键入你的问题,按 Enter 发送;
  3. AQBot 会流式实时输出回答,完整渲染 Markdown、代码高亮、表格与图表;
  4. 支持思考块的服务商(如 Claude、DeepSeek R1),会在回答上方折叠展示推理过程。

AQBot第一次AI对话流式回答与代码渲染效果

几个让对话更高效的小技巧:

  • 多模型并行回答:在输入框添加多个模型,同一问题多模型同时作答,方便对比效果;
  • 消息多版本:重新生成回答会生成新版本,用消息气泡上的 ◀ ▶ 箭头切换,不丢失旧版本;
  • 对话分支:编辑或重生成任意一条消息即可创建分支,原始与新版本共存于同一对话树。

常用快捷键一览

快捷键 功能
Cmd/Ctrl + N 新建对话
Cmd/Ctrl + , 打开设置
Cmd/Ctrl + K 命令面板
Cmd/Ctrl + Shift + M 切换模型选择器
Cmd/Ctrl + Shift + G 开关 API 网关

所有快捷键都可以在设置 → 快捷键中自定义。

进阶玩法:对话之外的AI能力

完成第一次对话后,可以按兴趣解锁以下模块:

🤖 AI Agent:让AI动手写代码、执行命令

把对话切换到 Agent 模式,模型就能在你指定的工作目录中读取/编辑文件、执行命令并分析代码。涉及系统操作时会弹出权限审批卡片,你可以选择"允许一次"、"始终允许"或拒绝,全程掌控:

AQBot AI Agent权限审批与工具调用界面

📚 本地知识库:让AI读懂你的私有文档

在知识库模块导入 PDF、文本文档,AQBot 使用本地向量索引(sqlite-vec)完成检索,回答时可引用你的私有资料,文档不出本地:

AQBot本地知识库文档导入与索引状态界面

🌐 API 网关:把AI服务变成可调用的API

开启内置 API 网关后,你的服务商配置会暴露为 OpenAI Chat Completions 等标准接口,可配密钥、查看请求日志与 Token 用量统计,还能一键接入 Claude Code、Codex CLI 等客户端:

AQBot API网关概览请求日志与Token统计

网关的详细用法见 gateway.md,MCP 工具扩展见 mcp.md。

数据在哪里?如何备份

AQBot 是本地优先设计,所有数据都在你自己的电脑上:

路径 内容
~/.aqbot/ 应用状态:数据库、加密密钥、向量库、SSL 证书
~/Documents/aqbot/ 用户文件:图片、文档、备份

在设置 → 备份中心可配置自动备份(支持本地目录、WebDAV、S3 兼容存储),也可以随时手动备份与恢复。对话还支持右键导出为 PNG、Markdown、纯文本或 JSON。

常见问题

Q:macOS 提示"已损坏,无法打开"怎么办? 按 Control 点击 AQBot.app 选择「打开」并确认,或在「系统设置 → 隐私与安全性」中点击「仍要打开」。这不需要关闭系统 Gatekeeper。

Q:网络需要代理怎么办? 在设置 → 代理设置中配置 HTTP 或 SOCKS5 代理(主机 + 端口),对话请求即可走代理访问服务商。

Q:界面语言怎么切换? AQBot 支持简体中文、繁体中文、英语、日语、韩语等 11 种语言,点击顶部状态栏的地球图标即可切换。

下一步:继续深入学习

从下载安装到第一次 AI 对话,整个流程不过几分钟。现在就打开 AQBot,配置你的第一个服务商,和 AI 打个招呼吧!

登录后查看全文
AQBot