快速开始

NapCatQQ V2 正式开始测试，欢迎来到 NapCatQQ (aka 猫猫框架) 的使用文档！

使用之前

在开始使用之前，你需要了解以下内容。

猫猫框架的原理是什么，能够做些什么？

猫猫框架通过魔法的手段获得了 QQ 的发送消息、接收消息等接口，为了方便使用，猫猫框架将通过一种名为 OneBot 的约定将你的 HTTP / WebSocket 请求按照规范读取，再去调用猫猫框架所获得的QQ发送接口之类的接口。

如何使用

前往 NapCatQQ 的 release 页面，各位可以看到有两个压缩包， 文件名后缀分别为 Shell 和 Framework，应当如何选择呢？ 这就需要了解猫猫框架的启动方式了。

1. 方法 1 作为 LiteLoaderQQNT 插件运行，可以实现“人机合一”。

2. 方法 2 通过命令行启动，当你不需要或没有图形化界面，或者内存紧张，可以使用此方法。

3. 方法 3 “Only GUI” 模式，当你不想使用 LiteLoader 插件时，却又想人机合一，又想折腾时，可以考虑此方法。

方法 1 和 3 都是“有头启动”，应当使用 Framework 版本；方法 2 是无头启动，应当使用 Shell 版本。我们目前对方法 1 和 2 有较为完整的文档支持，方法 3 还请自行探索。

方法1: 作为 LiteLoader 插件启动

手动撸猫

通过LiteLoader框架安装Framework版本Napcat

1. 按照 LiteLoaderQQNT 官网 的指导安装 LiteLoaderQQNT 框架。

2. 在 LiteLoaderQQNT 的设置页面（如下图）将 NapCat.Framework.zip 导入即可。

一键撸猫

Framework Linux Docker

前往仓库了解

NapCat.Docker.Framerwrok

Windows Framework的一键启动程序

1. 前往 NapCatQQ 的 release 页面
2. 选择NapCat.Framerwork.Windows.Once.zip下载
3. 找到目录下的exe启动 (注意不要解压到带有空格或者中文的目录)

Windows Framework的一键程序

前往仓库了解

NapCat.Framerwrok.installer

源码仓库

Framework的Linux 一键脚本 (适用于 Ubuntu 20+ / Debian 10+ / CentOS 9 / Archlinux)

curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.framework.sh && sudo bash napcat.sh

方法2: 通过命令行启动

频繁掉线可以采用方式1 也可以 拉取docker老版本 (推荐 v1.8.6 实际上2.2.19及其以下的版本都没问题) nc

一键撸猫

Windows X64 自动化启动器

1. 前往 NapCatQQ 的 release 页面

2. 下载NapCat.Shell.zip解压

3. 安装完成 双击目录下launcher.bat即可启动 如果是win10 则使用launcher-win10.bat

注意 如果需要快速登录 命令行执行 或者 新建bat

Win11: .\launcher.bat 123456

Win 10: .\launcher-win10.bat 123456

Windows图形化部署与管理工具

警告 此方案 可能存在一些奇妙bug 如果出现问题 请耐心尝试其余方案

源码仓库

下载工具

如果存在问题 请前往官方群和issue反馈 并尝试其余的方案

Windows X64 自动化下载与安装程序

前往下载

复制到你需要的目录双击启动程序 即可 如果存在问题 请前往官方群和issue反馈 并尝试下面的方案

安装完成 双击目录下launcher.bat即可启动 如果是win10 则使用launcher-win10.bat

修改配置见本文最后 NapCat 的基础设置 同时 你可以也可以使用 图形化WebUi远程配置

注意 如果需要快速登录 命令行执行 或者 新建bat

Win11: .\launcher.bat 123456

Win 10: .\launcher-win10.bat 123456

Linux 一键脚本 (适用于 Ubuntu 20+ / Debian 10+ / CentOS 9)

curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh

Linux 下使用 Docker

用不来怎么办？ 点我前往不知名的友人提供的教程

使用 NapCat-Docker

macOS 图形化下载与安装程序

前往下载

需要 macOS 12.0 或以上系统，支持下载和更新 NapCatQQ

由于权限问题，补丁过程需要手动替换 package.json，请注意备份原文件～

Termux 一键脚本

curl -o napcat.termux.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.termux.sh && bash napcat.termux.sh

在 Railway 上部署

在 1Panel 通过插件部署

前往插件仓库

通过1Panel插件 简单部署NapCatQQ 注意此方案并非官方维护

Nix 启动

如果您希望使用 Nix 启动 NapCat，请查看 initialencounter/napcat.nix

请注意，该安装方式为非官方维护，可能会遇到一些问题，欢迎反馈。

手动/半自动撸猫

Arch用户康康？？

半自动安装教程

暂时不再提供其余教程 由于启动方式变更

方法3: Only GUI

原因与上(可以实现 但是不如方案一二)

使用之后

恭喜你，如果看到这里，你已经成功启动了它，可以尝试阅读下面的进阶说明！

出现闪退如何处理 特别篇

如何进行 NapCat 的基础设置

如何配置 NapCat 的语音发送 参考 语音、视频发送失败 发生失败条目

遇到 NapCat 崩溃问题如何解决