QQ 机器人部署 - BrotherHong

如果你在折腾 QQ 机器人，这篇把群里常见的部署路线和易错点做了集中整理。

Docker 一键部署 AstrBot + NapCat#

以下是 docker-compose.yml 配置示例：

1
services:
2
  napcat:
3
    environment:
4
      # --- 修改点开始 ---
5
      - NAPCAT_UID=0 # 将用户ID改为 0 (root) 以解决权限问题
6
      - NAPCAT_GID=0 # 将组ID改为 0 (root)
7
      # --- 修改点结束 ---
8
      - MODE=astrbot
9
    ports:
10
      - 3002:3002
11
      - 3001:3001
12
      - 6099:6099
13
    container_name: napcat
14
    restart: always
15
    image: mlikiowa/napcat-docker:latest
16
    volumes:
17
      - ./data:/AstrBot/data
18
      - ./napcat/config:/app/napcat/config
19
      - ./opt/astrbot_share:/app/sharedFolder
20
      - ./ntqq:/app/.config/QQ # 报错就是因为无法写入这个目录
21
    networks:
22
      - astrbot_network
23
    #mac_address: "02:42:ac:11:00:02"
24

25
  astrbot:
26
    environment:
27
      - TZ=Asia/Shanghai
28
    image: soulter/astrbot:latest
29
    container_name: astrbot
30
    restart: always
31
    ports:
32
      - "6185:6185"
33
      - "6195:6195"
34
      #- "6199:6199"
35
    volumes:
36
      - ./data:/AstrBot/data
37
      - ./opt/astrbot_share:/app/sharedFolder
38
      - /root/astrbot_data/meme_generator:/usr/local/lib/python3.11/site-packages/meme_generator
39
    networks:
40
      - astrbot_network
41

42
networks:
43
  astrbot_network:
44
    driver: bridge

Docker 部署完成后，记得放行对应端口。

配置步骤#

1. 新增 QQ 平台，选择 OneBot

AstrBot 新增 QQ 平台配置

2. 按下图所示填写配置（Token 不需要与 NapCat 一致）

AstrBot OneBot 配置示例

3. 打开 NapCat 的 WebUI，在网络配置中新增 WebSocket 客户端，按图中所填即可（Token 需要双方保持一致）

NapCat WebSocket 客户端配置