🦞 פרק 1

מה זה OpenClaw

OpenClaw הוא עוזר AI אישי בעל יכולות הפעלה של כלים, שרץ באופן עצמאי על גבי המחשב האישי או בשרת פרטי שלכם. במקום לפתוח בכל פעם חלון דפדפן ייעודי או לשלם על מנויי צ'אט נעולים, OpenClaw פוגש אתכם ישירות בתוך אפליקציות המסרים היומיומיות שלכם: טלגרם, וואטסאפ, דיסקורד, סלאק, סיגנל, iMessage, טימס, Matrix, Feishu, Zalo ועוד, לצד לוח בקרה מקומי בדפדפן וממשק שורת פקודה (TUI).

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

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

התוכן מבוסס על התיעוד הרשמי של הפרויקט בכתובת docs.openclaw.ai ועל מאגר הקוד openclaw/openclaw, מעודכן לגרסאות 2026.

#מבנה המערכת: שלושה רכיבים מרכזיים

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

1. Gateway (שרת השער): תהליך רקע (Daemon) שרץ על המחשב או השרת שלכם. ה-Gateway מנהל את החיבור למודל השפה, מפעיל כלים מערכתיים (כגון קריאת קבצים, הרצת פקודות shell, חיפוש ברשת ודפדפן), מנהל את הזיכרון ומאכוף את מדיניות ההרשאות. כברירת מחדל ה-Gateway מאזין לכתובת המקומית http://127.0.0.1:18789.
2. לוח הבקרה (Control UI / Dashboard): ממשק אינטרנטי מקומי בדפדפן המאפשר לשוחח עם העוזר, לנהל ערוצים, לאשר גישה למשתמשים חדשים ולשלוט בכל ההגדרות. פותחים אותו בפקודה openclaw dashboard, או ניגשים לממשק הטרמינל בפקודה openclaw.
3. ערוצי שיחה (Channels): מחברים המקשרים בין ה-Gateway לבין פלטפורמות חיצוניות כגון טלגרם, וואטסאפ, דיסקורד, סלאק, סיגנל ואחרות. כל הודעה שנשלחת מהטלפון מגיעה ל-Gateway, מעובדת על ידי המודל, והתשובה מוחזרת ישירות לאותו הערוץ. הערוץ המהיר ביותר להגדרה ראשונית הוא טלגרם, שדורש רק טוקן בוט.

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

#מה העוזר מסוגל לבצע

לאחר השלמת ההתקנה וההגדרה:

• מענה שוטף בשיחות טקסט ומדיה: ניהול שיחות עשירות, סיכום מסמכים, ניתוח תמונות וקבצים שנשלחים בצ'אט.
• הפעלת כלים במחשב: קריאה וכתיבה של קבצים מקומיים, הרצת פקודות מערכת (exec), הפעלת דפדפן (browser), חיפוש ברשת (web search), הפעלת כישורים (skills) ותוספים (plugins).
• שמירת הקשר וזיכרון: ניהול סשנים מתמשכים המאפשרים לעוזר לזכור פרטים בין הודעות שונות.
• חיבור ריבוי ערוצים במקביל: שרת Gateway יחיד יכול לשרת בו-זמנית שיחות בטלגרם, וואטסאפ ובלוח הבקרה.
• אבחון עצמי מובנה: בדיקת תקינות מלאה והעברת ממצאי אבחון ישירות לסוכני פיתוח במחשב לצורך פתרון תקלות מהיר.

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

#השוואה למדריכים נוספים באתר

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

#למי הכלי מתאים ודרישות מערכת

• משתמשים עם חומרה זמינה: מחשב שולחני שנשאר דלוק, מחשב נייד פעיל, שרת ביתי, או שרת לינוקס (VPS).
• גרסת Node.js: נדרש Node.js 24.16+ או 26.1+. גרסת Node 26 היא סביבת הריצה המומלצת לפי התיעוד הרשמי. ניתן לבדוק את הגרסה הקיימת באמצעות הפקודה node --version.
• מערכות הפעלה: תמיכה מלאה ב-macOS, Linux ו-WSL2. למשתמשי Windows, אפליקציית Windows Hub המקומית היא הנתיב השולחני הפשוט ביותר, וקיימת גם תמיכה בהתקנה באמצעות PowerShell או Gateway בתוך WSL2.
• גישה למודלי שפה: התחברות קיימת במחשב ל-Claude Code או ל-Codex CLI, או מפתח API של ספק מודלים. תהליך הקליטה מסוגל לעשות שימוש חוזר בחיבורים אלה.
• תקשורת ישירה מהנייד: מי שמעוניין בעוזר AI זמין ישירות באפליקציות מסרים ללא תלות במנויים נעולים של צד שלישי.

#התנסות מהירה בפקודה אחת

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

npx openclaw@latest

בהתקנה חדשה, בוחרים באפשרות Quick start לאחר הפניה קצרה של שורה אחת למדריך האבטחה. זהו השלב היחיד בתהליך הקליטה כאשר כבר קיימת גישת AI שמישה במחשב: OpenClaw מאתר התחברות פעילה של Claude Code או Codex CLI, או מפתח API קיים, מאמת את החיבור עם מענה אמיתי מהמודל, שומר את ההגדרות ופותח את לוח הבקרה בדפדפן.

ה-Gateway רץ בחלון הטרמינל הנוכחי עד להקשת Ctrl+C, וההגדרות נשמרות. אם לא זוהה נתיב חיבור תקין, תהליך הקליטה פותח הגדרה ידנית של ספק המודל. כדי לעבור על כל אפשרויות ההגדרה המודרכות, בוחרים באפשרות Custom setup.

