教程NewAPI 官方文档
AQBot - 本地优先的桌面 AI 工作台
AQBot 教程 — 将本地优先桌面 AI 工作台对接 New API。支持 aqbot:// 一键导入,以及 OpenAI / Claude / Gemini 协议手动配置。
内容摘要
聊天设置选项
在 New API 控制台的系统设置- 聊天设置中,可添加如下快捷选项,便于在令牌管理页一键填充到 AQBot:
{ "AQBot" : "aqbot://providers?name=New%20API&baseurl={address}&apikey={key}&type=openai" }
AQBot 是一款本地优先的开源桌面 AI 工作台(AGPL-3.0),统一多服务商对话、ACP Agent、知识库、MCP 工具与本地 API 网关,应用数据与用户文件保留在本机。
官网: https://app.aqbot.top
GitHub: https://github.com/AQBot-Desktop/AQBot
下载: GitHub Releases
官方文档: 快速开始
核心特性
多服务商对话 — 连接 OpenAI、Claude、Gemini、DeepSeek、Qwen 以及任意 OpenAI 兼容端点
服务商快速导入 — 通过 aqbot:// 链接导入服务商,确认后写入本地配置
模型管理 — 同步远程模型列表、能力标签与延迟测试
Agent — 对话内 Agent(使用已配置服务商 API)与 ACP Agent 工作台
本地数据 — 应用状态位于 ~/.aqbot/ ,用户文件位于 ~/Documents/aqbot/
完整功能请参考 AQBot 官网 。本页只覆盖对接 New API。
NewAPI 接入方法
请使用您自己部署的 New API,或确认服务方具备合法上游授权和合规义务的 New API 服务。不要将来源不明的 API 地址或密钥接入生产环境。
方式一:一键导入(推荐)
安装并至少打开过一次 AQBot 桌面端,系统才会注册 aqbot:// 协议
在 New API 控制台的「系统设置 → 聊天设置」中加入上文 JSON
打开「令牌管理」,在目标令牌的操作菜单中选择 AQBot
浏览器唤起 AQBot,在确认框中核对服务商名称、API 地址、类型 openai 和密钥前缀
确认后 AQBot 会进入 设置 → 服务商管理 ;按 API 地址 + 类型复用已有服务商,否则新建
打开该服务商,点击 同步模型 ,再回到对话页选择模型开始使用
{address} 是 New API 站点根地址(例如 https://your-newapi.example ),不要带 query。AQBot 对 OpenAI 类型会自动补上 /v1 。导入后不会自动验证密钥,也不会自动同步模型。
方式二:手动配置
在 New API 令牌管理页复制 API Key
打开 AQBot → 设置 → 服务商管理 → 添加服务商
填写以下字段:
字段 填法 服务商名称 例如 New API 服务商类型 OpenAI (推荐) API 地址 New API 站点地址,如 https://your-newapi.example API 密钥 New API 令牌
点击 同步模型 ,拉取 New API 当前可用的模型
回到对话页,选择刚同步的模型开始使用
API 地址注意
推荐只填站点根地址,让 AQBot 自动补 /v1
如果地址已经以 /v1 结尾,AQBot 不会再追加
只有在必须禁用自动补全时,才在地址末尾加 !
可选:原生协议
New API 同时提供 Claude / Gemini 原生接口时,可以再添加一条服务商:
需求 服务商类型 API 地址 Chat Completions(默认) OpenAI 站点根地址 Claude 原生 /v1/messages Anthropic 站点根地址 Gemini 原生 Gemini 站点根地址
一键导入模板里的 type 对应改为 anthropic 或 gemini 。同一套 API Key 可以挂多条服务商。
常见问题
点击 AQBot 没有唤起应用 :先安装并启动过桌面端。只打开官网或开发服务器不会注册 aqbot://
导入成功但无法对话 :先点击「同步模型」,并确认模型 ID 与 New API 实际暴露的名称一致
macOS 提示「已损坏」或「无法验证开发者」 :按 AQBot README 与 官方快速开始 放行当前应用,不必关闭整个 Gatekeeper
一键链接里带有 API Key :只在已登录的令牌页生成该链接,不要把带真实密钥的 URL 发到公开页面
相关链接
AQBot GitHub
配置服务商(官网)
下载
这篇文档对您有帮助吗?
最后更新于
资讯来源
NewAPI