Astrbot+Napcat QQ机器人Debian部署过程记录

[AhandsomeA]

声明：包含AI生成内容

绪论

近几年，大语言模型（Large Language Model, LLM）的发展可谓是轰轰烈烈、如火如荼。我最初接触到并实际使用的LLM是ChatGPT3.5，当时只道是糊弄作业和写报告的又一个新手段。谁曾想，在这之后，国内外的LLMs以及许多非LLM的专用型AI模型如雨后春笋般相继涌现。截止到我写这篇文章，比较关注的LLMs的最新版本如下表所示：

LLM名称	版本	模式	开发公司
ChatGPT	5.5	闭源	OpenAI
Deepseek	V4	开源	深度求索
Claude	5.0	闭源	Anthropic
GLM	5.2	开源	智谱AI
Gemini	3.5	闭源	Google
MiMo	2.5	开源	小米
Grok	4.2	闭源	xAI
Kimi	2.6	开源	月之暗面
Qwen	3.7	闭源	阿里巴巴
MiniMax	M3	开源	稀宇极智
Doubao	2.1	闭源	字节跳动

至于接入了LLM的聊天机器人则是在去年才首次接触到，直到今年才萌生自己部署聊天机器人的想法。我认为，部署一个聊天机器人确实是一个能进一步体验和了解LLM的有趣方式。

就我这次部署聊天机器人来说，首先是为了折腾（将部署机器人这件事本身作为课余时间的娱乐方式），其次才是使用和体验机器人功能，因此为了增加工作量，我走的是本地Linux直接部署方式。

平台介绍

1️⃣硬件平台：从咸鱼搞的小主机，CPU为英特尔赛扬J1900，主频1.99GHz，TDP 仅 10W，运存与存储为8+120G（事实证明，对于在Linux环境下部署Astrbot机器人来说，即使同时跑着CasaOS，这样的性能仍然是十分过剩的☝️🤓，看来我还可以再折腾折腾别的）。

2️⃣系统平台：Debian13.5的Linux系统+xfce4桌面环境，使用systemd来管理服务，能实现开机自启、异常退出自动重启，这是保证长期稳定运行。

3️⃣机器人平台：要打造一个QQ智能机器人，核心在于两个开源项目：AstrBot与NapCat。Asrtbot是一个开源的一体化基座聊天机器人平台，负责AI LLM 对话、多模态、代理、技能、知识库、人物设定、自动上下文压缩等职责；NapCat采用OneBot11标准，作为连接腾讯 QQ 服务器的协议端，通过 NTQQ 接口实现无头(headless)运行，将复杂的 QQ 协议转换成标准的 HTTP/WebSocket 事件，分发给上层的 Asrtbot。

整体思路

这套方案基于J1900低功耗平台和Debian 13.5系统构建，所有服务均以原生进程方式运行，由systemd统一管理，未使用Docker等容器技术。核心是Asrtbot与NapCat组合实现的QQ机器人，其中NapCat负责对接QQ协议、将消息转换为HTTP/WebSocket请求，Asrtbot承担语义理解与回复生成，两者均编写了systemd服务单元并配置开机自启和异常自动重启，保障长期无人值守运行。针对图形操作需求，部署了noVNC服务，将宿主机桌面通过Web页面暴露出来，浏览器即可远程操作。同时部署CasaOS作为轻量管理面板，集中展示各项服务的入口并监控系统状态。所有WebUI——包括CasaOS面板、Asrtbot+Napcat后台、noVNC远程桌面——通过Tailscale组建的虚拟局域网串联，利用WireGuard加密通道实现安全穿透，在任何外网环境下均可通过浏览器统一访问和管理。我个人认为这套方案是比较合理的，其安全性也较高。

环境配置

BIOS配置与Debian安装

这里开始安装Debian系统，需要键盘、屏幕、鼠标，整体配置完成后可不需要屏幕和外设。

Debian中文官网：https://www.debian.org/index.zh-cn.html

Rufus中文官网：https://rufus.ie/zh/

