איך להשאיר את Hermes Agent פועל בשרת מסביב לשעון

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

להלן הסבר כיצד להתקין את Hermes בשרת Linux רגיל, להפוך את ה־gateway לשירות שפועל ברציפות ומתחיל אוטומטית לאחר אתחול מחדש, ולהגביל את הגישה כדי שאנשים זרים לא יוכלו להיכנס למסוף. מדריך זה מסתמך על התיעוד הרשמי.

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

מידע על עבודה עם Ailoot זמין בתיעוד.

למה להעביר את Hermes Agent ממחשב נייד לשרת?#

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

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

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

מה כדאי להכין לפני התקנת Hermes ב־VPS?#

אספו שלושה דברים לפני ההתקנה.

השרת. שרת VPS רגיל מבוסס Linux יספיק. רמת התמיכה הראשונה בתיעוד היא Linux ו־WSL2, והבדיקות נערכות בגרסת Ubuntu העדכנית. אם במערכת יש glibc,‏ systemd ומבנה תיקיות מוכר, Hermes יותקן כראוי. הדבר חשוב בשרת, משום שכל שלבי ההפעלה האוטומטית שלהלן מסתמכים על systemd, שמגיע עם Ubuntu ו־Debian.

גישת SSH. מתחברים לשרת דרך מסוף באמצעות SSH; לא משתמשים שם בעכבר. כל הפקודות שלהלן מופעלות בהפעלת SSH זו. אם אתם כותבים קוד באמצעות vibe coding ועדיין לא מרגישים בנוח עם המסוף, אל דאגה: יש רק כמה פקודות, ואפשר להעתיק כל אחת מהן במלואה.

מודל שנבחר. הסוכן אינו חושב בעצמו; הוא קורא למודל. בשרת שפועל בלעדיכם חשוב שהגישה למודל לא תפוג. האפשרות הפשוטה ביותר היא מנוי Nous Portal באמצעות hermes setup --portal: הכניסה משתמשת ב־OAuth, והאסימון מתרענן אוטומטית. גם מפתחות API משלכם יעבדו, אבל אז ודאו שיש כסף בחשבון — סוכן ללא ממשק גרפי וביתרה ריקה פשוט ישתתק. המודל חייב לכלול חלון הקשר של לפחות 64,000 אסימונים, אחרת Hermes יסרב להתחיל לפעול איתו. כל מודלי הענן שברשימה עומדים בדרישה הזו.

איך מתקינים את Hermes Agent בשרת באמצעות פקודה אחת?#

ההתקנה בשרת כמעט זהה להתקנה במחשב נייד, עם הבדל אחד: בדרך כלל הסוכן אינו זקוק שם לדפדפן. אוטומציה של דפדפן כוללת גם את Chromium הכבד. לכן משתמשים בדגל --skip-browser.

1. התחברו לשרת באמצעות SSH

   ssh root@your-server-address
   

   הפעילו את כל הפקודות הבאות בתוך ההפעלה הזו, בשרת עצמו.

2. הפעילו את תוכנית ההתקנה ללא הדפדפן

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   הסקריפט מוריד את הסביבה הנדרשת ומתקין את הפקודה hermes. הדגל --skip-browser מדלג על התקנת אוטומציית הדפדפן; בשרת ללא ממשק גרפי היא רק תתפוס מקום. אם תזדקקו לדפדפן בהמשך, תוכלו להתקין אותו בנפרד.

3. הפעילו מחדש את המעטפת ובחרו מודל

   source ~/.bashrc
   hermes setup --portal
   

   השורה הראשונה טוענת את PATH החדש כדי שאפשר יהיה למצוא את הפקודה hermes. השנייה פותחת את מסך הכניסה ל־Nous Portal: אשרו את הכניסה, והסוכן יקבל מודל ושירותים בלי צורך במפתחות נפרדים לכל אחד מהם.

4. בדקו את ההתקנה

   hermes doctor
   

   הפקודה מציגה מה הותקן, מה חסר וכיצד לתקן זאת. סימונים ירוקים פירושם שהכול מוכן.

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

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

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

תחילה הגדירו את ה־gateway וחברו שירות מסרים:

hermes gateway setup

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

