מדריכיםחיבור Hermes Agent לשער הקול

חיבור Hermes Agent לשער הקול

החיבור שומר את Hermes כמוח של השיחה ומוסיף טלפוניה וקול.

כיצד החיבור בנוי

Hermes נשאר backend הסוכן. שער הקול מתחבר ל-API המקומי שלו, מזרים את תורות השיחה ומקבל תשובה. טלפוניה ציבורית אינה ניגשת ל-Hermes ישירות.

  • Hermes API על localhost
  • gateway כמתאם
  • TTMA עבור טלפוניה
  • אותו persona וזיכרון

דרישות מוקדמות

  • Hermes Agent פעיל
  • גישה מקומית ל-API
  • Node ו-gateway נתמכים
  • SOUL.md, USER.md ו-MEMORY.md במיקום ידוע
  • מספר Owner לבדיקות

הפעלת Hermes API

הפעילו את מצב השרת לפי גרסת Hermes ובדקו endpoint מקומי לפני התקנת gateway. bind צריך להישאר loopback אלא אם קיימת שכבת רשת מאובטחת ומפורשת.

http://127.0.0.1:<port>

Session shim וזיכרון תוך-שיחתי

ה-shim שומר session יציב לכל call ID כדי שהסוכן לא יאבד הקשר בין תורות. הוא נדרש גם אם Hermes עובד היטב בצ'אט חד-פעמי.

  • session אחד לכל שיחה
  • ניקוי בסיום
  • אין ערבוב בין מתקשרים
  • timeout מתועד

התקנת gateway וחיבור ל-Hermes

התקינו עם פרופיל Hermes, הגדירו backend URL מקומי והפעילו מחדש. בדקו health לפני שיחת קול.

  • backend type נכון
  • URL ופורט
  • authentication אם מופעל
  • לוג ללא token

persona וקובצי workspace

ודאו שה-gateway טוען את אותם קבצים ש-Hermes משתמש בהם. נתיב שגוי יוצר קול גנרי גם כשהחיבור עצמו תקין.

  • SOUL.md
  • IDENTITY.md
  • USER.md
  • MEMORY.md לפי צורך

כיוון features

openclawQuery יכול להישאר פעיל כאשר החיבור תומך בו; kbSearch ו-crmCapture מופעלים רק אם ה-backend מספק את החוזה הנדרש; dispatch נשאר כבוי ללא consumer מתאים.

  • אין feature לפי שם בלבד
  • בדקו כל capability
  • כשל צריך fallback ברור

אימות ופתרון תקלות

הריצו שיחה עם שני תורות, בקשת זיכרון וכלי אחד. שכחה באמצע מצביעה על session; backend unreachable על URL; persona שגוי על נתיבי קבצים; 401 על authentication.

  • בדקו health
  • בדקו session ID
  • בדקו file paths
  • בדקו token ו-clock

בדיקת בטיחות

אל תחשפו את Hermes API ישירות לאינטרנט.