מדריך OpenClaw בעברית
לאתר הראשי כל המדריכים קלוד קוד קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ n8n בענן n8n בהתקנה עצמית

פרק 14

מלכודות וטיפים

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

#1. חיבור ערוצי טלפון לפני בדיקת לוח הבקרה

הטעות הנפוצה ביותר היא ניסיון לסרוק קוד QR בוואטסאפ או להגדיר בוט בטלגרם לפני שווידאתם שהעוזר עונה בצ'אט הדפדפן. אם ה-Gateway אינו מאומת מול מודל השפה, שום ערוץ בטלפון לא יעבוד.

הפתרון: פתחו תמיד את openclaw dashboard, שלחו הודעת בדיקה בעברית, ורק לאחר קבלת תשובה המשיכו להגדרת ערוצים.

#2. התחלה בוואטסאפ במקום בטלגרם

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

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

#3. בלבול בין ברקוד התחברות לבין קוד צימוד משתמש

בוואטסאפ קיימים שני שלבי אישור שונים: ברקוד WhatsApp Web לחיבור החשבון לשרת, וקוד צימוד (Pairing) בן 8 תווים לאישור השולח הספציפי. משתמשים רבים סורקים מחדש את הברקוד כאשר הבוט אינו עונה, במקום לאשר את קוד הצימוד בלוח הבקרה.

הפתרון: סורקים ברקוד רק פעם אחת ב-openclaw channels login. כאשר שולחים הודעה ומקבלים קוד, מאשרים אותו ב-openclaw pairing approve.

#4. ניסיון לפתוח את כתובת 127.0.0.1 במכשירים אחרים

הכתובת 127.0.0.1 (Localhost) מייצגת את המחשב המקומי בלבד. היא לא תיפתח בדפדפן של הטלפון הנייד או ממחשב אחר ברשת הביתית.

הפתרון: לגישה מרוחקת ללוח הבקרה משתמשים ברשת מאובטחת כמו Tailscale או במנהרת SSH.

#5. חשיפת טוקנים וקובצי לוג בפורומים ציבוריים

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

הפתרון: השתמשו בפקודת openclaw triage שמנקה אוטומטית מפתחות וסודות מתוך דוחות האבחון.

#6. פתיחת פורט 18789 בראוטר הביתי

לוח הבקרה הוא ממשק ניהול בעל הרשאות מלאות. פתיחת הפורט ישירות לאינטרנט הציבורי (Port Forwarding) ללא הצפנה חושפת את המחשב לסריקות רשת.

הפתרון: שומרים את שרת ה-Gateway מקומי תמיד, ומשתמשים ב-Tailscale Serve או SSH עבור גישה מרחוק.

#7. הפעלת מדיניות open עם הרשאות כלים מלאות

הגדרת dmPolicy: "open" מאפשרת לכל אדם שמאתר את הבוט לשלוח לו הודעות. אם לעוזר יש הרשאות להרצת פקודות shell או קריאת קבצים, זוהי פרצת אבטחה חמורה.

הפתרון: השתמשו תמיד ב-pairing או ב-allowlist עם מספרי טלפון ומזהי משתמשים מפורשים.

#8. המחשב נרדם והעוזר מפסיק לענות

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

הפתרון: להפעלה רציפה 24/7 משתמשים במחשב שולחני שאינו נרדם או בשרת VPS פרטי.

#9. מחיקת סשן וסריקת ברקוד במקום הרצת אבחון

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

הפתרון: מריצים קודם openclaw doctor ו-openclaw channels status --probe.

#10. ערבוב הגדרות בין OpenClaw לבין GOWA

משתמשים המפעילים גם את מדריך וואטסאפ ל-AI (שרת GOWA) וגם את OpenClaw על אותו מחשב עלולים לערבב בין תיקיות הסשן או הפורטים.

הפתרון: שמרו על הפרדה ברורה. GOWA הוא שרת MCP עבור Claude Code, בעוד ש-OpenClaw הוא שרת Gateway עצמאי עם פורט 18789 משלו.

#פקודת החילוץ המרכזית

כאשר המערכת נתקעת ואינכם בטוחים מה הסיבה, הריצו:

openclaw triage

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

#קישורים ומקורות רשמיים