QQ 机器人 - 晚安的静谧小屋

开源项目#

Astrbot项目地址：GitHub - AstrBotDevs/AstrBot: ✨ 易上手的多平台 LLM 聊天机器人及开发框架 ✨ 支持 QQ、QQ频道、Telegram、企微、飞书、钉钉 | 知识库、MCP 服务器、OpenAI、DeepSeek、Gemini、硅基流动、月之暗面、Ollama、OneAPI、Dify
napcat项目地址：GitHub - NapNeko/NapCatQQ: Modern protocol-side framework based on NTQQ

准备工作#

安装docker以及docker-compose 可以使用 docker 官方命令，也可以使用1panel命令

docker 官方命令（需要特殊环境）

1
curl -fsSL https://get.docker.com | bash

使用1panel安装命令一键完成docker的安装

1
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

具体安装过程

1
root@web:~# bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
2
开始下载 1Panel v2.0.9 版本在线安装包
3
安装包下载地址： https://resource.fit2cloud.com/1panel/package/v2/stable/v2.0.9/release/1panel-v2.0.9-linux-amd64.tar.gz
4
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
5
                                 Dload  Upload   Total   Spent    Left  Speed
6
100 41.9M  100 41.9M    0     0  2372k      0  0:00:18  0:00:18 --:--:-- 2276k
7
Warning: Got more output options than URLs
8
1panel-v2.0.9-linux-amd64/1panel-agent.service
9
1panel-v2.0.9-linux-amd64/1panel-core.service
10
1panel-v2.0.9-linux-amd64/1pctl
11
1panel-v2.0.9-linux-amd64/GeoIP.mmdb
12
1panel-v2.0.9-linux-amd64/install.sh
13
1panel-v2.0.9-linux-amd64/lang/en.sh
14
1panel-v2.0.9-linux-amd64/lang/fa.sh
15
1panel-v2.0.9-linux-amd64/lang/pt-BR.sh
16
1panel-v2.0.9-linux-amd64/lang/ru.sh
17
1panel-v2.0.9-linux-amd64/lang/zh.sh
18
1panel-v2.0.9-linux-amd64/1panel-agent
19
1panel-v2.0.9-linux-amd64/1panel-core
20
Select a language:
21
1. English
22
2. Chinese  中文(简体)
23
3. Persian
24
4. Português (Brasil)
25
5. Русский
26
Enter the number corresponding to your language choice: 2

在这里输入 2

1
 ██╗    ██████╗  █████╗ ███╗   ██╗███████╗██╗
2
███║    ██╔══██╗██╔══██╗████╗  ██║██╔════╝██║
3
╚██║    ██████╔╝███████║██╔██╗ ██║█████╗  ██║
4
 ██║    ██╔═══╝ ██╔══██║██║╚██╗██║██╔══╝  ██║
5
 ██║    ██║     ██║  ██║██║ ╚████║███████╗███████╗
6
 ╚═╝    ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝
7
[1Panel Log]: ======================= 开始安装 =======================
8
设置 1Panel 安装目录 (默认为 /opt):
9
[1Panel Log]: 您选择的安装路径是 /opt
10
检测到未安装 Docker，是否安装 [y/n]: y
11
[1Panel Log]: ... 在线安装 Docker
12
[1Panel Log]: 无需更改源
13
# Executing docker install script, commit: bedc5d6b3e782a5e50d3d2a870f5e1f1b5a38d5c
14
+ sh -c apt-get -qq update >/dev/null
15
+ sh -c DEBIAN_FRONTEND=noninteractive apt-get -y -qq install ca-certificates curl >/dev/null
16
+ sh -c install -m 0755 -d /etc/apt/keyrings
17
+ sh -c curl -fsSL "https://download.docker.com/linux/debian/gpg" -o /etc/apt/keyrings/docker.asc
18
+ sh -c chmod a+r /etc/apt/keyrings/docker.asc
19
+ sh -c echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian bookworm stable" > /etc/apt/sources.list.d/docker.list
20
+ sh -c apt-get -qq update >/dev/null
21
+ sh -c DEBIAN_FRONTEND=noninteractive apt-get -y -qq install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-ce-rootless-extras docker-buildx-plugin docker-model-plugin >/dev/null
22
+ sh -c docker version
23
Client: Docker Engine - Community
24
 Version:           28.3.3
25
 API version:       1.51
26
 Go version:        go1.24.5
27
 Git commit:        980b856
28
 Built:             Fri Jul 25 11:34:00 2025
29
 OS/Arch:           linux/amd64
30
 Context:           default
31

32
Server: Docker Engine - Community
33
 Engine:
34
  Version:          28.3.3
35
  API version:      1.51 (minimum version 1.24)
36
  Go version:       go1.24.5
37
  Git commit:       bea959c
38
  Built:            Fri Jul 25 11:34:00 2025
39
  OS/Arch:          linux/amd64
40
  Experimental:     false
41
 containerd:
42
  Version:          1.7.27
43
  GitCommit:        05044ec0a9a75232cad458027ca83437aae3f4da
44
 runc:
45
  Version:          1.2.5
