# QQ机器人自建教程：NapCat 安装与 OneBot 接入

来源：https://doc.ermaozi.cn/doc/deploy/

本教程适用于用自己的 QQ 小号运行机器人。使用 QQ 官方机器人时，直接按[添加与配置](https://doc.ermaozi.cn/#%E4%B8%89%E5%88%86%E9%92%9F%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8)操作即可。
适用范围
这是历史安装教程，界面和下载地址可能变化，安装前请对照 [NapCat 官方文档](https://napneko.github.io/)。

## 两句话攻略
安装支持 OneBot v11 的客户端，将反向 WebSocket 地址设为：`wss://ermaozi.cn/onebot/v11/ws`
客户端登录成功后，用主人账号私聊机器人，发送：`激活`。
警告
请用专门的 QQ 小号扫码登录，不要使用常用大号。扫码登录的账号会成为机器人。

## NapCatQQ 下载与安装
[NapCat 下载仓库](https://github.com/NapNeko/NapCatQQ) · [官方安装文档](https://napneko.github.io/)
Windows 临时使用方法NapCatQQ Docker 安装
Windows 临时使用方法
使用期间电脑和 NapCat 命令窗口都需保持开启。
下载 Windows NapCat 压缩包
[windows napcat 下载](https://r2.ermao.net/NapCat.Shell.Windows.Node.zip)
解压压缩包，并打开 `napcat.bat`
Windows 解压后启动 napcat.bat
打开后访问后台管理地址

```
WebUi User Panel Url: http://127.0.0.1:6099/webui?token=你的管理令牌
```

将启动日志中的完整地址复制到浏览器打开。
用自己的小号扫码登陆
NapCat QQ 小号扫码登录界面

NapCatQQ Docker 安装
linux安装docker命令：`sudo wget -qO- https://get.docker.com/ | bash`
windows安装docker地址：[https://www.docker.com/](https://www.docker.com/)

```
docker run -d \
    -e NAPCAT_GID=$(id -g) \
    -e NAPCAT_UID=$(id -u) \
    -e NAPCAT_QQ=机器人的QQ号 \
    --network host \
    --name napcat \
    --restart=always \
    -v ~/napcat/config:/app/napcat/config \
    -v ~/napcat/QQ:/app/.config/QQ \
    docker.ermao.net/mlikiowa/napcat-docker:latest
```

将上面的 `机器人的QQ号` 替换成你要用来登陆机器人的QQ号。如果不加入`-e NAPCAT_QQ=机器人的QQ号`这一行，则重启时无法快速登陆。
启动后访问：`http://服务器地址:6099/webui?token=xxxxx`
在启动日志中找到 `WebUi Token` 或 `WebUi User Panel Url`，使用你自己实例的管理令牌登录，不要把令牌或完整管理地址发到公开群聊。

## NapCatQQ 反向ws 设置
按照下面步骤将反向ws（Websocket 客户端）设置为：`wss://ermaozi.cn/onebot/v11/ws`
NapCat 网络配置中新建 WebSocket 客户端
启用反向 WebSocket 并填写二猫子连接地址

## 激活（机器人认主）
在登陆成功后用大号私聊机器人，发送：`激活`
用哪个号跟机器人发送激活，哪个号就是机器人的主人
注意
请确认使用主人账号发送 `激活`，认主后不便更改。

机器人激活成功的私聊回复
机器人回复`激活成功`，表示可以正常使用了。

## 机器人管理与性格修改
访问 [https://ermaozi.cn](https://ermaozi.cn/)
用机器人主人的QQ邮箱注册。
登陆后就可以在机器人配置中修改机器人性格了。
二猫子管理后台中的机器人列表与配置入口
在“机器人配置”中确认主人 QQ，修改“机器人性格”后保存，例如：`每天都在上班，上班总想着偷偷睡觉`。

## 常见问题

### 只想把二猫子添加到群，也需要部署 NapCat 吗？
不需要。使用 QQ 官方机器人时，从[二猫子汇总](https://doc.ermaozi.cn/#%E4%BA%8C%E7%8C%AB%E5%AD%90%E6%B1%87%E6%80%BB)添加到群，再开启群权限并发送 `群设置` 即可检查配置。本教程面向使用自己 QQ 小号接入的用户。

### QQ 小号已经登录 NapCat，下一步做什么？
先完成[反向 WebSocket 设置](https://doc.ermaozi.cn/doc/deploy/#napcatqq-%E5%8F%8D%E5%90%91ws-%E8%AE%BE%E7%BD%AE)，连接成功后，用主人账号私聊机器人发送 `激活`，见[激活说明](https://doc.ermaozi.cn/doc/deploy/#%E6%BF%80%E6%B4%BB-%E6%9C%BA%E5%99%A8%E4%BA%BA%E8%AE%A4%E4%B8%BB)。