ใช้ Hermes Agent ผ่าน Discord: ตั้งค่า Bot, Gateway, สิทธิ์ และ Session อย่างปลอดภัย

Hermes Agent ใช้งานผ่าน Discord ได้ทั้งข้อความส่วนตัวและ channel ในเซิร์ฟเวอร์ แต่ Bot ที่ออนไลน์ไม่ได้แปลว่าตั้งค่าปลอดภัยหรือจำบริบทอย่างที่คาด บทความนี้พาไล่จาก Discord Developer Portal ไปถึง Hermes Gateway พร้อมอธิบาย mention, allowlist, thread และการแยก session ซึ่งมีผลต่อทั้งความเป็นส่วนตัวและค่าใช้จ่าย

ผู้ใช้ส่งข้อความผ่านกลุ่มช่องสนทนาไปยังเอเจนต์ที่มีโล่ควบคุมสิทธิ์ก่อนตอบกลับสมาชิก

Discord รับส่งข้อความ ส่วน Hermes Gateway ประมวลผลงานของ Agent

การเชื่อม Discord ของ Hermes ไม่ใช่ webhook ที่รับข้อความแล้วตอบแบบไร้สถานะ ข้อความขาเข้าจะผ่านการตรวจผู้ใช้และ mention ค้นหา session โหลดประวัติ จากนั้นจึงเข้า agent loop ปกติซึ่งอาจเรียก tools, memory และ skills ก่อนส่งคำตอบกลับ Discord

ผู้ใช้ใน Discord
→ Discord Gateway event
→ Hermes Messaging Gateway
→ ตรวจ allowlist / channel / mention
→ โหลด session และบริบท
→ Agent เรียกโมเดลและ tools ตามสิทธิ์
→ ส่งคำตอบกลับ DM, channel หรือ thread

ผลคือ Discord เป็นเพียงหน้าสนทนา เครื่องที่รัน hermes gateway ต้องออนไลน์และเข้าถึง provider ได้ หาก Gateway หยุด Bot อาจแสดง offline หรือไม่รับ event และงาน cron ที่พึ่ง Gateway จะไม่ทำงานตามที่คาด

สร้าง Discord Application แล้วเปิดเฉพาะ Intents ที่ Hermes ต้องใช้

เริ่มที่ Discord Developer Portal เลือก New Application ตั้งชื่อ แล้วเปิดหน้า Bot เพื่อรับ bot user ของแอป จากนั้นเปิด Message Content Intent เพราะ Hermes ต้องอ่านข้อความเพื่อส่งเข้า agent pipeline เอกสาร Hermes แนะนำ Server Members Intent สำหรับการ resolve username และจำเป็นเมื่อใช้ username หรือ role เป็น allowlist ส่วน Presence Intent ไม่จำเป็นสำหรับการสนทนาปกติ

  1. สร้าง Application และเปิดหน้า Bot
  2. สร้างหรือ reset token แล้วคัดลอกไปใช้ครั้งเดียวในตัวช่วยตั้งค่า
  3. เปิด Message Content Intent
  4. เปิด Server Members Intent เมื่อใช้ username หรือ role allowlist
  5. กด Save Changes ก่อนออกจากหน้า

Bot token มีอำนาจยืนยันตัวตนเป็น Bot ไม่ใช่ข้อความที่ควรส่งให้ Hermes วิเคราะห์หรือวางใน channel หาก token หลุด ให้ reset จาก Developer Portal และอัปเดตค่าในเครื่องทันที ไม่ควรพยายามลบเพียงข้อความต้นทางแล้วใช้ token เดิมต่อ

ตอนเชิญ Bot เข้า server ให้ใช้สิทธิ์ขั้นต่ำที่งานต้องใช้ เอกสาร Hermes ระบุแกนหลักเป็น View Channels, Send Messages, Embed Links, Attach Files และ Read Message History หากใช้ thread จึงเพิ่ม Create Public Threads และ Send Messages in Threads ส่วนสิทธิ์ Connect/Speak ใช้เมื่อทำงานกับ voice channel จริงเท่านั้น ผู้เชิญต้องมีสิทธิ์ Manage Server