Rufus制作Debian启动盘教程：https://www.bilibili.com/video/BV1pT4y1v7z2/

Debian13安装教程：https://www.bilibili.com/video/BV1YEsazoEsS/

注意这里我选用的桌面环境为XFCE，与安装教程中有所不同。

Debian系统的下载与安装我参照的b站上的已有教程，这里补充一下U盘安装时的BIOS配置情况（不同主板的BIOS界面和进入方式不同，这里以我的为例）：

按开机键→按Del键进入BIOS→BOOT→Hard Drive BBS Priorities→选择具体的启动U盘

为保障QQ机器人及其他服务在无人值守情况下的良好平稳运行，上电自启动和服务开启自启是配置中不可缺少的一环。我所使用的这款J1900小主机支持上电自启动功能，可以在设置U盘引导时顺便开启：

Chipset→South Bridge→Restore AC Power Loss→设为Power On→Save&Exit保存并退出

安装完系统后进入终端进一步配置防止自动休眠：

##1.屏蔽 systemd 的休眠/挂起目标
sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
##2. 配置 logind（防止空闲自动挂起、合盖挂起）
HandleSuspendKey=ignore
HandleHibernateKey=ignore
HandleLidSwitch=ignore
HandleLidSwitchExternalPower=ignore
IdleAction=ignore
sudo systemctl restart systemd-logind 
##3.关掉 XFCE 电源管理的自动挂起
xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/inactivity-on-ac -s 0
xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/dpms-enabled -s false
xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/blank-on-ac -s 0
##4.确认后重启电脑
systemctl status sleep.target
#看到结果含 Loaded: masked 就成了

网络和代理配置

2.1中给出的教程中已经包含了放入官方驱动包的操作，幸运的是，我的J1900的无线网卡在安装完Debian系统后已经可以运行，无需额外安装驱动。

下图是我的XFCE桌面，经过了一定美化操作，美化操作就不再详细展开了。

接下来连接网络，可以插入网线，也可以使用无线网络。XFCE桌面下，可以在桌面右下角单击无线网络图标进行配置，注意应该选择“连接到隐藏的Wi-Fi网络”，这样才能设置安全性和填入密码，网络名称填入实际搜到的WiFi网络名称，安全性一般选择WPA及WPA2个人，最后填入密码连接。

进一步进行代理配置，我这里使用的是Flclash+机场的模式。Flclsh是基于 Clash Meta (Mihomo) 内核，采用 Flutter 构建的图形化多平台代理客户端。

Flclash仓库地址：https://github.com/chen08209/FlClash

可以从仓库上下载.deb发行版安装包并通过xfce自带的图形化安装程序进行安装，也可以进入终端使用命令进行安装：

##1.下载 .deb 安装包（可以根据实际最新版本修改命令中的版本号）
wget -O /tmp/flclash.deb https://github.com/chen08209/FlClash/releases/download/v0.8.93/FlClash-0.8.93-linux-amd64.deb
#下载缓慢可以使用加速镜像站
wget -O /tmp/flclash.deb https://ghfast.top/https://github.com/chen08209/FlClash/releases/download/v0.8.93/FlClash-0.8.93-linux-amd64.deb
##2.安装(用 apt 装本地包,自动解决依赖)
sudo apt install -y /tmp/flclash.deb
##3. 启动
flclash

接下来就和window中填入机场连接操作一样了，至于机场就得自己找了。注意启用开机自启。不要开全局 TUN 模式。 让 FlClash 只提供一个本地代理端口(默认混合端口 127.0.0.1:7890)。

VNC桌面配置

这里采用的是noVNC + TigerVNC的方案，在局域网中从浏览器里即能看到完整的XFCE桌面，无需安装其他应用。

##0.首先查看Debian安装设备的局域网IP
hostname -I
##1.安装相关软件
sudo apt update
sudo apt install -y \
    tigervnc-scraping-server \
    novnc \
    websockify
#确认x0vncserver已安装（应该输出/usr/bin/x0vncserver）
which x0vncserver

