QQ Bot — AI trên QQ

Hãy tưởng tượng nhóm chat yêu thích của bạn bỗng có một người bạn cực kỳ thông minh, có thể trả lời câu hỏi, tóm tắt tin nhắn thoại, thậm chí gửi tin nhắn định dạng đẹp mắt — đó chính xác là những gì Hermes Agent mang đến cho QQ.

Đây Là Gì?

Hermes Agent là một framework mã nguồn mở cho phép bạn kết nối trợ lý AI với các nền tảng nhắn tin. Bộ chuyển đổi QQ Bot là cầu nối giữa Hermes và API bot chính thức của QQ. Nó lắng nghe tin nhắn (chat riêng, @đề cập trong nhóm, kênh guild) và tự động phản hồi — không cần viết code gì ngoài khâu thiết lập ban đầu.

Cách Hoạt Động (Giải Thích Đơn Giản)

Cứ nghĩ như việc thiết lập một chiếc điện thoại mới:

1. Tạo danh tính bot – Bạn đăng ký bot tại q.qq.com và nhận App ID cùng App Secret (giống như tên đăng nhập và mật khẩu cho bot của bạn).
2. Kết nối các dây – Hermes mở một kết nối WebSocket liên tục đến cổng gateway của QQ, vì vậy nó nghe được tin nhắn ngay lập tức.
3. Dạy nó lắng nghe – Bạn quyết định bot có thể tham gia những cuộc trò chuyện nào: tin nhắn riêng, đề cập trong nhóm, hoặc kênh guild.
4. Để nó trả lời – Khi ai đó gửi tin nhắn, Hermes xử lý và phản hồi bằng văn bản hoặc markdown phong phú.

Hướng Dẫn Thiết Lập Từng Bước

1. Cài đặt các thư viện phụ thuộc

pip install aiohttp httpx

2. Cấu hình bot của bạn (cách dễ nhất)

hermes gateway setup

Chọn QQ Bot và làm theo hướng dẫn. Nó sẽ hỏi App ID và Secret của bạn.

3. Cấu hình thủ công (nếu bạn thích)

Tạo hoặc chỉnh sửa tệp ~/.hermes/.env:

QQ_APP_ID=your-app-id
QQ_CLIENT_SECRET=your-app-secret

Đó là phần tối thiểu. Để kiểm soát nhiều hơn, hãy chỉnh sửa ~/.hermes/config.yaml:

platforms:
  qqbot:
    enabled: true
    extra:
      markdown_support: true
      dm_policy: "open"   # open | allowlist | disabled
      group_policy: "open"

Tính Năng Thú Vị: Tin Nhắn Thoại

QQ cung cấp tính năng chuyển giọng nói thành văn bản miễn phí (ASR của Tencent) cho mọi tin nhắn thoại. Nếu tính năng đó thất bại, Hermes có thể chuyển sang nhà cung cấp STT tùy chỉnh như GLM-ASR hoặc OpenAI Whisper. Điều này có nghĩa bot của bạn có thể “nghe” các ghi chú thoại và trả lời bằng bản tóm tắt văn bản.

Các Cài Đặt Bảo Mật Bạn Nên Biết

• QQ_ALLOWED_USERS – giới hạn tin nhắn riêng cho các OpenID cụ thể (mặc định: tất cả mọi người)
• QQ_GROUP_ALLOWED_USERS – giới hạn quyền truy cập nhóm cho các OpenID nhóm cụ thể
• dm_policy / group_policy – đặt thành "allowlist" để kiểm soát chặt chẽ, hoặc "disabled" để tắt hoàn toàn kênh đó

Tóm Tắt & Mẹo Thực Tế

Kết nối Hermes với QQ giống như tặng nhóm chat của bạn một trợ lý cá nhân — chỉ mất khoảng 10 phút thiết lập, và sau đó bạn có thể tùy chỉnh mọi thứ từ ai có thể trò chuyện với nó, đến việc nó có hỗ trợ markdown hay chuyển giọng nói thành văn bản hay không.

Mẹo của tôi cho người mới bắt đầu: Hãy bắt đầu ở chế độ sandbox (đặt QQ_PORTAL_HOST=sandbox.q.qq.com). Kiểm tra với tài khoản của chính bạn trước, sau đó dần dần mở cho bạn bè. Và luôn đặt QQ_ALLOWED_USERS thành OpenID của chính bạn trước khi công khai — bạn không muốn người lạ trò chuyện với bot của mình ngay từ ngày đầu tiên đâu.

Khi bot đã hoạt động, hãy thử yêu cầu bot tóm tắt một tin nhắn thoại dài hoặc định dạng một thông báo nhanh — đó chính là lúc phép màu thực sự tỏa sáng.