Skip to content

QQbot_awa_English

Nanyu edited this page Mar 26, 2026 · 6 revisions

This bot requires NapCat

Usage only for Windows:

  1. You need Python 3.8 or higher (3.9+ not verified, 3.8 works), install with pip install aiohttp websockets pycryptodome

  2. Download NapCat.Shell.Windows.OneKey.zip from NapCat releases

  3. Install NapCat, login to QQ with QR code, then exit with Ctrl+C

  4. Navigate to NapCat.Shell.Windows.OneKey\NapCat.Version.Shell\versions\version\resources\app\napcat\config\onebot11_yourQQ.json

  5. Replace with the following and save: { "network": { "httpServers": [], "httpSseServers": [], "httpClients": [], "websocketServers": [ { "name": "default", "enable": true, "host": "127.0.0.1", "port": 3001, "token": "" } ], "websocketClients": [], "plugins": [] }, "musicSignUrl": "", "enableLocalFile2Url": false, "parseMultMsg": false, "imageDownloadProxy": "", "timeout": { "baseTimeout": 10000, "uploadSpeedKBps": 256, "downloadSpeedKBps": 256, "maxTimeout": 1800000 } }

  6. Run NapBot and qqbot_client.py

Command Guide:

Use ! or

  • !ping - Test connection
  • !link [address] [password] - Link to Minecraft server !!! NOTE !!! Assuming your server address is mc.1145.com, you need to enter the link address as mc.1145.com:[port]. Please ensure that the server port is open and accessible.
  • !unlink - Disconnect server association
  • !bind - Get binding verification code
  • !unbind - Unbind account
  • !state [1/2] - Online/Invisible mode (default is 1, when set to 2, message broadcasts won't announce player join/leave)
  • !message [on/off] - Toggle broadcast notifications for server online/offline status and player join/leave
  • !disturb [start] [end]/none - Set broadcast time window (format [hhmm] [hhmm], e.g., !disturb 0600 0100 broadcasts from 6:00 AM to 1:00 AM next day)
  • !server - Check server status

awabot_config.json allows you to change the port and password.

Clone this wiki locally