פרק 11

השימוש היומיומי ומה עושים כשנתקע

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

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

#שגרת בוקר תקינה

כאשר שירות הרקע מותקן כהלכה:

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

#פקודות ניהול ואבחון מרכזיות בטרמינל

בכל שלב ניתן לבדוק את מצב המערכת באמצעות שורת הפקודה:

# בדיקת סטטוס שרת ה-Gateway
openclaw gateway status

# בדיקת סטטוס כל ערוצי השיחה המחוברים
openclaw channels status

# בדיקת בריאות כללית של השירות
openclaw health

# מעקב חי אחר לוגים של המערכת
openclaw logs --follow

# הרצת בדיקת אבחון מקיפה של כל הרכיבים
openclaw doctor

# איסוף דוח אבחון מקומי בטוח
openclaw triage

#הכרת פקודות `doctor` ו-`triage`

openclaw doctor: בודק את קובצי ההגדרות, תוקף המפתחות, הרשאות הקבצים ומצב השירותים, ומציע הצעות לתיקון. הדגל --fix מיישם תיקונים אוטומטיים בטוחים.
openclaw triage: אוסף נתוני אבחון מקומיים (גרסאות, לוגים עדכניים וסטטוס רכיבים) תוך הסתרת סודות ומפתחות API. ניתן להשתמש בפלט כדי לאתר שגיאות בעצמכם או להעביר אותו לסוכן קידוד.

#סדר פעולות כאשר העוזר אינו מגיב בטלפון

אם שלחתם הודעה מהטלפון ולא קיבלתם תשובה, פעלו לפי סדר הבדיקה הבא:

תיאור התרשים בקוד

flowchart TD
    A["הודעה לא נענית בטלפון"] --> B["בדיקת שרת: openclaw gateway status"]
    B -->|"שרת לא פעיל"| C["הפעלה מחדש: openclaw gateway restart"]
    B -->|"שרת פעיל"| D["בדיקת ערוצים: openclaw channels status"]
    D -->|"וואטסאפ/טלגרם מנותק"| E["בדיקת תוקף טוקן או probe"]
    D -->|"ערוצים מחוברים"| F["בדיקת צימוד: openclaw pairing list"]
    F -->|"ממתין לאישור"| G["אישור קוד: openclaw pairing approve"]
    F -->|"מאושר"| H["מעקב לוגים חי: openclaw logs --follow"]

#פירוט שלבי הבדיקה:

בדיקת שרת ה-Gateway: הריצו openclaw gateway status. אם השירות אינו פועל, בצעו הפעלה מחדש:
```
openclaw gateway restart
```
בדיקת מצב הערוץ: הריצו openclaw channels status. עבור וואטסאפ ודאו שמופיע Linked. עבור טלגרם ודאו שהטוקן תקין.
בדיקת בקשות צימוד (Pairing): האם שלחתם הודעה ממספר או משתמש חדש? הריצו openclaw pairing list <channel> ובדקו האם ממתינה בקשת אישור.
בדיקת תיוג בקבוצות: אם השיחה מתבצעת בתוך קבוצה, ודאו שתייגתם את שם הבוט בהודעה.
מעקב לוגים חי: הריצו openclaw logs --follow ושלחו הודעה נוספת מהטלפון. צפו בלוג כדי לראות האם ההודעה נקלטה והאם התקבלה שגיאה מספק המודל.

[!WARNING] אל תמהרו לסרוק מחדש קוד QR בוואטסאפ כצעד ראשון. סריקה חוזרת מאפסת את הסשן בדיסק. ברוב המקרים מדובר בעצירת שירות ה-Gateway או במשתמש הממתין לאישור צימוד.

#בעיות במודל או תקציב API

אם הלוגים מראים שגיאות כגון rate_limit_exceeded, insufficient_quota או authentication_error:

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

בפרק הבא נלמד כיצד לנהל את שרת ה-Gateway כשירות קבוע ולוודא שהוא נשאר פעיל.