##2.设置VNC连接密码（会让你输入两次，不会显示实际字符，输完后回车即可）
mkdir -p ~/.vnc
vncpasswd
#最后弹出“Would you like to enter a view-only password?”，输入n回车即可
#确认密码文件存在
ls -l ~/.vnc/passwd

##3.确认当前桌面（应输出X11）和显示编号（应该是:0）
echo $XDG_SESSION_TYPE
echo $DISPLAY

##4.创建 X0TigerVNC 服务（粘贴下面的x0vncserver.service，然后Ctrl+O保存，Ctrl+X退出）
sudo nano /etc/systemd/system/x0vncserver.service

[Unit]
Description=TigerVNC Server for current X11 desktop
After=graphical.target
Wants=graphical.target

[Service]
Type=simple
User=你的实际用户名
ExecStart=/usr/bin/x0vncserver \
    -display :0 \
    -rfbport 5900 \
    -localhost \
    -PasswordFile=/home/你的实际用户名/.vnc/passwd
Restart=always
RestartSec=3

[Install]
WantedBy=graphical.target

##5.创建 noVNC 服务（粘贴下面的novnc.service，然后Ctrl+O保存，Ctrl+X退出）
sudo nano /etc/systemd/system/novnc.service

[Unit]
Description=noVNC WebSocket Proxy
After=x0vncserver.service
Requires=x0vncserver.service

[Service]
Type=simple
ExecStart=/usr/bin/websockify \
    --web=/usr/share/novnc/ \
    6080 \
    localhost:5900
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

##6.重载与设置自启
sudo systemctl daemon-reload
sudo systemctl enable --now x0vncserver
sudo systemctl enable --now novnc
##7.验证服务状态
systemctl status x0vncserver novnc --no-pager
#应当看到下面这样结果
#x0vncserver.service    active (running)
#novnc.service          active (running)
#查看端口
ss -tlnp | grep -E '5900|6080'
#应当看到下面这样结果
#LISTEN 127.0.0.1:5900
#LISTEN 0.0.0.0:6080
#查看进程
ps -ef | grep X0tigervnc | grep -v grep

配置完一键验证：

echo "===== X11 ====="
echo "Session : $(echo $XDG_SESSION_TYPE)"
echo "Display : $(echo $DISPLAY)"

echo
echo "===== Services ====="
systemctl status x0vncserver novnc --no-pager

echo
echo "===== Ports ====="
ss -tlnp | grep -E '5900|6080'

echo
echo "===== Process ====="
ps -ef | grep X0tigervnc | grep -v grep

此时在连接到相同局域网的任意一台设备上输入：

http://localhost:6080/vnc.html

"localhost"改成刚才用的hostname -I命令查到的debian在局域网中的IP，一般是192.168开头。

点击连接，输入刚才设置的密码，进入到VNC屏幕中：

此时如果在网页上操作屏幕，则直连Debian的物理屏也会同步进行操作，就好像向日葵远程协助一样。这时候拔掉直连Debian的物理屏，插上一个从淘宝9块9买的HDMI诱骗器，重新连接VNC，如果正常显示，则大功告成！从此装有Debian的主机便不再需要鼠标、键盘和屏幕，我们可以从局域网访问VNC屏幕！

Tailscale穿透配置

Tailscale 的核心原理基于 WireGuard VPN，它实现了端到端加密的点对点（P2P）连接，但在必要时会通过 中继服务器（DERP） 进行中转 。整体来说，它是一个零配置的 Mesh VPN，让所有设备看起来像是在同一个本地局域网（LAN）内。Tailscale支持Windows、Linux、Mac、Android、iOS设备，个人可以免费使用。

Tailscale官网下载：https://tailscale.com/download

Tailscale控制台：https://login.tailscale.com/admin/machines

开启并登陆同一个Tailscale账号的设备相当于处于一个Tailscale分配和维系的大局域网之中，理论上可以让你的好友和服务器全部登陆同一个Tailscale账号，无需额外内网穿透即可进行Minecraft联机游戏。