ใช้ตัวช่วย Gateway ตั้ง token และ allowlist แทนการเปิดรับทุกคน

ก่อนเชื่อม Discord ควรให้ Hermes สนทนาจาก CLI กับ provider ได้อย่างน้อยหนึ่งรอบ จากนั้นรัน:

hermes gateway setup

เลือก Discord แล้ววาง bot token ใน prompt ของตัวช่วย ตัวช่วยปัจจุบันตรวจ token กับ Discord แจ้งหาก Message Content Intent ปิด สร้างลิงก์เชิญ และเสนอให้เพิ่มเจ้าของ Bot เข้า allowlist โดยไม่ต้องคัดลอก User ID เองในเส้นทางปกติ

ถ้าจำเป็นต้องตั้งค่าเอง ค่า secret และ allowlist อยู่ใน ~/.hermes/.env:

DISCORD_BOT_TOKEN=ใส่-token-จริงในไฟล์บนเครื่องเท่านั้น
DISCORD_ALLOWED_USERS=ใส่-Discord-user-id-ที่อนุญาต

ตัวอย่างข้างบนเป็น placeholder ห้ามคัดลอกพร้อมข้อความไทยไปใช้เป็น token จริง และห้าม commit ไฟล์ .env หลังตั้งค่าให้ทดสอบ foreground ก่อน:

hermes gateway run

เมื่อ Bot ออนไลน์และตอบ DM หรือ mention ได้ จึงติดตั้ง background service:

hermes gateway install
hermes gateway status

DM, channel และ thread ใช้กฎการตอบและบริบทต่างกัน

พื้นที่ค่าเริ่มต้นผลต่อบริบท
DMตอบทุกข้อความ ไม่ต้อง @mentionแต่ละ DM มี session ของตนเอง
Server channelตอบเมื่อ @mention Botค่าเริ่มต้นแยก session ตามผู้ใช้ภายใน channel
Free-response channelตอบได้โดยไม่ mention เมื่อกำหนด channel ไว้ตอบ inline โดยค่าเริ่มต้น ควรใช้เฉพาะห้องที่ตั้งใจให้เป็นพื้นที่คุยกับ Bot
Threadตอบใน thread เดิมตามกฎ mention ที่ตั้งไว้ประวัติแยกจาก parent channel ต้องตรวจค่า require_mention และ thread_require_mention ของรุ่นจริง

สำหรับการใช้ส่วนตัว เริ่มจาก DM ลดเสียงรบกวนและควบคุมผู้ใช้ได้ง่ายกว่า ใน server คง require_mention ไว้เพื่อไม่ให้ Bot แทรกทุกบทสนทนา หากต้องการห้องช่วยงานโดยเฉพาะ ให้เพิ่มเฉพาะ Channel ID นั้นใน free-response channels แทนการปิด mention ทั้ง server

เอกสาร Discord ปัจจุบันระบุ thread_require_mention เป็น false โดยค่าเริ่มต้น เมื่อบอตเคยร่วม thread แล้วจึงตอบข้อความถัดไปได้โดยไม่ต้อง mention ซ้ำ ส่วน true บังคับให้เรียกชื่อใน thread ด้วย ค่านี้ต้องอ่านแยกจาก require_mention ของห้องหลัก สำหรับหลายบอตให้ตั้ง thread_require_mention: true และทดสอบข้อความที่เรียกชื่อกับไม่เรียกชื่อก่อนเปิดใช้จริง

เมื่อมี Bot หลายตัวใน thread เดียว ควรตั้ง discord.thread_require_mention: true ตามคำเตือนในเอกสาร เพื่อไม่ให้ Bot ทุกตัวตอบข้อความเดียวกันหลังเข้าร่วม thread แล้ว ซึ่งอาจสร้างทั้ง spam และค่า model calls ที่ไม่ตั้งใจ

Allowlist ตอบว่าใครเรียกได้ ส่วน Session กำหนดว่าใครเห็นบริบทร่วมกัน

