מדריך OpenClaw בעברית

פרק 5

לוח הבקרה ושיחה ראשונה

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

הפרק מבוסס על התיעוד הרשמי בכתובת docs.openclaw.ai/web/dashboard.

#פתיחה נכונה של לוח הבקרה

הדרך המהירה והבטוחה לפתוח את לוח הבקרה היא באמצעות פקודת ה-CLI:

openclaw dashboard

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

ניתן גם לגשת לממשק ישירות בכתובת:

http://127.0.0.1:18789/

[!NOTE] הגישה לממשק זה אפשרית אך ורק מאותו המחשב שבו רץ שרת ה-Gateway, תחת פרוטוקול http (אלא אם הגדרתם תעודת TLS מקומית).

#אימות באמצעות טוקן ה-Gateway

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

אם הדפדפן מבקש מכם להזין Gateway Token:

  1. פתחו חלון טרמינל באותו המחשב והריצו:
openclaw gateway auth-token --show
  1. העתיקו את מחרוזת הטוקן המודפסת.
  2. הדביקו את הטוקן בתיבת האימות בממשק הדפדפן והתחברו.

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

openclaw doctor --generate-gateway-token
openclaw gateway restart

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

#שיחת אימות ראשונה (First Prompt)

כאשר חלון הצ'אט בלוח הבקרה נטען, כתבו הודעת בדיקה פשוטה בתיבת הטקסט:

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

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

#טיפול בשגיאות התחברות (Unauthorized או שגיאה 1008)

אם הממשק בדפדפן מסרב להתחבר:

  1. בדיקת שירות ה-Gateway: ודאו שהשרת אכן פועל באמצעות openclaw gateway status. אם הוא כבוי, הפעילו אותו בעזרת openclaw gateway start.
  2. החלפת פרופיל דפדפן: הקישור החד-פעמי שמופק מ-openclaw dashboard מיועד לפרופיל הדפדפן שנפתח. אם פתחתם חלון גלישה בסתר או דפדפן אחר, הזינו את הטוקן המלא באופן ידני.
  3. גישה מרוחקת לשרת VPS: אם ה-Gateway רץ על שרת מרוחק, אין לפתוח את פורט 18789 לרשת הציבורית. במקום זאת, פתחו מנהרת SSH מהמחשב המקומי שלכם:
ssh -N -L 18789:127.0.0.1:18789 user@your-server-ip

לאחר פתיחת המנהרה, היכנסו בדפדפן המקומי שלכם לכתובת http://127.0.0.1:18789/.

#רכיבי לוח הבקרה העיקריים

  • סביבת צ'אט (Chat): ניהול שיחות ישירות מול המודל עם חיווי על שימוש בכלים וטוקנים.
  • ניהול ערוצים ובקשות גישה (Settings -> Channels -> DM access requests): רשימת בקשות צימוד (Pairing) הממתינות לאישור ממשתמשי טלגרם או וואטסאפ.
  • התקנים מאושרים (Approved Devices): ניהול מחשבים ודפדפנים שקיבלו הרשאת התחברות.
  • הגדרות תצוגה ושפה: ניתן לשנות שפה והעדפות ממשק תחת Settings -> Appearance -> Language.

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