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

תיעוד 2

התקנה

#דרישות מערכת

  • Node 24.16+ או 26.1+: מומלץ Node 26. תוכנית ההתקנה מתקינה Node 26 ב-macOS ו-Node 24 LTS ב-Linux כאשר Node חסר (ראו תאימות Node.js).
  • macOS, Linux, או Windows: משתמשי Windows יכולים להתחיל עם אפליקציית Windows Hub המקורית, תוכנית ההתקנה של ה-CLI ב-PowerShell, או Gateway ב-WSL2. ראו Windows.
  • pnpm נדרש רק אם אתם בונים מקוד המקור.

#הורדת אפליקציית שולחן העבודה

מעדיפים הורדת אפליקציה רגילה במקום ה-CLI? OpenClaw מציעה אפליקציות שולחן עבודה מלוות:

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

#מומלץ: סקריפט התקנה

הדרך המהירה ביותר להתקנה. הוא מזהה את מערכת ההפעלה שלכם, מתקין את Node במידת הצורך, מתקין את OpenClaw, ומפעיל את תהליך הקליטה (onboarding).

הערה: משתמשי שולחן עבודה של Windows יכולים גם להתקין את אפליקציית הליווי המקורית Windows Hub, הכוללת הגדרה, סטטוס ב-tray, צ'אט, מצב node, ומצב MCP מקומי.

macOS / Linux / WSL2:

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

Windows (PowerShell):

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

להתקנה מבלי להפעיל את תהליך הקליטה:

macOS / Linux / WSL2:

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

Windows (PowerShell):

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

לכל הדגלים ואפשרויות ה-CI והאוטומציה, ראו קרבי תוכנית ההתקנה.

#שיטות התקנה חלופיות

#תוכנית התקנה עם קידומת מקומית (install-cli.sh)

השתמשו בזה כאשר אתם רוצים ש-OpenClaw ו-Node יישמרו תחת קידומת מקומית כגון ~/.openclaw, מבלי להסתמך על התקנת Node כלל-מערכתית:

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

היא תומכת בהתקנות npm כברירת מחדל, ובנוסף בהתקנות git-checkout תחת אותו תהליך של קידומת. מקור מלא: קרבי תוכנית ההתקנה.

כבר התקנתם? עברו בין התקנות של חבילה לבין התקנות של git באמצעות openclaw update --channel dev ו-openclaw update --channel stable. ראו עדכון.

#npm, pnpm או bun

אם אתם כבר מנהלים את Node בעצמכם:

#npm

ב-npm 12 או npm 11.16+:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

ב-npm 11.15 ומטה, השתמשו באותה פקודה ללא --allow-scripts=openclaw.

הערה: npm 12 חוסם סקריפטים לא מאושרים של מחזור חיי חבילה כברירת מחדל. האפשרות --allow-scripts=openclaw מאשרת במפורש את שלבי ה-preinstall וה-postinstall של OpenClaw. בלעדיה, npm מדווח עליהם כ-blocked because they are not covered by allowScripts.

npm 11.16 מקבל את האפשרות, אך מלבד זאת רק מזהיר שהסקריפטים הם not yet covered by allowScripts ועדיין מריץ אותם. ל-npm 11.15 ולגרסאות מוקדמות יותר אין את המדיניות ואין את האפשרות, ולכן הפקודה עבורן חייבת להיות ללא הדגל. הפקודה npm approve-scripts openclaw שמוצעת על ידי npm 11.16 אינה עובדת עבור התקנה גלובלית, היא נכשלת עם ENOMATCH No installed packages match: openclaw.

הערה: תוכנית ההתקנה המאוחסנת מנקה מסנני עדכניות של npm כגון min-release-age עבור התקנת חבילת OpenClaw. אם אתם מתקינים ידנית באמצעות npm, המדיניות שלכם ב-npm עדיין חלה.

#pnpm

pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

הערה: pnpm דורש אישור מפורש עבור חבילות הכוללות סקריפטים של בנייה. הפקודה approve-builds -g אינה נתמכת עבור התקנות גלובליות, לכן העבירו במקום זאת את --allow-build=openclaw בפקודת pnpm add -g.

#bun

bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun

הערה: הדגל --trust מאשר את סקריפטי מחזור חיי החבילה של OpenClaw עבור התקנה זו. Bun 1.4 או גרסה חדשה יותר יכול גם להריץ את ה-CLI, הסוכן המקומי וה-Gateway של OpenClaw. Node נשאר סביבת הריצה הראשית, ולכן קובץ ההפעלה הרגיל openclaw שומר על ה-shebang של Node. הפקודה bun run --bun כופה שימוש בסביבת הריצה של Bun, בעוד ש---daemon-runtime bun מתקין את ה-Gateway המנוהל תחת Bun.

#מקוד המקור

עבור תורמים לקוד או לכל מי שרוצה להריץ מתוך checkout מקומי:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install && pnpm build && pnpm ui:build
pnpm add --global "openclaw@link:$PWD"
openclaw onboard --install-daemon

הפקודה pnpm add --global "openclaw@link:$PWD" מקשרת את ה-CLI ל-checkout זה מבלי לשנות את קובצי החבילה שלו. אם pnpm מדווח שספריית ה-bin הגלובלית שלו אינה מופיעה ב-PATH, הריצו pnpm setup, פתחו מחדש את ה-shell ונסו שוב.

Corepack בוחר את גרסת ה-pnpm המדויקת מתוך package.json (כרגע pnpm 12). אם Corepack אינו זמין, התקינו את הגרסה הזו במפורש עם npm install -g [email protected] [email protected]; השאירו את סקריפטי ההתקנה של npm ואת התלויות האופציונליות מופעלים כדי ש-pnpm יוכל להקצות את קובץ ההפעלה המקורי שלו.

לחלופין, דלגו על ההתקנה הגלובלית והשתמשו ב-pnpm openclaw ... מתוך המאגר. ראו הגדרה לתהליכי עבודה מלאים לפיתוח.

#התקנה מתוך checkout של main ב-GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

#מכולות ומנהלי חבילות

  • Ansible: הקצאת צי שרתים אוטומטית.
  • Bun: מתקין תלויות אופציונלי ומריץ סקריפטים של חבילות.
  • Docker: פריסות במכולות או ללא ממשק גרפי (headless).
  • Nix: התקנה דקלרטיבית באמצעות Nix flake.
  • Podman: חלופת מכולות ללא הרשאות שורש (rootless) ל-Docker.

#אימות ההתקנה

openclaw --version      
# confirm the CLI is available
openclaw doctor         
# check for config issues
openclaw gateway status 
# verify the Gateway is running

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

  • macOS: שירות LaunchAgent באמצעות openclaw onboard --install-daemon או openclaw gateway install
  • Linux / WSL2: שירות משתמש של systemd באמצעות אותן פקודות
  • Windows מקורי: תחילה Scheduled Task, עם נסיגה לפריט כניסה בתיקיית Startup לכל משתמש אם יצירת המשימה נדחית

#השלב הבא: הרצת תהליך קליטה וחיבור ערוץ

  • תחילת העבודה: הריצו את תהליך הקליטה (onboarding), התקינו את שירות ה-Gateway ופתחו את לוח הבקרה.
  • חיבור ערוץ: שילחו הודעות לסוכן שלכם מתוך Telegram, Discord, Slack, WhatsApp ועוד.

#אירוח ופריסה

פרסו את OpenClaw על גבי שרת ענן או VPS. ראו שרת Linux לבחירת הספק המלאה (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi ועוד), פרסו באופן דקלרטיבי ב-Render, או נסו את תבנית Cloudflare Containers הניסיונית.

  • Cloudflare: פריסה ניסיונית של Worker בשילוב Container.
  • Docker VM: שלבי Docker משותפים.
  • Kubernetes: פריסת K8s.
  • macOS VM: פריסת macOS מקומית מבודדת או מתארחת.
  • Upstash Box: מארח Linux מנוהל עם גישה דרך מנהרת SSH.
  • VPS: בחרו ספק.

#גיבוי, עדכון, הגירה או הסרת התקנה

#פתרון בעיות: openclaw לא נמצא

כמעט תמיד מדובר בבעיית PATH: ספריית ה-bin הגלובלית של npm אינה נמצאת ב-PATH של ה-shell שלכם. ראו פתרון בעיות ב-Node.js לתיקון המלא, כולל הנתיב ב-Windows.

node -v           
# Node installed?
npm prefix -g     
# Where are global packages?
echo "$PATH"      
# Is the global bin dir in PATH?