Hermes ปัจจุบันใช้แนวทาง fail closed สำหรับ Discord หากไม่มี DISCORD_ALLOWED_USERS, role, channel scope หรือการเปิด allow-all อย่างชัดเจน Gateway อาจเชื่อมต่อสำเร็จแต่ปฏิเสธข้อความขาเข้า นี่เป็นพฤติกรรมที่ปลอดภัยกว่า Bot เปิดรับทุกคนโดยไม่ตั้งใจ

ค่า group_sessions_per_user: true เป็นค่าเริ่มต้น ทำให้ Alice และ Bob ที่คุยกับ Hermes ใน channel เดียวกันยังมีประวัติแยกกัน หากเปลี่ยนเป็น false ทุกคนในห้องจะแชร์ transcript, context growth, token cost และ running-agent slot เดียวกัน ข้อความจากคนหนึ่งอาจต่อบริบทหรือขัดจังหวะงานของอีกคนได้ จึงควรใช้ shared session เฉพาะห้องร่วมงานที่สมาชิกยอมรับขอบเขตนี้แล้ว

เมื่อ Bot ออนไลน์แต่ไม่ตอบ ให้ตรวจสิทธิ์เข้าถึงก่อน

  1. Bot offline: ตรวจว่า Gateway กำลังทำงานและ Message Content Intent เปิดอยู่ หาก Discord ปฏิเสธ privileged intents ตัวเชื่อมต่อจะไม่พร้อมรับข้อความ
  2. Bot online แต่เงียบ: ตรวจ allowlist, role หรือ channel policy ใน ~/.hermes/logs/gateway.log เพราะการไม่มี access policy จะปฏิเสธข้อความโดยค่าเริ่มต้น
  3. ตอบ DM แต่ไม่ตอบ channel: @mention Bot โดยตรง ตรวจสิทธิ์ View Channels/Send Messages และดูว่า channel อยู่ใน ignored list หรือไม่
  4. ตอบครั้งแรกแต่เงียบภายหลัง: ตรวจสถานะ Gateway WebSocket และ log ไม่ใช้ผล REST check เพียงอย่างเดียวตัดสินว่า event stream ยังทำงาน
  5. หลายคนเห็นบริบทปนกัน: ตรวจ group_sessions_per_user และพิจารณาแยก thread สำหรับงานแต่ละเรื่อง
  6. หลาย Bot ตอบพร้อมกัน: เปิด thread_require_mention และระบุ Bot ที่ต้องการด้วย @mention

หลังแก้ค่าให้รีสตาร์ตและตรวจสถานะด้วยคำสั่งของ Hermes แทนการเปิด process ซ้ำ:

hermes gateway restart
hermes gateway status
hermes logs -f

การตั้งค่าที่เหมาะสำหรับเริ่มต้นคือ DM หรือ channel เฉพาะหนึ่งห้อง, allowlist ด้วย User ID, require mention ใน server, session แยกตามผู้ใช้ และ tool permissions เท่าที่ต้องใช้ เมื่อ workflow นี้ทำงานและอ่าน log เข้าใจแล้วจึงค่อยเพิ่ม free-response channel, shared session, voice หรือหลาย Bot วิธีนี้ทำให้ Discord เป็นทางเข้าที่สะดวกโดยไม่กลายเป็นช่องทางเปิดกว้างสู่ Agent ที่มีสิทธิ์เกินจำเป็น

ตั้งเครื่องให้ทำงานต่อเนื่องรัน Hermes Agent บน Raspberry Pi 4 8GBใช้ Raspberry Pi เป็นเครื่องรัน Hermes Gateway สำหรับรับข้อความจาก Discord ได้ตลอดเวลา

แหล่งอ้างอิง

ตรวจสอบเอกสาร Hermes และ Discord เมื่อ 11 ตุลาคม 2569 หน้าตา Developer Portal เกณฑ์ privileged intents ค่าเริ่มต้น และคำสั่ง Gateway อาจเปลี่ยนได้ ห้ามเผยแพร่ Discord bot token, API key หรือไฟล์ .env ใน screenshot, repository หรือข้อความสนทนา