📘 תיעוד 1

תחילת העבודה

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

#מה צריך

• Node.js 24.16.0+ על 24.x, או 26.1.0+ (מומלץ Node 26. עבור תיקוני האבטחה השתמשו ב-24.22.1+/26.12.1+)
• התחברות קיימת ל-Claude Code או ל-Codex CLI, או מפתח API של ספק: תהליך ה-onboarding יכול לעשות בה שימוש חוזר

בדקו את גרסת Node עם node --version. משתמשי Windows: אפליקציית Windows Hub המקורית היא הנתיב הקל ביותר לשולחן העבודה. נתמכים גם מתקין PowerShell ונתיבי Gateway של WSL2. ראו Windows. צריך להתקין Node? ראו הגדרת Node.

#נסו את זה בפקודה אחת

npx openclaw@latest

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

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

כדי להשאיר את ה-Gateway רץ ברקע אחר כך, התקינו את ה-CLI למטה והריצו openclaw gateway install, ואחר כך openclaw gateway start כדי להמתין עד שהוא מוכן. הריצו 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

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

   ראו Onboarding (CLI) לעיון המלא.

3. התקנת שירות ה-Gateway

   Quick start שואל Keep OpenClaw running in the background? ומתקין את השירות כשמאשרים, ולכן דלגו על הצעד הזה במקרה הזה. אחרת, לחצו Ctrl+C כדי לעצור את ה-Gateway שרץ בחזית, ואז התקינו את השירות והמתינו עד שהוא מוכן:

   העתק

   openclaw gateway install
   openclaw gateway start

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

   gateway install חוזר אחרי שהשירות נרשם, בעוד ה-Gateway עדיין עשוי להיות בתהליך הפעלה. gateway start ממתין עד שה-Gateway עובר את בדיקות התקינות והמוכנות. הוא לא מפעיל מחדש Gateway שכבר רץ.

4. אימות שה-Gateway רץ

   העתק

   openclaw gateway status

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

5. פתיחת לוח הבקרה

   העתק

   openclaw dashboard

   הפקודה פותחת את ה-Control UI בדפדפן. אם הוא נטען, הכל עובד.

6. שליחת ההודעה הראשונה

   הקלידו הודעה בצ'אט של ה-Control UI, ואמורה להתקבל תשובת AI.

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

#מתקדם: חיבור build מותאם של Control UI

אם אתם מתחזקים build מותאם או מתורגם של לוח הבקרה, כוונו את gateway.controlUi.root לתיקייה שמכילה את נכסי הסטטיקה הבנויים ואת index.html.

mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.

ואז הגדירו:

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

הפעילו מחדש את ה-gateway ופתחו שוב את לוח הבקרה:

openclaw gateway restart
openclaw dashboard

#אם ההגדרה לא עובדת

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

openclaw triage

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

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

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

#מה לעשות אחר כך

• חיבור ערוץ: Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, ועוד.
• צימוד ובטיחות: שליטה במי יכול לשלוח הודעות לסוכן.
• הגדרת ה-Gateway: מודלים, כלים, sandbox, והגדרות מתקדמות.
• עיון בכלים: דפדפן, exec, חיפוש באינטרנט, skills ותוספים.

#מתקדם: משתני סביבה

אם מריצים את OpenClaw כחשבון שירות או רוצים נתיבים מותאמים:

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

עיון מלא: משתני סביבה.

#קשור

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