איך לחבר את Hermes Agent לטלגרם ולנהל משימות מהטלפון

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

אם עדיין אין לכם את Hermes, התחילו במדריך על מהו הסוכן הזה ואיך מתקינים אותו, ואז חזרו כדי לחבר את Telegram.

הנחיות נוספות זמינות בתיעוד של Ailoot.

מה צריך כדי לחבר את Hermes Agent לטלגרם?#

הפקודה hermes doctor בודקת את התקנת Hermes ואת החיבור למודל. ניצור את הבוט באפליקציית Telegram, ותצטרכו מחשב כדי להריץ פקודות במסוף.

איך יוצרים בוט דרך BotFather?#

לכל בוט בטלגרם יש אסימון — מפתח סודי לשליטה בבוט. האסימון מונפק על ידי הבוט הרשמי של Telegram,‏ @BotFather.

1. פתחו את @BotFather

   חפשו את @BotFather בטלגרם או פתחו את t.me/BotFather. ל-BotFather האמיתי יש סימן אימות כחול. התחילו את השיחה בלחיצה על „Start”.

2. שלחו את הפקודה /newbot

   BotFather יבקש שני שמות. הראשון הוא השם שיוצג, והוא יכול להיות כל שם, למשל „My Agent”. השני הוא שם המשתמש: עליו להיות ייחודי ולהסתיים ב-bot, למשל moy_agent_bot.

3. קבלו את האסימון

   BotFather ישלח הודעת ברכה ומחרוזת ארוכה בתבנית 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. זהו האסימון של הבוט. העתיקו את המחרוזת כולה.

יש גם דרך מהירה שאינה דורשת שיחה ידנית עם BotFather. בלוח הבקרה האינטרנטי של Hermes (hermes dashboard) וביישום למחשב, בעמוד “Messaging → Telegram”, יש כפתור “Create with QR”: סרקו את הקוד בטלפון, ו-Hermes ייצור בוט, יזהה את המזהה שלכם, ישמור את האסימון בהגדרות ויפעיל מחדש את השער. השלבים שלהלן מתארים את השיטה הידנית; אם בחרתם באפשרות QR, עברו ישר לבדיקת החיבור.

איך מוצאים את מזהה הטלגרם שלכם, ולמה צריך אותו?#

לחשבון Telegram יש שני מזהים: שם משתמש ציבורי עם סימן @ ומזהה מספרי פנימי. Hermes משתמש במספר.

אתרו את המזהה המספרי שלכם ואת האסימון. רשמו את שניהם כדי להשתמש בהם ברשימת הגישה.

איך מוסרים את האסימון ל-Hermes Agent ומפעילים את השער?#

1. הפעילו את אשף ההגדרה

   hermes gateway setup
   

   הריצו את הפקודה במחשב שבו Hermes מותקן. האשף יציג רשימה של יישומי מסרים.

2. בחרו ב-Telegram והזינו את הפרטים שלכם

   האשף יבקש את האסימון של הבוט ואת המזהים המורשים (אפשר להזין כמה, מופרדים בפסיקים), וישמור את כל הפרטים בהגדרות עצמן.

3. הפעילו את השער

   hermes gateway
   

   השער יופעל ויתחבר ל-Telegram. כעבור כמה שניות, שלחו לבוט הודעה כלשהי מהאפליקציה: אם Hermes משיב, החיבור מוכן.

כך נראית השיטה הידנית במקום שימוש באשף: פתחו את הקובץ ~/.hermes/.env והוסיפו שתי שורות, תוך החלפת הערכים באסימון שקיבלתם מ-BotFather ובמזהה המספרי שלכם:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

השורה השנייה מתירה לאנשים האלה גישה בשיחות פרטיות ובקבוצות; הרשאה נפרדת לשיחה קבוצתית יכולה גם להעניק גישה. הפרידו בין כמה אנשים באמצעות פסיקים. אחרי שמירת הקובץ, הפעילו את השער באמצעות אותה פקודה: hermes gateway.

אם הבוט שותק גם בשיחה פרטית, בדקו את יומני השער באותו מסוף, ובראש ובראשונה ודאו שהאסימון והמזהה שלכם ברשימת הגישה נכונים; שגיאות אחרות מפורטות בטבלה בסוף המאמר.

מה אפשר לעשות עם בוט Telegram בטלפון?#

יש חמש יכולות שבהן תשתמשו לרוב בטלפון.

הודעות טקסט וקול. כתבו משימה במילים או הכתיבו הודעה קולית — אם הגדרתם זיהוי דיבור, Hermes יתמלל אותה ויבין אותה. עם ספק מקומי אין צורך במפתחות; העיבוד כולו מתבצע במחשב שבו הסוכן פועל.

קבצים ותמונות. תוכלו להעביר לבוט מסמך, גיליון אלקטרוני או צילום מסך — הסוכן יקבל אותם כקובץ מצורף. הוא יכול גם לשלוח בחזרה קבצים שנוצרו: בקשו דוח, והוא ישלח אותו כקובץ בצ'אט.

אישורים לפעולות מסוכנות. כשהסוכן עומד לבצע פעולה מסוכנת, כמו מחיקת קבצים, הוא יבקש קודם אישור בצ'אט: השיבו “yes” או “y” והוא יבצע אותה; השיבו “no” או “n” והוא יבטל אותה.

כפתורים במקום הקלדה. כשהסוכן זקוק להבהרה, הוא ישלח שאלה עם כפתורי אפשרויות מוטבעים — הקישו על אפשרות, והסוכן ימשיך לעבוד. הפקודה /model ללא ארגומנטים מציגה תפריט בחירת מודל עם כפתורים דומים.