Tailscale提供了Linux一键安装命令，其他平台从官网下载后直接安装即可：

curl -fsSL https://tailscale.com/install.sh | sh
#安装完成后，启动服务并获取登录链接
sudo tailscale up
#复制终端输出的链接，在浏览器中打开并使用账号登录即可

这样安装的Tailscale默认以systemd服务运行，安装时一般已经自动设置为开机启动。

可以通过控制台观察设备情况：

Tailscale会为每台设备分配一个IP地址，当然这个IP地址只有在运行Tailscale并登录相同账号时才能访问，它的安全性取决于Tailscale账号的安全性。比如，我的Debian主机分配的地址为100.83.237.15，当然，它是无法直接访问的。

内网IP的改变不会影响Tailscale分配给设备的地址，也就是说即使换了网络环境，只要登录了相同Tailscale账号，就能从其他设备通过Tailscale分配给设备的这个地址随时随地进行访问。

可以说，Tailscale可以在保证安全性的前提下，让你本地部署的Astrbot机器人也能像托管在服务器上的那样，通过WebUI随时随地进行查看和配置。当然，VNC远屏幕也可以通过这样随时随地远程访问。

Napcat与Astrbot配置

Napcat与Astrbot的部署

Astrbot官方仓库：https://github.com/AstrBotDevs/AstrBot

Astrbot官方和Napcat官方都提供了一键部署指令，因此部署它们是比较容易的。

##0.前置环境准备（python3和ffmpeg转码工具，这两个是必需的）
sudo apt update
sudo apt install -y git curl wget unzip ffmpeg
sudo apt install -y python3 python3-pip python3-venv

##1.安装Napcat
curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh --tui
#装完启动并出二维码(把 <QQ号> 换成你给bot准备的QQ号)
sudo napcat start <QQ号>
sudo napcat log <QQ号>
#日志里会打印登录二维码和WebUI的token,用手机QQ扫码即可登录。

##2.安装Astrbot
#先装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
#克隆并启动(uv 会自动建虚拟环境、装依赖)
git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
uv run main.py

都跑起来后，可分别通过：

http://localhost:6099

http://localhost:6185

分别访问Napcat和Astrbot的WebUI界面，"localhost"就是通过hostname -I命令查询到的192.168开头的Debian设备的局域网IP；当然，填入Tailscale分配的IP还可以让你在非局域网的条件下进入WebUI界面。6099是Napcat默认端口，6185是Astrbot默认端口。

在连接到同一局域网的设备上打开WebUI，我们需要先进行简单配置。

这里需要的token在Napcat启动日志中，可以通过打开napcat前台或直接浏览日志文件来查看：

#方法一：前台查看
sudo xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox
#注意查看完要按Ctrl+C关闭这个新进程

