Ricardo 的博客

搭建 AI-Nagi 的过程

Sat, 31 Oct 2026 00:00:00 GMT

作者：晚空秋

在红岩网校看到「卷娘」这个 AI 形象时，第一反应是好奇：它是怎么来的？背后接了什么东西？能不能自己也做一个？

顺着这个问题问下去，发现原理并不神秘——一个 QQ 协议端负责收发消息，一个机器人框架负责接大模型，中间用 WebSocket 连起来。于是就有了下面这个属于我自己的 QQ AI：Nagi。

这篇记录整个搭建过程，包括踩过的坑。

一、需要准备什么#

组件	作用	说明
QQ 小号	给 AI 一个身份	强烈建议用小号，原因见下
NapCat	QQ 协议端	让程序能像人一样收发 QQ 消息
AstrBot Launcher	图形化安装器 + 进程管家	本身不含 AI 能力，只负责把 AstrBot 装起来、跑起来
AstrBot	机器人主体	接大模型、管人格、装插件
大模型 API Key	提供“智能”	要花钱，按 token 计费

关于风险，先说清楚#

NapCat 并不是腾讯官方提供的接口，它的做法是注入进程接管 QQ 客户端。这本质上违反了《QQ 软件许可协议》，存在被判定为异常登录、甚至封号的可能。

所以：一定用小号。真被封了也不心疼，主号不要冒险。

关于成本#

这套东西不是免费的。AI 每回复一次都在消耗 token，你可以理解为「每说一句话都在花钱」。日常聊天花费很小，但如果拉进群、被频繁 @，账单会肉眼可见地涨。

二、三个部件是怎么连起来的#

搞清楚这张图，后面每一步都不会迷路：

1
QQ 小号 ──扫码登录──> NapCat（协议端）
2
                          │
3
                          │  WebSocket  ws://127.0.0.1:6199/ws
4
                          ▼
5
                     AstrBot（AI 主体）──HTTPS──> 大模型 API（DeepSeek 等）

NapCat 负责“听得见、说得出”——把 QQ 的消息转成程序能读的格式，再把回复发回去
AstrBot 负责“想”——收到消息后调用大模型，决定回什么
6199 是两者之间的桥，AstrBot 在这头等着，NapCat 主动连过去

三、开始搭建#

第 1 步：安装所需工具#

去 GitHub 下载两个东西：

AstrBot Launcher：https://github.com/AstrBotDevs/astrbot-launcher/releases
NapCat：https://github.com/NapNeko/NapCatQQ/releases

NapCat 的安装脚本会自动检测并下载对应版本的 QQ（大约 300 MB），耐心等它跑完。

NapCat 安装程序正在下载 QQ 客户端

NapCat 安装时会自动拉取匹配版本的 QQ，进度条走完就装好了

第 2 步：运行 AstrBot，补齐运行组件#

打开 AstrBot Launcher，先把三个组件装上：Python、Node.js (LTS)、uv。

注意 uv 选 v4.28.2 这个版本，别的版本可能和 Launcher 对不上。

AstrBot 组件管理：Python、Node.js、uv 均已下载

三个组件都显示“已下载”才继续，缺一个后面都起不来

装完创建实例、启动，Launcher 会给你一组 WebUI 的账号和密码。浏览器打开它给的地址，登录进去，先创建一个自己的用户。

第 3 步：NapCat 登录 QQ 小号#

NapCat 安装完成后会在 QQ 安装目录里生成 napcat.bat，双击运行，会弹出一个二维码。

用小号扫码登录。这一步成功后，NapCat 就已经能收发这个号的消息了。

第 4 步：在 AstrBot 里创建机器人#

回到 AstrBot 的 WebUI，点“创建机器人”，按下表填：

字段	值
消息平台类别	OneBot v11
机器人名称	随意（默认 `default` 也行）
启用	打开
反向 WebSocket 主机	`0.0.0.0`
反向 WebSocket 端口	`6199`（保持不变）
反向 WebSocket Token	留空

在 AstrBot 中创建 OneBot v11 机器人

消息平台选 OneBot v11，主机 0.0.0.0，端口 6199，Token 不填

第 5 步：在 NapCat 里建立连接#

NapCat 运行后会给一个 WebUI 地址，浏览器打开，用刚登录的小号进去。找到 网络配置：

新建 WebSocket 客户端
启用打开
URL 改成 ws://127.0.0.1:6199/ws
Token 删掉（留空）
心跳间隔、重连间隔都设为 1000
保存

NapCat 主界面：确认版本与连接状态

NapCat 的概览页，可以看到版本号和运行状态

WebSocket 客户端配置：URL、心跳与重连间隔

URL 指向 AstrBot 的 6199，Token 留空，两个间隔都是 1000

第 6 步：确认连接成功#

回到 AstrBot，打开「数据与日志」，看到这一行就说明通了：

1
[INFO] aiochttp(OneBot v11) 适配器已连接。

AstrBot 日志：适配器已连接

日志里出现「适配器已连接」，说明 NapCat 和 AstrBot 握手成功

第 7 步：接入大模型#

回到 AstrBot 的欢迎页，配置 AI：

选择提供商模型（我用的是 DeepSeek）
粘贴 API 密钥（获取方法见文末附录）
点“获取模型”
聊天模型选 flash
保存配置

到这里，主体就已经能跑起来了——给它发条消息试试。

第 8 步：给它一个人格#

第一次对话大概率会让你失望：十分死板，毫无“人样”，像个问答机器人。

