Build your QQBot using NoneBot2!

This article is a reset version of: https://xfeed.app/notes/71448-13

Install Lagrange.OneBot#

Used for logging into QQ to send and receive messages

Go to Lagrange's Github Release and download the file according to your system.
Unzip and run that one file.
It will tell you that there is no configuration file; just ignore it and keep pressing enter (you can modify it if you know how).

{
    "Logging": {
        "LogLevel": {
            "Default": "Information",
            "Microsoft": "Warning",
            "Microsoft.Hosting.Lifetime": "Information"
        }
    },
    "SignServerUrl": "https://sign.lagrangecore.org/api/sign/25765",
    "MusicSignServerUrl": "",
    "Account": {
        "Uin": 0,
        "Password": "",
        "Protocol": "Linux",
        "AutoReconnect": true,
        "GetOptimumServer": true
    },
    "Message": {
        "IgnoreSelf": true,
        "StringPost": false
    },
    "QrCode": {
        "ConsoleCompatibilityMode": false
    },
    "Implementations": [
        {
            "Type": "ReverseWebSocket",
            "Host": "127.0.0.1",   // Address, ensure it matches NoneBot2 later
            "Port": 8080,   // Port, ensure it matches NoneBot2 later
            "Suffix": "/onebot/v11/ws",   // Path, default no need to change
            "ReconnectInterval": 5000,
            "HeartBeatInterval": 5000,
            "AccessToken": ""
        }
    ]
}

Wait for it to pop up a QR code, scan it.
Just leave it alone, let it be.

Install NoneBot2#

Used to implement logic and control Lagrange to send and receive messages

First, you need to install Python.
Tsinghua pypi source: pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Install pipx: pip install pipx
Set pipx global variable: pipx ensurepath
Install nb-cli: pipx install nb-cli
If you can't find the nb command: For root users, you can edit /root/.bashrc or /root/.profile (if you are using Bash): nano /root/.bashrc and add the following line: export PATH="$HOME/.local/bin:$PATH" Save and reload the configuration: source /root/.bashrc
Install nb bootstrap: nb self install nb-cli-plugin-bootstrap
Create a new project, choose a folder you like, then: nb bs (just keep pressing enter if you don't understand).

Example:

C:\afbot>nb bs
Loading adapter list...
Please enter project name
[?] Please enter > onanibot
[?] Please select the adapter you want to use OneBot V11 (OneBot V11 protocol)
Please enter Bot superuser, superuser has the highest authority over the Bot (just fill in QQ number for QQ integration) (leave blank and press enter to finish input)
[?] Item 1 >
Please enter Bot nickname, messages starting with Bot nickname can replace mentions (leave blank and press enter to finish input)
[?] Item 1 >
Please enter Bot command starting character, messages starting with this character will be recognized as commands,
If there is a command called query, when this configuration item has "/", it will only be triggered by "/query",
Leave blank to use the default ['', '/', '#'] (leave blank and press enter to finish input)
[?] Item 1 >
Please enter Bot command separator, generally used for secondary commands,
Leave blank to use the default ['.', ' '] (leave blank and press enter to finish input)
[?] Item 1 >
Please enter NoneBot2 listening address, if you want to open it to the public, change it to 0.0.0.0
[?] Please enter > 127.0.0.1
Please enter NoneBot2 listening port, range 1 ~ 65535, please ensure this port number is the same as the connection endpoint configuration or related to port mapping configuration
[?] Please enter > 8080
[?] Do you want to release a shortcut startup script in the project directory? Yes
[?] Do you want to redirect the storage path of the localstore plugin to the project path for easier subsequent migration of the Bot? Yes
[?] Do you want to use the superuser Ping command reply plugin? Yes
[?] Do you want to install the logpile plugin to provide logging to file functionality? Yes
[?] Do you want to use the webui plugin to start the project in the startup script to manage NoneBot via the web? (This plugin is still under development and not recommended for production) No
Successfully created project onanibot
[?] Do you want to create a virtual environment? Yes
Creating virtual environment in C:\afbot\onanibot\.venv
Virtual environment created successfully
[?] Do you need to modify or clear pip's PyPI mirror source configuration? No
[?] Do you want to immediately install project dependencies? Yes
Installing project dependencies
Dependencies installed successfully
[?] Please select the built-in plugins you want to enable
Project configuration completed, let's get started!

After the project is created, start it: nb run
When you see: [INFO] nonebot | OneBot V11 | Bot XXXXXXXXXX connected, you have successfully connected to Lagrange.
Test by sending /ping to see if you get a Pong~.
If you want to debug NoneBot2, please first use nb to enter the virtual environment. Then use pip install <package name>.