46
  GitCommit:        v1.2.5-0-g59923ef
47
 docker-init:
48
  Version:          0.19.0
49
  GitCommit:        de40ad0
50

51
================================================================================
52

53
To run Docker as a non-privileged user, consider setting up the
54
Docker daemon in rootless mode for your user:
55

56
    dockerd-rootless-setuptool.sh install
57

58
Visit https://docs.docker.com/go/rootless/ to learn about rootless mode.
59

60

61
To run the Docker daemon as a fully privileged service, but granting non-root
62
users access, refer to https://docs.docker.com/go/daemon-access/
63

64
WARNING: Access to the remote API on a privileged Docker daemon is equivalent
65
         to root access on the host. Refer to the 'Docker daemon attack surface'
66
         documentation for details: https://docs.docker.com/go/attack-surface/
67

68
================================================================================
69

70
[1Panel Log]: ... 启动 Docker
71
Synchronizing state of docker.service with SysV service script with /lib/systemd/systemd-sysv-install.
72
Executing: /lib/systemd/systemd-sysv-install enable docker
73
[1Panel Log]: Docker 安装成功
74
设置 1Panel 端口 (默认是 29597):

设置端口，如果你需要使用1panel则继续，如果不需要则直接 ctrl+c 退出即可

安装#

1
cd /home

创建文件夹以及进入到文件夹中

1
cd /home
2
mkdir qqbot
3
cd qqbot

创建docker-compose.yml文件

1
nano docker-compose.yml

会跳转一个新的页面，复制下面的内容，然后按 ctrl+x 退出，按 y 保存，最后按回车确定即可

1
# NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose -f ./compose/astrbot.yml up -d
2
services:
3
  napcat:
4
    environment:
5
      - NAPCAT_UID=${NAPCAT_UID:-1000}
6
      - NAPCAT_GID=${NAPCAT_GID:-1000}
7
      - MODE=astrbot
8
    ports:
9
      - 6099:6099
10
    container_name: napcat
11
    restart: always
12
    image: mlikiowa/napcat-docker:latest
13
    volumes:
14
      - ./data:/AstrBot/data
15
      - ./ntqq:/app/.config/QQ
16
    networks:
17
      - astrbot_network
18
    mac_address: "02:42:ac:11:00:02"
19
  astrbot:
20
    environment:
21
      - TZ=Asia/Shanghai
22
    image: soulter/astrbot:latest
23
    container_name: astrbot
24
    restart: always
25
    ports:
26
      - "6185:6185"
27
      - "6195:6195"
28
      - "6199:6199"
29
    volumes:
30
      - ./data:/AstrBot/data
31
      - ./napcat/config:/app/napcat/config
32
      - ./ntqq:/app/.config/QQ
33
    networks:
34
      - astrbot_network
35
networks:
36
  astrbot_network:
37
    driver: bridge

最后运行docker compose up -d

出现最后的 Crearted 和 started 就表明运行起来了

配置机器人#

配置napcat#

输入 docker logs -f napcat 来获取token

1
02-12 21:45:55 [info] [FFmpeg] 检查 Native Addon 可用性...
2
02-12 21:45:55 [info] [FFmpeg] ✓ 使用 Native Addon 适配器
3
prepare write and writev hooks
4
02-12 21:45:56 [info] [PacketHandler] 加载成功
5
02-12 21:45:56 [info] [PacketHandler] 初始化成功
6
02-12 21:45:56 [info] [NapCat] [Core] NapCat.Core Version: 4.16.0
7
02-12 21:45:56 [info] 等待网络连接...
8
02-12 21:45:56 [info] [NapCat] [WebUi] WebUi Token: 15e97279f990
9
02-12 21:45:56 [info] [NapCat] [WebUi] WebUi User Panel Url: http://127.0.0.1:6099/webui?token=15e97279f990
10
02-12 21:45:56 [info] [NapCat] [WebUi] WebUi User Panel Url: http://[::]:6099/webui?token=15e97279f990
11
02-12 21:45:56 [info] 网络已连接
12
02-12 21:45:56 [info] 没有 -q 指令指定快速登录，将使用二维码登录方式
13
02-12 21:45:56 [warn] 请扫描下面的二维码，然后在手Q上授权登录：

看到 WebUi Token 就将冒号后面的复制出来

打开浏览器，在浏览器中输入ip:6099之后，输入刚刚复制出来的token就可以看到让我们登录qq了，第一次我们使用扫码的方式登录，登录之后除了密码之外什么都不要改；

配置Astrbot#

接着我们在浏览器中输入ip:6185,就能看到Astrbot的控制台，默认账户密码均为：astrbot，进去之后我们点击机器人，点击创建机器人

选择OneBot v11，将启用的开关打开，修改第三个反向 Websocket 主机，将0.0.0.0修改为astrbot，6199与docker-compose.yml中的6199对应，如果你修改了，这里也要修改为一样的

然后点击左侧的控制台，应该就能看到连接成功了，这时我们可以想作为机器人的qq发送 /help指令来检查

Astrbot 默认账户密码均为：astrbot