在随身WiFi上使用NapCat部署LangBot

本文将手把手教你如何在一台随身WiFi设备上，通过NapCat和LangBot搭建一个属于自己的QQ AI聊天机器人。整个过程涵盖环境准备、服务部署、面板配置和网络调试，适合零基础用户。

一、下载与安装

1. 安装 NapCat

NapCat 是一个基于 NTQQ 的无头 QQ 协议实现，可以在无图形界面的服务器上运行 QQ。

终端命令

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

2. 安装 Python

LangBot 需要 Python 3.10.1 及以上版本（不包括 3.10.0）。如果系统自带版本满足要求可跳过此步。

添加华为云源并安装

echo "deb https://repo.huaweicloud.com/debian bookworm main" | sudo tee -a /etc/apt/sources.list
apt update
apt install -y python3.11 python3.11-venv python3-pip

创建虚拟环境

cd /你的langbot路径
python3.11 -m venv python3.11.2

3. pip 换源

国内环境建议换成中科大镜像源，下载速度更快。

pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple

4. 安装 Python 依赖

cd /你的langbot路径
./python3.11.2/bin/python3 -m pip install -r requirements.txt

清理存储空间

随身WiFi存储空间有限，安装完成后及时清理缓存：

sudo apt autoremove    # 删除不再需要的依赖包
sudo apt clean         # 删除所有已下载的 .deb 包缓存

二、启动服务

以下两种方式任选其一。

方案 A：使用 screen 管理（手动启动）

每次重启设备后需要手动开启，适合调试阶段。

启动 LangBot

# 新建 screen 窗口
screen -S langbot

# 进入目录并启动
cd /你的langbot路径
./python3.11.2/bin/python3 main.py
# 新版本需要运行两次：第一次初始化，第二次正式启动

# 后台运行：按 Ctrl+A 然后按 D
# 重新进入：screen -r langbot

启动 NapCat

# 新建 screen 窗口
screen -S napcat

# 启动（将 QQ号码 替换为你的QQ小号）
xvfb-run -a qq --no-sandbox -q QQ号码

# 后台运行：按 Ctrl+A 然后按 D
# 重新进入：screen -r napcat

方案 B：使用 systemd 服务（开机自启）

推荐正式使用时选择此方案，重启后自动拉起服务。

配置步骤

1. 编辑 napcat.service，找到 ExecStart 行，将其中的 QQ 号码替换为你的小号
2. 上传 napcat.service 和 langbot.service 到 /etc/systemd/system/
3. 重载并设置开机启动：

systemctl daemon-reload
systemctl enable napcat
systemctl enable langbot

常用管理命令

操作	命令
停止服务	systemctl stop napcat
重启服务	systemctl restart napcat
查看状态	systemctl status napcat
查看日志	journalctl -u napcat -f

三、访问管理面板

1. LangBot 面板

在浏览器地址栏输入：

http://服务器IP:5300

例如：http://192.168.68.1:5300

2. NapCat WebUI 面板

首先找到最新的日志文件，通常位于：

/opt/QQ/resources/app/app_launcher/napcat/logs/

在日志中找到类似以下内容：

[NapCat] [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=napcat

复制冒号后面的部分，即 6099/webui?token=napcat，然后在浏览器中访问：

http://服务器IP:6099/webui?token=napcat

例如：http://192.168.68.1:6099/webui?token=napcat

NapCat 首次启动时需要扫码登录QQ

四、网络配置

NapCat 需要通过 WebSocket 连接 LangBot，配置如下：

1. 在 WebUI 左侧导航栏找到 网络配置
2. 点击 新建 → WebSocket 客户端，打开左上角的 启用 开关
3. 名称 随意填写
4. 将 URL 一栏修改为：ws://127.0.0.1:2280/ws
5. 点击 保存

五、配置 AI 模型

此处以硅基流动（SiliconFlow）API 为例，配置 LLM 接入。

修改模型名称

打开 LangBot 安装目录下的配置文件：

/langbot/data/metadata/llm-models.json

找到 "gpt-4o-11-20"，替换为你想使用的模型，例如：

"deepseek-ai/DeepSeek-V2.5"

填写 API Key

1. 打开 LangBot 面板，点击左侧 设置
2. 找到 provider.json，点击 {...} 切换到编辑模式
3. 将 "sk-1234567890" 替换为你的 API 密钥
4. 将 "model": "gpt-4o" 替换为你的模型名
5. 点击右上角 应用 保存

六、重启服务

方案 A（screen 用户）

# 重启 LangBot
screen -r langbot
# 按 Ctrl+C 结束进程，然后重新运行
./python3.11.2/bin/python3 main.py

# 重启 NapCat
screen -r napcat
# 按 Ctrl+C 结束进程，然后重新运行
xvfb-run -a qq --no-sandbox -q QQ号码

方案 B（systemd 用户）

systemctl restart napcat
systemctl restart langbot

# 可选：查看运行状态
systemctl status napcat
systemctl status langbot

七、常见问题排查

如果确保以上步骤完全正确，但 QQ 对话无响应，请检查网络连通性：

ping www.baidu.com

如果没有反馈或直接失败，修改 DNS：

# 打开 /etc/resolv.conf
# 将第一个 nameserver 后面的内容改为以下之一：
8.8.8.8
8.8.4.4
114.114.114.114

修改后再次 ping www.baidu.com，确认网络通畅后重试 QQ 对话。