התראות שקטות. כברירת מחדל, הטלפון מצלצל רק עבור תשובות סופיות, בקשות אישור ואישורי פקודות. התראות שירות כגון “calling a tool” ו-“compressing context” מגיעות בשקט, כך שהטלפון אינו מצלצל בכל שלב. אם תרצו לקבל התראות עם צליל בכל שלב, שנו את המצב בהגדרות.

איך מקבלים בצ'אט תוצאות של משימות שרצות ברקע?#

שיחה ביתית למשימות מתוזמנות. Hermes תומך במשימות מתוזמנות: „כל בוקר ב-7:43, הכין לי סיכום”. הוא שולח את התוצאות לשיחה הביתית, שאותה מגדירים פעם אחת באמצעות הפקודה /sethome ישירות בשיחה עם הבוט. כל עוד השער פועל, הסיכומים מגיעים אוטומטית.

משימות רקע. תוכלו לשלוח משימה ארוכה לביצוע ברקע ולהמשיך ביום שלכם: הבוט ישלח לכם הודעה כשהמשימה תהיה מוכנה. משימה שהתחילה מתוך נושא תחזיר את התשובה לאותו נושא, כך ששום דבר לא יאבד.

מגבלה חשובה: הבוט משיב רק כשהשער פועל. אם תכבו את המחשב שמריץ את Hermes או תכניסו אותו למצב שינה, הבוט לא ישיב עד שהמחשב יפעל שוב. כדי להשאיר את הבוט מקוון כל הזמן, העבירו את הסוכן לשרת: יש לנו מדריך נפרד על איך להשאיר את Hermes Agent פועל מסביב לשעון. כברירת מחדל, השער בודק אם יש הודעות חדשות בטלגרם; בפלטפורמות ענן שנכנסות למצב שינה כשאין תעבורה נכנסת, התיעוד מציע מצב webhook, שהופך את כיוון החיבור כך ש-Telegram עצמו שולח בקשות לבוט.

איך מונעים מזרים להשתמש בבוט?#

אפשר למצוא את הבוט שלכם בחיפוש של Telegram לפי שם המשתמש שלו, ולכן ההגנה נשענת על שני דברים: רשימת הגישה ושמירת האסימון בסוד.

ראשית, הגדירו גישת שולחים באמצעות TELEGRAM_ALLOWED_USERS. לקבוצות בדקו גם את TELEGRAM_GROUP_ALLOWED_CHATS: רישום שיחה שם מתיר לכל אחד מחבריה, גם כשמזהה השולח שלו אינו ברשימת ההרשאה האישית. לכן רשימה אישית ריקה לבדה אינה מוכיחה שכל הקבוצות סגורות.

שנית, יש את האסימון. אסור שהוא יופיע בצילומי מסך, בהודעות שהועברו או במאגרים. אם האסימון נחשף, בטלו אותו באמצעות הפקודה /revoke ב-BotFather. לאחר מכן הזינו את האסימון החדש בהגדרות והפעילו מחדש את השער.

הערה נפרדת לגבי קבוצות: הרשאת שולח והרשאת שיחה הן דברים שונים. חבר בקבוצה שהותרה באמצעות TELEGRAM_GROUP_ALLOWED_CHATS יכול להשתמש בבוט גם אם מזההו אינו ב-TELEGRAM_ALLOWED_USERS. אם הגישה חייבת להישאר אישית, אל תעניקו גישה לקבוצה כולה; הגדירו ואמתו הגבלות שולחים לגרסה שהתקנתם. אם תרצו שהבוט ישיב בקבוצה רק כשפונים אליו, קיימת ההגדרה telegram.require_mention — ואז הוא משיב לאזכור @, לתשובה להודעה שלו, לפקודה כמו /command@yourbot ולתבניות שתואמות ב-telegram.mention_patterns, ומתעלם מהודעות רגילות בקבוצה.

למה הבוט שותק בקבוצה, ואיך פותרים זאת?#

בוטים חדשים של Telegram מגיעים כשמצב הפרטיות מופעל כברירת מחדל; בתיעוד של Hermes מצוין שזהו מקור הבלבול הנפוץ ביותר עם בוטים בקבוצות. במצב הזה הבוט מקבל רק הודעות שמתחילות בפקודה עם /, תשובות להודעות שלו והתראות שירות. הוא פשוט לא מקבל הודעות רגילות בקבוצה — Telegram לא שולח אותן אליו, ושום הגדרה של הסוכן לא תפתור זאת.

כך פותרים את הבעיה:

1. פתחו את @BotFather ושלחו /mybots.
2. בחרו את הבוט שלכם.
3. פתחו את “Bot Settings” → “Group Privacy” → “Turn off”.
4. הסירו את הבוט מהקבוצה והוסיפו אותו מחדש.

קל לפספס את השלב הרביעי, ואז הבוט „עדיין נשאר שקט”. Telegram זוכר את הגדרת הפרטיות שהייתה פעילה כשהבוט הצטרף לקבוצה, ולא מעדכן אותה עד שמסירים את הבוט מהקבוצה ומוסיפים אותו מחדש.

אם אינכם רוצים לכבות את הפרטיות באופן גורף, יש אפשרות שנייה: הפכו את הבוט למנהל קבוצה. בוטים שהם מנהלים מקבלים את כל ההודעות בכל מצב פרטיות.

שגיאות חיבור נפוצות ומה לעשות בנוגע אליהן#

אילו שאלות נוספות שואלים על Hermes Agent בטלגרם?#

כשתהיו מוכנים, הכירו את Ailoot.