Phát triển Bot QQ dựa trên NapCatQQ và Python - Kết nối NapCatQQ với W1ndysBot

W1ndys Lv6
2025-01-25 20:51:30 | Tạo 2025-01-25 20:51:30 | Cập nhật 2025-05-08 22:12:44

Bot QQ
Python
| Bot QQ
| Robot QQ
| NapCatQQ

1.2k từ | 4 phút đọc

Cài đặt Windows

Dưới đây là phiên bản không giao diện người dùng và không cần cài đặt thêm phần mềm phụ trợ. Bạn cũng có thể chọn phiên bản xanh lá cây của NapCatQQ, đã tích hợp sẵn ứng dụng QQ mà không cần tải xuống QQ riêng lẻ, chỉ cần tải framework là đủ. Do tính năng tiện lợi của phiên bản xanh lá cây, khi khởi động sẽ chuyển thẳng sang màn hình đăng nhập. Sự khác biệt duy nhất giữa hai phiên bản này là tên tệp khởi động: phiên bản xanh lá cây sử dụng napcat.bat, trong khi phiên bản thông thường sử dụng launcher***.bat. Dưới đây chúng tôi sẽ không đi sâu vào chi tiết.

[Tải về QQ chính thức]( “Tải về QQ gốc”)

Hãy truy cập trang web chính thức của QQ để tải phiên bản mới nhất NT.

Địa chỉ tải: QQ - Làm chủ cuộc sống dễ dàng

[Cài đặt Framework]( “Khởi chạy framework”)

Truy cập trang release của NapCatQQ để tải framework.

Sau khi tải về, giải nén và bạn sẽ thấy một số tệp như sau:

Chọn tập lệnh phù hợp với hệ điều hành máy tính của bạn:

Đảm bảo phiên bản QQ đã được cài đặt và là phiên bản mới nhất.
Nhấp đúp vào launcher.bat để khởi động (nếu sử dụng Windows 10, hãy dùng launcher-win10.bat).

[Đăng nhập]( “Quá trình đăng nhập”)

Khi chạy các tệp đã đề cập ở trên, bạn sẽ thấy giao diện tương tự dưới đây. Có hai cách để đăng nhập, khuyến nghị sử dụng cách thứ nhất.

Nếu bạn đang sử dụng phiên bản xanh lá cây, quá trình khởi động sẽ tự động chuyển đến bước này.

[Cách đăng nhập thứ nhất]( “Đăng nhập bằng mã QR”)

Nhấn vào ô quét mã QR ở góc trên bên trái.

Sử dụng ứng dụng QQ di động để quét mã QR và hoàn tất đăng nhập. Sau khi thành công, bạn sẽ được chuyển đến trang chủ.

[Cách đăng nhập thứ hai]( “Đăng nhập bằng mã QR trong console”)

Quét mã QR hiển thị trong cửa sổ console. Tuy nhiên, do sự khác biệt giữa các loại máy tính, mã QR có thể không hiển thị đúng cách. Trong trường hợp này, bạn có thể sử dụng đường dẫn hoặc file QR code được liệt kê trong khung đỏ phía dưới ảnh chụp màn hình để tạo mã QR thay thế.

Mặc dù phương pháp này cũng cho phép đăng nhập, nhưng vì các bước tiếp j88 casino theo yêu cầu mở liên kết từ cách thứ nhất, nên chúng tôi không khuyến khích sử dụng cách này.

[Cấu hình kết nối giao thức]( “Thiết lập WebSocket”)

Sau khi đăng nhập thành công trên trang web, bạn sẽ nhìn thấy nội dung sau:

Nhấp vào Cấu hình mạng ở thanh bên trái, sau đó chọn Tạo mới, rồi thiết lập một máy chủ WebSocket theo hướng dẫn sau:

Bật công tắc
Điền bất kỳ tên nào bạn muốn (không được để trống)
Thay đổi cổng thành 3001
Đặt khoảng cách gửi tín hiệu tim thành 60000
Các cài đặt khác giữ nguyên giá trị mặc định

Xác nhận sau khi hoàn tất.

Sau khi kích hoạt, bạn sẽ thấy thông báo tương tự như sau:

01-25 13:02:25 [Thông tin] Môi trường kiểm tra Cuốn Cuốn | [Thông báo] [OneBot11] Cấu hình đã thay đổi: [network] Đã tải dịch vụ WebSocket: 0.0.0.0:3001, : Đã khởi chạy

