📘 תיעוד 2

התקנה

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

• Node 24.16.0+ על ענף 24.x, או 26.1.0+ (24.22.1+/26.12.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 מספקת יישומי ליווי לשולחן העבודה:

• Windows (מומלץ): אפליקציית הליווי המקורית Windows Hub, מתקין חתום שמורידים ומריצים כמו כל אפליקציית Windows, עם התקנה, סטטוס במגש, צ'אט ומצב node:
  • OpenClawCompanion-Setup-x64.exe
  • OpenClawCompanion-Setup-arm64.exe
  • כל מהדורות ה-Hub: דף המהדורות של Windows Hub
• macOS: אפליקציית שורת התפריט של macOS. הורידו את הנכס OpenClaw-<version>.dmg (מועדף) או .zip מ-מהדורות OpenClaw ב-GitHub, ואז התקינו והפעילו את OpenClaw.app. ראו דף אפליקציית macOS לפרטים, כולל מה לעשות כשהמהדורה החדשה ביותר יוצאת בלי נכס macOS.

ב-Windows, אפליקציית שולחן העבודה Tauri חוצת הפלטפורמות היא אפשרות הגיבוי. מתקין OpenClaw-<version>-windows-x86_64.exe שלה מגיע במהדורות OpenClaw הרגילות, ויכול להגדיר Gateway מקומי של Windows עם Bun כלול, או להתחבר מרחוק.

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

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

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

להתקנה בלי להריץ onboarding:

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 כברירת מחדל, ובנוסף בהתקנות מ-checkout של git באותו תהליך קידומת. הפניה מלאה: פנימיות המתקין.

כבר מותקן? עברו בין התקנת חבילה להתקנת 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.4 או חדש יותר יכול גם להריץ את ה-CLI של OpenClaw, את הסוכן המקומי ואת ה-Gateway. 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, פתחו מחדש את המעטפת, ונסו שוב.

ל-checkout של שרת שמריץ רק את OpenClaw, השתמשו ב-pnpm build:runtime כדי לבנות את ה-JavaScript, את התוספים, את Control UI ואת המטא-נתונים בלי הצהרות TypeScript. השתמשו ב-pnpm build לפיתוח או לאריזה שצריכים הצהרות ואת האימות שלהן. בדיקות הטיפוסים ב-CI עדיין חלות על בניות runtime בלבד.

Corepack בוחר את גרסת pnpm המדויקת מ-package.json (כרגע pnpm 12). אם Corepack לא זמין, קראו את הגרסה הזו מה-checkout והתקינו אותה במפורש:

pnpm_spec=$(node -p "require('./package.json').packageManager.split('+')[0]")
npm install -g "$pnpm_spec" --allow-scripts="$pnpm_spec"

סיומת + מתעדת את גיבוב השלמות של Corepack ואינה חלק ממזהה חבילת npm. השאירו את סקריפטי ההתקנה של npm ואת התלויות האופציונליות מופעלים כדי ש-pnpm יוכל להקים את קובץ ההרצה המקורי שלו.

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

#בניות עצמאיות

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

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

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: חלופת קונטיינר ללא root ל-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 וחיבור ערוץ

• תחילת העבודה: הריצו 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 מעודכן.
• העברה: מעבר למכונה חדשה.
• הסרה: הסרה מלאה של OpenClaw.

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

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

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