ใช้ 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 ไม่จำเป็นสำหรับการสนทนาปกติ
- สร้าง Application และเปิดหน้า Bot
- สร้างหรือ reset token แล้วคัดลอกไปใช้ครั้งเดียวในตัวช่วยตั้งค่า
- เปิด Message Content Intent
- เปิด Server Members Intent เมื่อใช้ username หรือ role allowlist
- กด 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 เปิดรับทุกคนโดยไม่ตั้งใจ
- ใช้ User ID เมื่อทำได้: ไม่เปลี่ยนตาม display name และไม่ต้องพึ่งการ resolve ชื่อ
- ใช้ role เมื่อทีมเปลี่ยนสมาชิกบ่อย: ผู้ที่ได้รับ role จะได้สิทธิ์ตามนโยบาย แต่ต้องเปิด Server Members Intent ตามเงื่อนไข
- อย่าเปิด allow-all เพื่อแก้ Bot ไม่ตอบ: ตรวจ log และ allowlist ก่อน เพราะการแก้แบบนี้ขยายขอบเขตผู้ใช้ทันที
- จำกัด command แยกจากแชต: เอกสารรองรับรายการ admin และคำสั่งที่ผู้ใช้ทั่วไปเรียกได้ ทำให้พูดคุยได้โดยไม่ให้ทุกคนใช้ slash command ทั้งหมด
ค่า group_sessions_per_user: true เป็นค่าเริ่มต้น ทำให้ Alice และ Bob ที่คุยกับ Hermes ใน channel เดียวกันยังมีประวัติแยกกัน หากเปลี่ยนเป็น false ทุกคนในห้องจะแชร์ transcript, context growth, token cost และ running-agent slot เดียวกัน ข้อความจากคนหนึ่งอาจต่อบริบทหรือขัดจังหวะงานของอีกคนได้ จึงควรใช้ shared session เฉพาะห้องร่วมงานที่สมาชิกยอมรับขอบเขตนี้แล้ว
เมื่อ Bot ออนไลน์แต่ไม่ตอบ ให้ตรวจสิทธิ์เข้าถึงก่อน
- Bot offline: ตรวจว่า Gateway กำลังทำงานและ Message Content Intent เปิดอยู่ หาก Discord ปฏิเสธ privileged intents ตัวเชื่อมต่อจะไม่พร้อมรับข้อความ
- Bot online แต่เงียบ: ตรวจ allowlist, role หรือ channel policy ใน
~/.hermes/logs/gateway.logเพราะการไม่มี access policy จะปฏิเสธข้อความโดยค่าเริ่มต้น - ตอบ DM แต่ไม่ตอบ channel: @mention Bot โดยตรง ตรวจสิทธิ์ View Channels/Send Messages และดูว่า channel อยู่ใน ignored list หรือไม่
- ตอบครั้งแรกแต่เงียบภายหลัง: ตรวจสถานะ Gateway WebSocket และ log ไม่ใช้ผล REST check เพียงอย่างเดียวตัดสินว่า event stream ยังทำงาน
- หลายคนเห็นบริบทปนกัน: ตรวจ
group_sessions_per_userและพิจารณาแยก thread สำหรับงานแต่ละเรื่อง - หลาย 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 ที่มีสิทธิ์เกินจำเป็น
แหล่งอ้างอิง
- Nous Research: Hermes Agent Discord Setup
- Nous Research: Messaging Gateway
- Nous Research: Hermes Agent Quickstart
- Discord Developer Support: What are Privileged Intents?
- Discord Developer Documentation: OAuth2 and Bot Users
- NousResearch/hermes-agent
ตรวจสอบเอกสาร Hermes และ Discord เมื่อ 11 ตุลาคม 2569 หน้าตา Developer Portal เกณฑ์ privileged intents ค่าเริ่มต้น และคำสั่ง Gateway อาจเปลี่ยนได้ ห้ามเผยแพร่ Discord bot token, API key หรือไฟล์ .env ใน screenshot, repository หรือข้อความสนทนา