בהמשך מגיעה המלכודת שאנשים שוכחים לעיתים קרובות. אם פשוט מפעילים את hermes gateway, התהליך יפעל רק כל עוד הפעלת SSH פתוחה. סגרו את המסוף, וה־gateway ייעצר. כדי להשאיר אותו פועל ברציפות, צריך להעביר אותו לשליטת המערכת. יש לכך פקודה אחת:

hermes gateway install

היא מתקינה את ה־gateway כשירות: ב־Linux כשירות systemd של משתמש, וב־macOS באמצעות launchd. המערכת עוקבת אחר התהליך ומפעילה אותו מחדש אם הוא קורס.

בשרת, לעיתים קרובות תזדקקו לאפשרות השנייה: שירות מערכת שמתחיל כשהמכונה מופעלת, לפני שמשתמש כלשהו נכנס למערכת:

sudo hermes gateway install --system

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

hermes gateway start     # start
hermes gateway stop      # stop
hermes gateway status    # check status

עבור שירות מערכת, הוסיפו sudo ואת הדגל --system לפקודות האלה. בלעדיהם, הפקודות יפעלו על שירות המשתמש במקום על השירות שמתחיל בעת האתחול:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

למה צריך linger ומה משתבש בלעדיו?#

זו המכשלה הנפוצה ביותר: התקנתם את השירות, אבל הבוט עדיין משתתק בלילה. הסיבה היא אופן הפעולה של שירותי משתמש ב־Linux.

שירות systemd של משתמש קשור כברירת מחדל להפעלה שלו. אתם מתחברים באמצעות SSH, ומנהל המשתמש שלכם מתחיל לפעול; השירות פועל. אתם מתנתקים, והמערכת מחשיבה את המשתמש ללא פעיל, ולכן מכבה את השירותים של אותו משתמש יחד עם ה־gateway שלכם. בשרת שאליו נכנסים ויוצאים, זהו כשל: הבוט מקוון רק כשאתם מחוברים ל־SSH.

אפשר לתקן זאת באמצעות מצב linger, שמאפשר למערכת להשאיר את מנהל המשתמש פועל גם כשהמשתמש אינו מחובר:

sudo loginctl enable-linger username

לאחר הפקודה הזו, שירות המשתמש פועל בעצמו ומתחיל כשהשרת מופעל, בלי להמתין לכניסה שלכם. ללא linger, חוזרים להתנהגות המקורית: ה־gateway נכבה כשאתם יוצאים מ־SSH ואינו מתחיל בעת האתחול. התיעוד מציין זאת במפורש.

איך מפעילים את Hermes בשרת ב־Docker עם הפעלה מחדש אוטומטית?#

Docker הוא דרך נוספת להשאיר את הסוכן פועל בשרת, במיוחד אם אתם כבר רגילים לקונטיינרים או רוצים לבודד את הסוכן מהמערכת הראשית. הגדירו אותו פעם אחת באמצעות docker run ... setup, ואז הפעילו את הקונטיינר ברקע:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

כך פועלות השורות שאחראיות להפעלה מסביב לשעון:

• -d — הקונטיינר פועל ברקע ואינו משאיר את המסוף פתוח.
• --restart unless-stopped — Docker מפעיל מחדש את הקונטיינר לאחר אתחול מחדש של השרת או קריסה. הוא לא יפעיל אותו מחדש רק אם עצרתם אותו ידנית.
• -v ~/.hermes:/opt/data — ההגדרות, המפתחות, ההפעלות והזיכרון נשמרים בשרת, מחוץ לקונטיינר, ושורדים יצירה מחדש שלו.

התמונה מוסיפה אמצעי הגנה נוסף: תהליך ה־gateway פועל תחת המפקח s6. אם ה־gateway קורס, הוא מופעל מחדש בתוך כמה שניות בלי לאבד את הקונטיינר עצמו. זו הגנה כפולה: Docker משאיר את הקונטיינר פועל מבחוץ, ואילו s6 עוקב אחר התהליך שבתוכו.

זכרו הבדל אחד בגישת Docker: ההתקנות האלה אינן מתעדכנות באמצעות הפקודה hermes update. כדי לעדכן ב־Docker, החליפו את התמונה באחת חדשה — הורידו את הגרסה העדכנית וצרו מחדש את הקונטיינר.

