📘 תיעוד 1

התחלת העבודה

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

#מה נדרש

• Node.js 24.16+ או 26.1+ (Node 26 היא סביבת הריצה המומלצת)
• כניסה קיימת ל-Claude Code או ל-Codex CLI, או מפתח API של ספק: תהליך הקליטה יכול לעשות בזה שימוש חוזר

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

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

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 פותחת במקום זאת את האשף הקלאסי צעד אחר צעד.

   ראה Onboarding (CLI) למדריך המלא.

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

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

   העתק

   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 (רק טוקן של בוט). ראה ערוצים לכל האפשרויות.

#מתקדם: חיבור 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. לנתיבים לפי תסמינים, ראה פתרון בעיות.

#מה לעשות בהמשך

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

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

אם אתה מריץ את OpenClaw כחשבון שירות (service account) או מעוניין בנתיבים מותאמים אישית:

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

מדריך מלא: משתני סביבה.

#נושאים קשורים

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