Hermes Agent Actually Work · อ่านคู่มือให้ใช้งานจริง

อ่านเล่มนี้แบบไหนดี · How to read this PDF

Making Hermes Actually Work เป็น Book 2 ของ Hermes: มัน assume ว่า install พื้นฐานผ่านแล้ว แล้วพาอ่าน internals ที่มักทำให้ระบบพังตอนใช้งานจริง เช่น token หมดอายุ, gateway ไม่ reconnect, session key งง, profile clone แล้ว provider ไม่เปลี่ยน, และ kanban task ถูก route ผิดตัว

Making Hermes Actually Work is Hermes Book 2. It assumes the base install already exists, then explains the internals that break real operations: expired tokens, gateway reconnect loops, confusing session keys, cloned profiles keeping the wrong provider, and kanban routing to the wrong worker.

วิธีอ่านง่ายที่สุด: อย่าอ่านเป็น manual ยาว ๆ ให้อ่านเป็น failure map — ถ้าเห็นอาการนี้ ให้ตรวจชั้นนี้ก่อน

ติดตั้งบนเครื่องนี้แล้ว · Install status on this host

Mental model: 5 boxes

Token and PM2: จุดที่พังง่ายที่สุด

บทแรกของ PDF ย้ำว่า Discord bot token ไม่ใช่ string ธรรมดา แต่เป็น lifecycle object. พอ reset token ใน Developer Portal, gateway ที่ถือ token เก่าจะเจอ WebSocket close 4004 Authentication Failed ทันที

The first chapter treats the Discord bot token as a lifecycle object. Once the token is reset in the Developer Portal, a gateway still holding the old token will hit WebSocket close 4004 Authentication Failed.

Gateway: อย่าเชื่อว่า connected แปลว่าทำงานแล้ว

Gateway มีหลายชั้น: adapter รับข้อความ, session router หา address, agent runner ทำงาน, แล้ว platform adapter ส่งผลลัพธ์กลับ. ถ้าขั้นใดขั้นหนึ่งค้าง คนจะเห็นเหมือน bot เงียบทั้งที่ bridge ได้ยินแล้ว

The gateway has layers: adapter receives a message, session router builds the address, agent runner works, and the platform adapter sends the result back. If any layer stalls, the user sees silence even when the bridge heard the message.

Invariant: receive event ≠ delivered to agent ≠ replied to channel.

Session key: address ไม่ใช่ความจำ

PDF อธิบายว่า session key ถูกสร้างจาก pattern ประมาณ agent:main:<platform>:<chat_type>:<chat_id>[:thread][:user]. ดังนั้น DM, channel, thread, และ per-user grouping อาจเป็น address คนละอัน

The PDF explains that the session key is built from a shape like agent:main:<platform>:<chat_type>:<chat_id>[:thread][:user]. A DM, channel, thread, and per-user grouping may therefore land in different session addresses.

Profiles: identity แยก แต่ infrastructure บางอย่าง share

Profile ไม่ใช่แค่ชื่อเล่น. ใน Hermes มันคือ isolated directory: config, env, SOUL, sessions, memories, และ home sandbox. แต่บาง credential เช่น Codex auth อาจ fallback ไป global root auth ได้

A profile is not just a nickname. In Hermes it is an isolated directory: config, env, SOUL, sessions, memories, and a home sandbox. Some infrastructure credentials, such as Codex auth, may still fall back to the global root auth store.

Providers and auth: GLM ง่าย, Codex ต้องระวัง TTY

GLM/Z.ai เป็น API-key provider: set GLM_API_KEY แล้วเลือก provider. Codex ซับซ้อนกว่าเพราะ Hermes มี command ที่ถามยืนยันใน TTY ก่อน import token จาก Codex CLI

GLM/Z.ai is a simple API-key provider: set GLM_API_KEY and choose the provider. Codex is trickier because Hermes has an interactive confirmation step before importing tokens from Codex CLI.

บทเรียนของ PDF: ถ้า CLI ติด TTY prompt ใน automation ให้อ่าน source หา function-level path ก่อนสรุปว่าทำไม่ได้

Kanban: board คือ contract ระหว่าง engines

Hermes kanban ไม่ใช่ chat ระหว่าง agent. มันคือ SQLite board ที่ decomposer แยกงานจาก triage แล้ว route ตาม description ของ profile ไม่ใช่ตามชื่ออย่างเดียว

Hermes kanban is not agent chat. It is a SQLite board where the decomposer splits a triage task and routes work by profile description, not just by profile name.

Slash commands: 3-second defer

Discord slash commands must acknowledge within about 3 seconds. Hermes therefore has a defer path: reply fast first, do the real work after. When users see “did not respond,” it can mean defer/sync/fingerprint timing, not that the handler does not exist

Discord slash commands must acknowledge within roughly 3 seconds. Hermes therefore defers quickly, then does the real work after. “Did not respond” can be a defer/sync/fingerprint timing issue, not proof that the command is missing.

maw hermes plugin: direct REST when gateway is too much

บทท้ายของ PDF แสดง pattern ที่ตรงกับงาน fleet: ถ้าต้องการส่ง/อ่าน Discord แบบเร็วและตรวจสอบได้ ไม่จำเป็นต้องผ่าน gateway หรือ LLM เสมอไป. Maw plugin เล็ก ๆ สามารถเรียก Discord REST ตรงด้วย token จาก pass

The final chapter shows a fleet-friendly pattern: for fast, verifiable Discord read/send, you do not always need the full gateway or an LLM. A small maw plugin can call Discord REST directly with a token from pass.

Trap table แบบอ่านเร็ว

Operational checklist

1. Install Hermes CLI first; verify hermes --version.
2. Run setup/auth only in a channel that can handle secrets safely.
3. Create profiles with descriptions before using kanban routing.
4. Verify token with REST before gateway launch.
5. Use pass-wrapper if PM2 manages a gateway.
6. When something is silent, check receive → queue/session → agent → reply as four separate layers.