כדי להשאיר את ה-Gateway פועל ברקע בהמשך, מתקינים את ה-CLI לפי ההוראות להלן ומריצים openclaw gateway install. מריצים openclaw עבור ממשק הטרמינל (TUI) או openclaw dashboard כדי לפתוח מחדש את לוח הבקרה בדפדפן.

#התקנה מהירה: שישה שלבים מהתחלה ועד הודעה ראשונה

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

1. התקנת OpenClaw: ב-macOS וב-Linux מריצים בטרמינל:

   העתק

   curl -fsSL https://openclaw.ai/install.sh | bash

   ב-Windows מריצים ב-PowerShell:

   העתק

   iwr -useb https://openclaw.ai/install.ps1 | iex

   קיימות גם שיטות התקנה חלופיות באמצעות Docker, Nix ו-npm.

2. השלמת תהליך הקליטה (Onboarding): תוכנת ההתקנה מפעילה את אשף הקליטה המודרך באופן אוטומטי. בוחרים ב-Quick start כדי לעשות שימוש חוזר בגישת AI מזוהה ולפתוח את לוח הבקרה, או ב-Custom setup עבור התהליך המודרך המלא. התחברות לספק והגדרות רשות עשויות להימשך זמן רב יותר. ניתן לחזור מאוחר יותר להגדרות נוספות באמצעות הפקודה openclaw configure. הפקודה openclaw onboard --classic פותחת במקום זאת את האשף הקלאסי שלב אחר שלב.

3. התקנת שירות ה-Gateway ברקע: הפעלה דרך Quick start משאירה את ה-Gateway בחזית הטרמינל. השלבים הבאים דורשים שהוא ירוץ ברקע. עוצרים את תהליך ה-Gateway שבחזית בעזרת Ctrl+C, ולאחר מכן מתקינים את השירות:

   העתק

   openclaw gateway install

   פקודה זו מתקינה LaunchAgent ב-macOS, יחידת משתמש של systemd ב-Linux וב-WSL2, או Scheduled Task ב-Windows מקומי (עם מנגנון גיבוי של פריט התחברות בתיקיית Startup אם יצירת המשימה נדחית). ההגדרות שלכם נשמרות לאורך העצירה וההתקנה.

4. אימות פעילות ה-Gateway: מוודאים שהשירות רץ:

   העתק

   openclaw gateway status

   יש לראות כי ה-Gateway מאזין לפורט 18789.

5. פתיחת לוח הבקרה: פותחים את ממשק הניהול בדפדפן:

   העתק

   openclaw dashboard

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

6. שליחת הודעה ראשונה: כותבים הודעה בצ'אט שבממשק הבקרה (Control UI) ומקבלים מענה מ-AI. למי שמעוניין לשוחח ישירות מהטלפון הנייד במקום זאת, הערוץ המהיר ביותר להגדרה הוא Telegram (דורש טוקן בוט בלבד).

#אבחון תקלות ופתרון בעיות

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

openclaw triage

הפקודה מריצה בדיקות תקינות לקריאה בלבד, כותבת פרומפט נקי שמתאר את הממצאים, ומציעה להעביר את הפרומפט ישירות לאחד מסוכני הפיתוח המזוהים במחשב: Claude Code, Codex CLI, או הסוכן המובנה של OpenClaw, כך שהסוכן מתחיל לעבוד כשהאבחון כבר טעון אצלו. אם מעדיפים להריץ את המסירה באופן עצמאי, בוחרים באפשרות להדפיס את הפקודות בלבד.

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

כדי לקרוא את הממצאים בעצמכם במקום זאת, ניתן להריץ את הפקודה openclaw doctor.

#אבטחה וגבולות אמון

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

• ה-Gateway מוגדר כברירת מחדל להאזנה אך ורק בכתובת המקומית (127.0.0.1:18789).
• מנגנון צימוד ובטיחות (Pairing and safety): משתמשים חדשים ששולחים הודעה באפליקציית מסרים אינם מקבלים גישה אוטומטית, אלא נדרש אישור מפורש לשליטה במי רשאי לשלוח הודעות לסוכן.
• אין לחשוף את פורט הניהול ישירות לרשת האינטרנט ללא ערוץ מוצפן ומאובטח כמו רשת Tailscale או מנהרת SSH.
• כלי האבחון openclaw triage מסנן מידע רגיש ואינו מוציא נתונים מהמחשב ללא בחירת סוכן מפורשת מצדכם.

#הגדרות מתקדמות ומשתני סביבה

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

• OPENCLAW_HOME: ספריית בית לצורך פתרון נתיבים פנימיים.
• OPENCLAW_STATE_DIR: דריסת ספריית המצב.
• OPENCLAW_CONFIG_PATH: דריסת נתיב קובץ ההגדרות.

בנוסף, אם אתם מנהלים גרסה מותאמת אישית או מתורגמת של לוח הבקרה, ניתן להפנות את gateway.controlUi.root לספרייה שמכילה את הקבצים הסטטיים שנבנו ואת הקובץ index.html:

mkdir -p "$HOME/.openclaw/control-ui-custom"

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

{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "${HOME}/.openclaw/control-ui-custom"
    }
  }
}

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

openclaw gateway restart
openclaw dashboard

#מה הלאה ומקורות נוספים

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

• חיבור ערוצי שיחה נוספים: חיבור ערוצים כגון Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo ועוד.
• צימוד ובטיחות (Pairing and safety): ניהול והגדרת ההרשאות לשליטה מלאה במי שרשאי לשלוח הודעות לסוכן.
• הגדרת ה-Gateway: התאמת מודלים, כלי מערכת, סביבת ארגז חול (Sandbox) והגדרות מתקדמות.
• עיון בכלים: שימוש והרחבה של דפדפן (browser), הרצת פקודות מערכת (exec), חיפוש ברשת (web search), כישורים (skills) ותוספים (plugins).