文件结构

astrbot
├── data
├── napcat
│   └── config
├── ntqq
└── docker-compose.yaml

docker-compose 项目构建

• docker-compose.yaml 的内容

  services:
    astrbot:
      image: soulter/astrbot:latest
      container_name: astrbot
      restart: always
      tty: true
      stdin_open: true
      ports:
        - "6185:6185"
        - "6195:6195"
        - "6199:6199"
      volumes:
        - ./data:/AstrBot/data
        - ./napcat:/app/napcat
        - ./napcat/config:/app/napcat/config
        - ./ntqq:/app/.config/QQ
      networks:
        - astrbot_network
  
    napcat:
      image: mlikiowa/napcat-docker:latest
      container_name: napcat-docker
      restart: always
      environment:
        - MODE=astrbot
      ports:
        - 6099:6099
      volumes:
        - ./data:/AstrBot/data
        - ./napcat:/app/napcat
        - ./napcat/config:/app/napcat/config
        - ./ntqq:/app/.config/QQ
      networks:
        - astrbot_network
  
  networks:
    astrbot_network:
      driver: bridge

• docker-compose 项目构建命令

  docker-compose up -d

• 检测是否成功启动

  docker ps

web 设置

astrbot

• 访问地址

  127.0.0.1:6185

  默认用户名密码均为 astrbot​

• 服务提供商配置

  ​配置​ -> 服务提供商​ -> 服务提供商配置​

  deepseek-reasoner

• 消息平台

  ​配置​ -> 消息平台​ -> aiocqhttp​

  astrbot

napcat

• 访问地址

  127.0.0.1:6099/webui

  默认密码为 napcat​

  密码存放路径 ./astrbot/napcat/config/webui.json​

  "token": "XXXXXXXXXX" 即为密码

• ​网络配置​ - > 新建​ -> Websocket 客户端​ （新版本无需手动创建，已默认启动）

  ws://astrbot:6199/ws

文献参考

• Soulter/AstrBot: ✨易上手的多平台 LLM 聊天机器人及开发框架✨。支持 QQ、QQ频道、Telegram、微信平台(Gewechat, 企业微信)、内置 Web Chat，OpenAI GPT、DeepSeek、Ollama、Llama、GLM、Gemini、OneAPI、LLMTuner，支持 LLM Agent 插件开发，可视化面板。一键部署。支持 Dify 工作流、代码执行器、Whisper 语音转文字。
• NapNeko/NapCatQQ: 现代化的基于 NTQQ 的 Bot 协议端实现
• 最快最稳的DeepSeek，榨干微软字节两大厂，解锁知识库，联网搜索等高级功能_哔哩哔哩_bilibili​