[Cài đặt Docker]( “Triển khai qua Docker”)

Tôi cá nhân rất thích Docker vì nó giúp tôi vận hành bot trên máy chủ Linux một cách thuận tiện hơn.

Lệnh triển khai Docker như j88vip0 sau:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


docker run -d \  
--rm \  
--network host \  
-e NAPCAT_GID=$NAPCAT_GID \  
-e NAPCAT_UID=$NAPCAT_UID \  
-p 3000:3000 \  
-p 3001:3001 \  
-p 6099:6099 \  
--name napcat \  
--restart=always \  
-v ./napcat/app/.config/QQ:/app/.config/QQ \  
-v ./napcat/app/napcat:/app/napcat \  
mlikiowa/napcat-docker  

—|—
Sau khi kéo image xong, các bước còn lại giống hệt như những gì đã mô tả trước đó.

Tôi sẽ không đi sâu vào chi tiết nữa vì nếu bạn đã biết sử dụng Docker, chắc chắn bạn có thể tự khắc phục mọi lỗi phát sinh.

[Xử lý triển khai]( “Bắt đầu chương trình”)

Địa chỉ nguồn mở của W1ndysBot: W1ndysBot/W1ndysBot: Triển khai bot QQ dựa trên NapCatQQ và Python

[Giải nén chương trình vào máy cục bộ]( “Giải nén và cài đặt”)

Sau khi giải nén, bạn sẽ thấy danh sách các tệp như sau:

Môi trường ảo đã được cấu hình sẵn, bạn có thể chạy ngay mà không cần chỉnh sửa gì thêm (trừ khi bạn có kiến thức cơ bản về Python và muốn tùy chỉnh).

[Chạy chương trình]( “Khởi động chương trình”)

Tập lệnh batch đã được viết sẵn, chỉ cần nhấp đúp vào run_app.bat để khởi chạy.

Kết nối thành công sẽ hiển thị giao diện sau:

Đến đây, nghĩa là môi trường đã được thiết lập xong. Tiếp theo, chúng ta sẽ bắt đầu chỉnh sửa cấu hình.

[Cấu hình dữ liệu]( “Thiết lập cấu hình”)

Vào thư mục và tìm tệp cấu hình app/config.py. Bạn có thể sử dụng bất kỳ trình soạn thảo chuyên dụng nào hoặc thậm chí Notepad để mở tệp này.

Lưu ý!! Sau khi chỉnh sửa xong, bạn cần khởi động lại chương trình để các thay đổi có hiệu lực.

1
2
3
4
5
6


# config.py  
owner_id = ["<your_owner_id>"] # ID quản trị viên root của bot QQ, có thể thêm nhiều ID, cách nhau bởi dấu phẩy ví dụ: owner_id = ["123456", "123457"]. Lưu ý!! Đây là ID QQ của bạn chứ không phải ID của bot QQ, là tài khoản chính để kiểm soát bot.  
report_group_id = "<your_report_group_id>" # ID nhóm báo cáo  
# ws_url = "ws://127.0.0.1:8081" # Địa chỉ WebSocket API trong môi trường cục bộ  
ws_url = "ws://127.0.0.1:3001" # Địa chỉ WebSocket API trong môi trường cục bộ  
token = None # Nếu cần xác thực, hãy điền token xác thực  

—|—
Dưới đây là một ví dụ cấu hình đã chỉnh sửa:

1
2
3
4
5
6


# config.py  
owner_id = ["123456"] # ID quản trị viên root của bot QQ  
report_group_id = "123456" # ID nhóm báo cáo  
# ws_url = "ws://127.0.0.1:8081" # Địa chỉ WebSocket API trong môi trường cục bộ  
ws_url = "ws://127.0.0.1:3001" # Địa chỉ WebSocket API trong môi trường cục bộ  
token = None # Nếu cần xác thực, hãy điền token xác thực  

—|—

owner_id: ID quản trị viên root của bot QQ.
report_group_id: ID nhóm báo cáo.
ws_url: Địa chỉ WebSocket API.
token: Token xác thực.

Hai cấu hình cuối cùng phụ thuộc vào các cấu hình ban đầu, thường thì không cần chỉnh sửa.