NapCat Setup¶

本页只说明把 NapCat 接到本项目需要关注的部分，不展开完整的 QQ / NapCat 教程。

目标¶

你需要让 NapCat 提供两类能力：

先确保 NapCat 已经正常运行，并完成 QQ 登录。

你至少需要确认：

假设本项目运行在本机 5000 端口，那么 webhook 地址通常类似：

http://127.0.0.1:5000/

如果 NapCat 和本项目不在同一台机器上，需要把地址改成对应机器的可访问地址。

项目侧通常需要知道 NapCat 的：

示例：

NAPCAT_HTTP=http://127.0.0.1:3001
NAPCAT_TOKEN=your_token_here

请把它们写到项目使用的 .env 或配置文件中。

建议先验证下面两件事：

启动项目后，给机器人发一条 QQ 私聊消息，观察终端是否出现类似日志：

[WEBHOOK] 收到请求: ...
[WEBHOOK] message_type: private

如果消息能收到，但机器人完全不回，继续检查：

如果主动 reminder 能成功发到 QQ，通常也说明 NapCat 发送链路是通的。