5分钟快速上手AQBot:从下载安装到第一次AI对话的新手教程
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 对话主界面:左侧是对话列表,中间是流式回答(支持代码、图表、信息图渲染),顶部可快速切换模型与界面语言。
第一步:下载安装包,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 + ,)打开设置,进入服务商管理页面:
- 点击 + 按钮新增服务商;
- 填写显示名称(如 OpenAI);
- 选择服务商类型(OpenAI、Anthropic、Google Gemini、DeepSeek、Qwen 等,内置类型会自动预填官方 Base URL);
- 粘贴你的 API Key;
- 如果你使用第三方中转服务,只需保持类型为 OpenAI,把 Base URL 改为中转地址即可。
💡 小提示:你可以添加任意多个服务商,每个服务商独立管理自己的 API Key 和模型列表。更多细节可参考 providers.md。
第三步:同步模型并设置默认模型
在服务商详情中点击拉取模型(Fetch Models),AQBot 会自动从服务商 API 拉取可用模型列表,你也可以手动补充模型 ID。
随后进入默认模型设置,选择新对话默认使用哪个服务商的哪个模型。之后在对话区点击顶部模型选择器,即可随时在已配置的模型间快速切换,支持置顶常用模型、按服务商分组浏览:
第四步:完成你的第一次AI对话
一切就绪,开始对话:
- 点击侧边栏新建对话(或按
Cmd/Ctrl+N); - 在输入框中键入你的问题,按
Enter发送; - AQBot 会流式实时输出回答,完整渲染 Markdown、代码高亮、表格与图表;
- 支持思考块的服务商(如 Claude、DeepSeek R1),会在回答上方折叠展示推理过程。
几个让对话更高效的小技巧:
- 多模型并行回答:在输入框添加多个模型,同一问题多模型同时作答,方便对比效果;
- 消息多版本:重新生成回答会生成新版本,用消息气泡上的 ◀ ▶ 箭头切换,不丢失旧版本;
- 对话分支:编辑或重生成任意一条消息即可创建分支,原始与新版本共存于同一对话树。
常用快捷键一览
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl + N |
新建对话 |
Cmd/Ctrl + , |
打开设置 |
Cmd/Ctrl + K |
命令面板 |
Cmd/Ctrl + Shift + M |
切换模型选择器 |
Cmd/Ctrl + Shift + G |
开关 API 网关 |
所有快捷键都可以在设置 → 快捷键中自定义。
进阶玩法:对话之外的AI能力
完成第一次对话后,可以按兴趣解锁以下模块:
🤖 AI Agent:让AI动手写代码、执行命令
把对话切换到 Agent 模式,模型就能在你指定的工作目录中读取/编辑文件、执行命令并分析代码。涉及系统操作时会弹出权限审批卡片,你可以选择"允许一次"、"始终允许"或拒绝,全程掌控:
📚 本地知识库:让AI读懂你的私有文档
在知识库模块导入 PDF、文本文档,AQBot 使用本地向量索引(sqlite-vec)完成检索,回答时可引用你的私有资料,文档不出本地:
🌐 API 网关:把AI服务变成可调用的API
开启内置 API 网关后,你的服务商配置会暴露为 OpenAI Chat Completions 等标准接口,可配密钥、查看请求日志与 Token 用量统计,还能一键接入 Claude Code、Codex CLI 等客户端:
网关的详细用法见 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 种语言,点击顶部状态栏的地球图标即可切换。
下一步:继续深入学习
- 官方新手指南:getting-started.md
- 服务商完整配置:providers.md
- MCP 服务器接入:mcp.md
- API 网关详解:gateway.md
- 项目功能总览:README.md
从下载安装到第一次 AI 对话,整个流程不过几分钟。现在就打开 AQBot,配置你的第一个服务商,和 AI 打个招呼吧!