איך בודקים שהכול פועל ושיישאר כך אחרי אתחול מחדש?#

לשירות משתמש, בדקו את מצבו ואת היומנים כך:

hermes gateway status
journalctl --user -u hermes-gateway -f

לשירות המערכת המומלץ ל-VPS, השתמשו במקום זאת בתחום המערכת:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

הפקודה הראשונה בודקת את השירות שנבחר; השנייה עוקבת אחר היומן של אותו תחום. שמות היחידות האלה חלים על התקנת ברירת המחדל ב־~/.hermes. לתיקיות בית אחרות של Hermes עשויה להיות יחידה עם סיומת: בדקו את פלט המצב והשתמשו ביחידה המדויקת שמופיעה בו. אל תעקבו אחר יחידת משתמש בזמן בדיקת התקנת מערכת. היומנים של Hermes נמצאים ב־~/.hermes/logs/, וסודות מוסתרים מהם אוטומטית, כך שבטוח לשלוח אותם לתמיכה.

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

sudo reboot

אחרי שהשרת שוב נגיש, התחברו אליו באמצעות SSH. בהתקנת מערכת בדקו את sudo hermes gateway status --system ואת יומן המערכת שלה; בהתקנת משתמש עם linger בדקו את hermes gateway status ואת יומן המשתמש שלה. לאחר מכן שלחו הודעה לבוט בטלגרם. אם הוא עונה ללא התערבות מצדכם, ההפעלה האוטומטית הוגדרה כראוי. לשם כך עשיתם את כל זה.

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

איך מאבטחים סוכן עם גישה למסוף בשרת?#

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

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

TELEGRAM_ALLOWED_USERS=123456789,987654321

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

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

hermes config set terminal.backend docker

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

מה לעשות אם הבוט שותק או שה־gateway קורס?#

כשהבוט מפסיק להגיב, פעלו לפי הסדר הזה. תחילה בדקו את תחום ההתקנה שבחרתם: sudo hermes gateway status --system ויומן המערכת לשירות מערכת, או hermes gateway status ויומן המשתמש לשירות משתמש. אם ה־gateway פועל אבל ההודעות אינן עוברות, כמעט תמיד מדובר בבעיית הגדרות פלטפורמה: אסימון הבוט שגוי או שהאדם אינו ברשימת הגישה. הפעילו שוב את hermes gateway setup באותה תיקיית בית של Hermes, ואז בדקו את השירות שנבחר באמצעות hermes gateway status --system למערכת או hermes gateway status למשתמש. הגדרה שהסתיימה בהצלחה אינה הוכחה שה-gateway הנכון פועל.

אם המודל מחזיר תשובות ריקות או מוזרות, בדקו אותו באמצעות hermes model ואשרו את הספק ואת הכניסה. רצף ההתאוששות הכללי שמחזיר אתכם מ„הכול שבור” לעבודה תקינה הוא: hermes doctor,‏ hermes model,‏ hermes setup, ולאחר מכן hermes gateway status --system להתקנת מערכת או hermes gateway status להתקנת משתמש.

עוד דבר אחד למקרה הנדיר אך הלא נעים שבו התהליך כולו קופא בלי לקרוס בפועל. לשירות systemd יש טיימר watchdog: הוסיפו את השורה הזאת אל ~/.hermes/config.yaml והתקינו מחדש את השירות.

gateway:
  systemd_watchdog_seconds: 120

# For the VPS system service (same Hermes home as the original install):
sudo hermes gateway install --system --force
sudo hermes gateway status --system

לשירות משתמש במקום זאת, צרו מחדש רק את התחום הזה באמצעות hermes gateway install --force ובדקו את hermes gateway status. בחרו תחום אחד; אל תתקינו את שניהם כדי לתקן gateway יחיד.

לאחר מכן, ה־gateway מאותת למערכת בקביעות: “אני חי”, ואם האותות נפסקים, systemd מפעיל מחדש את התהליך אוטומטית. הדבר פועל רק ב־Linux עם systemd, ורק במקרה של קיפאון בתהליך. טיימר watchdog לא ישפיע על הפרעה רגילה ברשת בין השרת לשירות המסרים.

מה עוד שואלים על Hermes Agent בשרת?#

הכירו את Ailoot.