QQ Bot — AI ใน QQ

ลองนึกภาพว่าแชทกลุ่มสุดโปรดของคุณจู่ๆ ก็มีเพื่อนอัจฉริยะที่ตอบคำถามได้ สรุปข้อความเสียงได้ และแม้แต่ส่งข้อความที่จัดรูปแบบสวยงามได้ — นั่นคือสิ่งที่ Hermes Agent มอบให้กับ QQ อย่างแท้จริง

นี่คืออะไร?

Hermes Agent เป็นเฟรมเวิร์กโอเพนซอร์สที่ให้คุณเชื่อมต่อผู้ช่วย AI เข้ากับแพลตฟอร์ม messaging ได้ QQ Bot adapter คือสะพานเชื่อมระหว่าง Hermes กับ QQ bot API อย่างเป็นทางการ มันจะคอยฟังข้อความ (แชทส่วนตัว, การ @-mention ในกลุ่ม, ช่องทางในกิลด์) และตอบกลับโดยอัตโนมัติ — ไม่ต้องเขียนโค้ดเพิ่มเติมนอกจากการตั้งค่า

工作原理 (แบบเข้าใจง่ายๆ)

ลองนึกภาพเหมือนการตั้งค่าโทรศัพท์เครื่องใหม่:

1. ขอตัวตนบอท – คุณลงทะเบียนบอทที่ q.qq.com และได้รับ App ID และ App Secret (เหมือนชื่อผู้ใช้และรหัสผ่านของบอท)
2. เชื่อมสายไฟ – Hermes เปิดการเชื่อมต่อ WebSocket แบบถาวรไปยัง gateway ของ QQ เพื่อให้ได้ยินข้อความทันที
3. สอนให้มันฟัง – คุณเป็นคนตัดสินใจว่าบอทจะเข้าร่วมการสนทนาไหนได้บ้าง: DM ส่วนตัว, การกล่าวถึงในกลุ่ม หรือช่องทางในกิลด์
4. ให้มันตอบกลับ – เมื่อมีคนส่งข้อความมา Hermes จะประมวลผลและตอบกลับด้วยข้อความหรือ markdown ที่สมบูรณ์

ขั้นตอนการตั้งค่า

1. ติดตั้ง dependencies

pip install aiohttp httpx

2. ตั้งค่าบอทของคุณ (วิธีที่ง่ายที่สุด)

hermes gateway setup

เลือก QQ Bot แล้วทำตามขั้นตอนที่แสดง มันจะถามหา App ID และ Secret ของคุณ

3. ตั้งค่าด้วยตนเอง (ถ้าคุณต้องการ)

สร้างหรือแก้ไข ~/.hermes/.env:

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

นั่นคือขั้นต่ำที่ต้องมี สำหรับการควบคุมเพิ่มเติม ให้แก้ไข ~/.hermes/config.yaml:

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

ฟีเจอร์เด็ด: ข้อความเสียง

QQ ให้บริการถอดเสียงฟรี (Tencent’s ASR) สำหรับทุกข้อความเสียง หากล้มเหลว Hermes สามารถสำรองไปใช้ผู้ให้บริการ STT ที่กำหนดเองได้ เช่น GLM-ASR หรือ OpenAI Whisper ซึ่งหมายความว่าบอทของคุณสามารถ “ได้ยิน” ข้อความเสียงและตอบกลับด้วยบทสรุปที่เป็นข้อความได้

การตั้งค่าความปลอดภัยที่คุณควรรู้

• QQ_ALLOWED_USERS – จำกัด DM เฉพาะ OpenID ที่กำหนด (ค่าเริ่มต้น: ทุกคน)
• QQ_GROUP_ALLOWED_USERS – จำกัดการเข้าถึงกลุ่มเฉพาะ OpenID ของกลุ่มที่กำหนด
• dm_policy / group_policy – ตั้งเป็น "allowlist" เพื่อการควบคุมที่เข้มงวด หรือ "disabled" เพื่อปิดช่องทางนั้นทั้งหมด

สรุป & เคล็ดลับการใช้งานจริง

การเชื่อมต่อ Hermes เข้ากับ QQ ก็เหมือนการให้ผู้ช่วยส่วนตัวกับแชทกลุ่มของคุณ — ใช้เวลาตั้งค่าประมาณ 10 นาที จากนั้นคุณก็ปรับแต่งได้ทุกอย่าง ตั้งแต่ใครที่คุยกับมันได้ ไปจนถึงรองรับ markdown หรือการถอดเสียงหรือไม่

เคล็ดลับสำหรับมือใหม่: เริ่มต้นใน โหมด sandbox (ตั้งค่า QQ_PORTAL_HOST=sandbox.q.qq.com) ทดสอบกับบัญชีของคุณเองก่อน แล้วค่อยๆ เปิดให้เพื่อนใช้งาน และอย่าลืมตั้งค่า QQ_ALLOWED_USERS เป็น OpenID ของตัวเองก่อนเปิดให้สาธารณะ — คุณไม่ต้องการให้คนแปลกหน้ามาคุยกับบอทของคุณตั้งแต่วันแรก

เมื่อใช้งานจริงแล้ว ลองให้บอทของคุณสรุปข้อความเสียงยาวๆ หรือจัดรูปแบบประกาศด่วนดู — นั่นคือจุดที่ความมหัศจรรย์เกิดขึ้นจริง