原因是模型不知道“它是谁”。所以要装人格：

① 装插件

在 Launcher 的插件市场安装 chat_plus（一个以 AI 读空气为主的群聊增强插件）。

插件市场里安装 chat_plus

② 打开分段回复和群聊上下文

在配置文件的「扩展功能」里：

启用分段回复（像真人一样把长回复拆成几条短消息）
启用群聊上下文感知（让它知道群里前面聊了什么）

扩展功能：分段回复与群聊上下文

分段回复能明显改善“像不像人”的观感，群聊上下文则避免它答非所问

③ 配置图片理解（可选）

勾选「自动理解图片」，选择一个视觉模型，群友发图它也能看懂。

图片转述模型配置

④ 写系统提示词

回到 AstrBot 的「人格设定」，创建新人格：起一个 ID，然后在系统提示词里描述它是谁——名字、性格、说话风格、口头禅、禁忌。

这一步建议和豆包之类的 AI 对话来打磨：先写一版粗糙的，让它帮你提问（“遇到这种情况他会怎么回应？”），再根据回答补细节。

第 9 步：选择人格，收工#

最后在配置文件的「AI 配置」里选中刚建的人格，保存。

和 Nagi 的第一次对话

配好人格之后，回复从“客服腔”变成了有人味的短句

四、踩过的坑#

现象	原因	解法
日志一直没有「适配器已连接」	端口或 URL 写错	确认 AstrBot 是 `0.0.0.0:6199`，NapCat 连 `ws://127.0.0.1:6199/ws`
扫码后秒掉线	小号被风控	换号，或降低发送频率
回复很慢	模型选了 pro/长上下文	换 flash，减少上下文条数
一口气发一大段	没开分段回复	扩展功能里打开分段，间隔 1.5–3.5 秒
说话不像人	系统提示词太笼统	写具体：称呼、语气、句子长度、禁用词

五、最后#

从“看到一个 AI 形象觉得好奇”到“自己跑起来一个”，中间其实只有三个部件和一个端口。真正花时间的不是配置，而是调人格——同样的模型，提示词写得好不好，观感差距是数量级的。

Nagi 现在还在慢慢调，等哪天它能在群里自然地接话，这篇就算写完了。

附录：获取 DeepSeek API 密钥#

打开 https://www.deepseek.com/ ，进入 API 开放平台
注册并登录，创建账户信息
新用户需要先充值（最少 10 元），用于抵扣运行时的 token 消耗
进入 API keys 页面，点“创建 API key”
复制生成的密钥，粘贴到 AstrBot 的配置里

DeepSeek 开放平台首页

密钥只显示一次，务必当场保存；泄露了就在后台删掉重建。

修改hosts快速连接GitHub

Sat, 31 Oct 2026 00:00:00 GMT

GitHub 打开慢或者干脆打不开，多半是域名被解析到了一个不可用的 IP。手动把域名绑到一个能通的 IP 上，就能绕过这个问题。

整个过程五步，十分钟内能做完。

第一步：拿到可用的 IP#

打开 cmd 窗口，输入：

Terminal window

1
ping github.com

按回车，会看到类似这样的输出：

ping github.com 的输出，方括号里就是 IP

方括号 [] 里那一串数字就是 IP 地址，比如 20.205.243.166。

如果这里显示”请求超时”或”找不到主机”，说明当前网络连 ping 都不通，改 hosts 也没用，得换网络环境或用代理。

第二步：复制 IP 地址#

把方括号里的 IP 复制下来，比如 20.205.243.166。

只复制 IP 本身，后面的 时间=100ms TTL=109 不要带上。

第三步：以管理员身份运行记事本#

在任务栏搜索框里输入 记事本，右键选择 以管理员身份运行。

这一步不能省。hosts 是系统文件，普通权限打开会保存失败。

第四步：找到 hosts 文件#

在记事本左上角点 文件 → 打开，地址栏进入：

1
C:\Windows\System32\drivers\etc

右下角的文件类型默认是”文本文档”，改成”所有文件”，这时才能在列表里看到 hosts。

选中 hosts，点打开。

第五步：粘贴 IP 并保存#

把刚才复制的 IP 粘贴到文件最下方，格式是「IP + 空格 + 域名」：

1
20.205.243.166    github.com

注意：

IP 和域名之间用空格或 Tab 隔开，不能用逗号
文件里原有的 127.0.0.1 localhost 那几行不要动
改完点左上角 文件 → 保存（或 Ctrl+S）

保存成功，整个流程就完成了。重新打开浏览器访问 GitHub 试试。

补充几点#

1. 需要绑定的不止 github.com

常用的还有几个，可以一起加：

1
140.82.112.3      github.com
2
140.82.112.6      api.github.com
3
140.82.112.9      codeload.github.com
4
185.199.108.133   raw.githubusercontent.com
5
185.199.108.133   objects.githubusercontent.com

2. 改完没生效，刷新一下 DNS 缓存

在 cmd 里执行：

Terminal window

1
ipconfig /flushdns

然后按 Ctrl+F5 强制刷新浏览器。

3. IP 会变

GitHub 的 IP 段过一段时间会调整，几个月后如果又变慢了，重复上面五步，重新 ping 一次、换一个新 IP 即可。

4. ping 不通就别折腾 hosts 了

如果第一步 ping 就超时，说明是链路层的问题，改 hosts 解决不了，需要走代理或者其他加速方式。

一句话总结：ping 拿 IP → 管理员记事本打开 hosts → 贴到最下面 → 保存 → 刷新 DNS。