#方法二：日志查看
sudo tail -f /root/Napcat/opt/QQ/resources/app/app_launcher/napcat/logs/*.log
sudo cat /root/Napcat/opt/QQ/resources/app/app_launcher/napcat/config/webui.json   

值得一提的是，noVNC提供了共用的剪贴板，可以很方便地在浏览器所在系统和VNC远程屏幕之间交换内容：

在Napcat的WebUI中填入复制的token，可以顺利进入。我们首先要打开：

网络配置→新建→Websocket客户端

Websocket客户端的配置如下图所示：

配置好后可以向bot的QQ发送消息，并在猫猫日志里查看是否有反应，如果有则可进行下一步Astrbot配置。

机器人→创建机器人→OneBot v11

注意不是QQ官方机器人，两者的原理和配置完全不同；

机器人名称自行设置，其余配置如图，然后保存，警告无视即可。盯着平台日志，待适配器链接完成后，再向Bot的QQ号发送消息，如果平台日志有反应，则可进行下一步操作。

[2026-06-12 14:18:53.005] [Core][INFO][aiocqhttp.aiocqhttp_platform_adapter:107]: aiocqhttp(OneBot v11) 适配器已连接。
[2026-06-12 14:18:55.409] [Core][INFO][core.event_bus:74]: [HandsomeBot] [HandsomeBot(aiocqhttp)] 1758391746/1758391746:

接下来返回Debian的终端，通过创建systemd服务来设置Astrbot和Napcat开机自启：

sudo tee /etc/systemd/system/napcat.service > /dev/null << 'EOF'
[Unit]
Description=NapCat QQ
After=network-online.target astrbot.service
Wants=network-online.target astrbot.service
StartLimitIntervalSec=300
StartLimitBurst=3

[Service]
Type=simple
User=root
ExecStart=/usr/bin/xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox -q <机器人QQ号>
Restart=on-failure
RestartSec=30
KillMode=control-group

[Install]
WantedBy=multi-user.target
EOF

sudo tee /etc/systemd/system/astrbot.service > /dev/null << 'EOF'
[Unit]
Description=AstrBot
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/AstrBot
Environment=HOME=/root
Environment=HTTP_PROXY=http://127.0.0.1:7890
Environment=HTTPS_PROXY=http://127.0.0.1:7890
Environment=NO_PROXY=127.0.0.1,localhost
ExecStart=/root/AstrBot/.venv/bin/python main.py
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

这样，Astrbot和Napcat就可以方便地通过systemctl命令来管理了，下面是一个总结：

---

NapCat 位于 /root/Napcat，AstrBot 位于 /root/AstrBot，两者都以 root 运行、由 systemd 托管开机自启。
登录的 QQ：3809683114。切记：同一 QQ 绝不能同时跑两个 NapCat 实例（封号风险）。

项目	说明
本机 IP	**hostname -I**（取第一个 192.168.x.x）
NapCat WebUI	**http://localhost:6099**
AstrBot WebUI	**http://localhost:6185**
aiocqhttp 对接端口	**6199**（NapCat 的 WS 客户端指向 **ws://127.0.0.1:6199/ws**）
noVNC 网页桌面	**http://<IP>:6080/vnc.html**
VNC 端口	**5900**
FlClash 代理端口	**7890**（混合端口）

一键检查端口是否在监听：

sudo ss -tlnp | grep -E '6099|6185|6199|6080|5901|7890'

sudo systemctl restart napcat      # NapCat 重启
sudo systemctl restart astrbot     # AstrBot 重启
sudo systemctl stop napcat         # 停止
sudo systemctl start napcat        # 启动
sudo systemctl status napcat astrbot --no-pager   # 看状态（绿色 active 即正常）

实时看日志：

sudo journalctl -u napcat -f       # NapCat 实时日志
sudo journalctl -u astrbot -f      # AstrBot 实时日志
sudo journalctl -u astrbot -n 50 --no-pager   # 看最近 50 行

通用 systemd 命令（任意服务名通用）：

sudo systemctl start|stop|restart|status <服务名>
sudo systemctl enable|disable <服务名>          # 开/关开机自启
sudo journalctl -u <服务名> -f                  # 实时日志

AstrBot 前台（带代理）：

export HTTP_PROXY=http://127.0.0.1:7890 
export HTTPS_PROXY=http://127.0.0.1:7890 
export NO_PROXY=127.0.0.1,localhost
cd /root/AstrBot && uv run main.py

NapCat 前台：

sudo xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox -q <机器人QQ号>

调试前先停掉对应的 systemd 服务（sudo systemctl stop napcat / astrbot），避免双实例。

NapCat 日志文件 / WebUI token：

sudo tail -f /root/Napcat/opt/QQ/resources/app/app_launcher/napcat/logs/*.log
sudo cat /root/Napcat/opt/QQ/resources/app/app_launcher/napcat/config/webui.json #取token

Napcat与Astrbot的配置

Napcat相关配置

由于腾讯的风控策略，在Napcat登录QQ的开始这段时间内（约1个星期），QQ比较容易掉线，我的解决方法是通过Server酱进行提醒，收到提醒后重新扫码登录即可。待稳定后QQ基本不掉线。

「Server酱」，英文名「ServerChan」，是一款「手机」和「服务器」、「智能设备」之间的通信软件。说人话？就是从服务器、路由器等设备上推消息到手机的工具。

开通并使用上它，只需要一分钟：①微信扫码；②登入设置消息通道；③发消息，一般有两种方式：在支持Server酱的软件界面或配置文件中填入SendKey，即可使用；也可以自己往 https://sctapi.ftqq.com/.send 发送请求。

Server酱官方网址：https://sct.ftqq.com/

首先微信登录拿到Sendkey：

然后在WebUI配置Napcat，这次需要创建HTTP服务器，按下图配置即可：

然后新建脚本，进行进一步配置：

脚本和配套文件 /usr/local/bin/qq_watch.sh、/etc/systemd/system/qq_watch.service、/etc/systemd/system/qq_watch.timer以下操作每块整体修改后复制到终端再回车即可。

注意！下面的文件需要根据实际情况修改！修改时不保留<>

cat > /usr/local/bin/qq_watch.sh <<'EOF' 
#!/bin/bash
SENDKEY="<Server酱 SendKey>"  #这里要填入刚才获取的SendKey
API="http://127.0.0.1:3000/get_status"
TOKEN="<NapCat HTTP token>"   #这里填入刚才创建的HTTP服务器的Token
COOLDOWN=600                  #重启冷却 10 分钟
BOT="<机器人QQ号>"             #这里填入机器人QQ号
STATEFILE="/run/qq_watch.state"
LASTFILE="/run/qq_watch.lastact"

notify(){ curl -s "https://sctapi.ftqq.com/${SENDKEY}.send" -d "title=$1" -d "desp=$2" >/dev/null; }

STATUS=$(curl -s --max-time 5 -H "Authorization: Bearer $TOKEN" "$API")

if   echo "$STATUS" | grep -qE '"online"[[:space:]]*:[[:space:]]*true';  then CUR=online
elif echo "$STATUS" | grep -qE '"online"[[:space:]]*:[[:space:]]*false'; then CUR=offline
else CUR=error    # 读不到真状态:token错/网络/NapCat没起 → 只提醒不重启
fi

PREV=$(cat "$STATEFILE" 2>/dev/null || echo online)
echo "$CUR" > "$STATEFILE"
NOW=$(date +%s); LAST=$(cat "$LASTFILE" 2>/dev/null || echo 0)

case "$CUR" in
  offline)
    if [ $((NOW-LAST)) -ge "$COOLDOWN" ]; then
      if [ "$PREV" = online ]; then
        notify "QQ掉线" "Bot ${BOT} 离线，正在重启 NapCat 尝试快速登录"
      else
        notify "QQ仍离线" "Bot ${BOT} 仍未恢复，再次重启；若风控请手动去 WebUI 重扫"
      fi
      systemctl restart napcat
      echo "$NOW" > "$LASTFILE"
    fi ;;
  online)
    if [ "$PREV" = offline ]; then
      notify "QQ已恢复" "Bot ${BOT} 重新上线"
      echo 0 > "$LASTFILE"
    fi ;;
  error)
    if [ "$PREV" != error ] && [ $((NOW-LAST)) -ge "$COOLDOWN" ]; then
      notify "监控异常" "get_status 读不到状态(token/网络/NapCat未起)，未重启，请人工检查"
      echo "$NOW" > "$LASTFILE"
    fi ;;
esac
EOF

cat > /etc/systemd/system/qq_watch.service <<'EOF'
# /etc/systemd/system/qq_watch.service
[Service]
Type=oneshot
ExecStart=/usr/local/bin/qq_watch.sh
EOF

cat > /etc/systemd/system/qq_watch.timer <<'EOF'
# /etc/systemd/system/qq_watch.timer
[Timer]
OnBootSec=2min
OnUnitActiveSec=2min
[Install]
WantedBy=timers.target
EOF

chmod +x /usr/local/bin/qq_watch.sh
systemctl daemon-reload
systemctl enable --now qq_watch.timer

逻辑：掉线→立刻推送+重启一次；10 分钟冷却内不重复；仍离线且冷却过→再推+再重启；恢复→推"已恢复"。error 态（读不到状态）只提醒、绝不重启，避免误判把 QQ 踢下线。

自检（这里也要改成自己的SendKey！）

curl http://127.0.0.1:3000/get_status   # 应见 "online":true
curl "https://sctapi.ftqq.com/<你的SendKey>.send" -d "title=测试" -d "desp=通了"
systemctl list-timers | grep qq_watch

这样便能在微信服务号上收到掉线提醒：

Astrbot相关配置

接下来是最为关键的Astrbot配置，我整体的思路如下图所示：

接下来详细讲解模型提供商配置：

①Deepseek

Deepseek 开放平台：https://platform.deepseek.com/

在Deepseek充值并获得APIkey后，填入到模型提供商中：

②Mistral

经过我的考察，Mistral系列模型安全审查明显较弱，不容易被拦截和发生错误（凭借这一点，其在“上不上评分系统”中表现良好），不过其识别精准度相较于头部的多模态模型仍有差距。并且在据我了解的中转站点中，提供Mistral系列模型的仅有302ai一家。

302ai：https://302.ai/

由于302ai中转需要代理才能访问，所以在配置时，应当填入代理地址，这个我们在已经写入了Astrbot的开机自启服务配置里，直接使用即可：

③MIMO

MIMO开放平台：https://platform.xiaomimimo.com/

由于我在MiMo官网的认证遇到了一些问题，这里使用的是第三方API：

Modelmesh胜算云：https://console.shengsuanyun.com/

拿到APIkey后，填入到语音转文字的模型提供商中，配置按下图所示即可：

④豆包语音复刻模型

凭证获取教程：https://github.com/Radiant303/astrbot_plugin_clonetts

机器人的语音输出功能既可以使用Astrbot官方提供的文字转语音服务，也可以使用文字转语音插件，其中插件astrbot_plugin_clonetts提供了语气描述，效果要更好一些。

Astrbot官方提供的文字转语音服务配置：

⑤嵌入与重排序模型

硅基流动：https://cloud.siliconflow.cn/

获取APIkey后如下配置，分别使用openai_embedding格式和vllm_rerank：

⑥文转图服务

Astrbot提供了文本转图像服务，这里直接配置即可：

接下来是在配置文件中应用我们已经导入完的模型：

应用配置文件：

在知识库中应用嵌入和重排序模型：

这样，一个全能机器人的基本配置便完成了。接下来推荐几个插件来拓展机器人功能，具体的插件配置不再展开叙述。刚兴趣的小伙伴可以自行研究。

①通用生图：https://github.com/Railgun19457/astrbot_plugin_image_generation

②万能解析器：https://github.com/Zhalslar/astrbot_plugin_parser

③P站插件：https://github.com/vmoranv-reborn/astrbot_plugin_pixiv_reborn

④JM插件：https://github.com/GEMILUXVII/astrbot_plugin_jm_cosmos

⑤入群欢迎与验证：https://github.com/qiyueling2716/astrbot_plugin_welcome_verification

⑥克隆语音：https://github.com/Radiant303/astrbot_plugin_clonetts

功能展示与小结

经过我的配置和测试，HandsomeBot逐渐成为一个能看图、会说话、会听语音、会写文章、善于管理群、能下载作品、可以解析视频的全能机器人助理。

折腾了这么长时间，也算是折腾出了点名堂，我感觉在我之前应该没有人会自己从头开始在Debian上本地部署Astrbot+Napcat的QQ机器人吧，也算是开创先河了。这次折腾是关于AI的，能完成这次折腾也少不了各个AI的帮助，总之AI正在越来越渗透进我们生活的方方面面，没人知道未来它又会进化成什么样子。

最后，Astrbot还有许多功能，AI还会带来许多惊喜，这就需要你去慢慢尝试和研究啦！