📥 פרק 3

התקנה, מק וינדוס ולינוקס

ל-OpenClaw יש כמה מסלולי התקנה. בחרו מסלול אחד שמתאים למחשב שלכם, והישארו איתו.

התוכן מתבסס על עמוד ההתקנה הרשמי בכתובת docs.openclaw.ai/install.

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

אם Node חסר, סקריפט ההתקנה מתקין Node 26 ב-macOS ו-Node 24 LTS ב-Linux (ראו תאימות Node.js).

ב-Windows אפשר להתחיל מאפליקציית Windows Hub הטבעית, מסקריפט PowerShell, או מ-Gateway על WSL2. פירוט נוסף בעמוד Windows.

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

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

#Windows Hub (מומלץ ב-Windows)

אפליקציית ה-Companion של 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.

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

#סקריפט ההתקנה (הדרך המהירה)

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

[!NOTE] משתמשי שולחן עבודה ב-Windows יכולים להתקין גם את אפליקציית ה-Companion הטבעית 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 ואוטומציה ראו Installer internals.

#מסלולים חלופיים

#מתקין קידומת מקומית

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

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

הסקריפט תומך בהתקנות npm כברירת מחדל, וכן בהתקנות git-checkout תחת אותו תזרים קידומת. תיעוד מלא נמצא ב-Installer internals.

אם כבר התקנתם, תוכלו להחליף בין התקנת חבילה להתקנת git באמצעות מעבר בין ערוצים:

openclaw update --channel dev
openclaw update --channel stable

פירוט נוסף ב-Updating.

#npm, pnpm או bun

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

עם npm בגרסה 12 או 11.16+:

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

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

[!NOTE] 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.

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

עם pnpm:

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

[!NOTE] 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

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

#מקוד מקור

לתורמים לפרויקט או למי שרוצה להריץ ישירות מתוך עותק מקומי:

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 לעותק המקומי בלי לשנות את קבצי החבילה שלו. אם pnpm מדווח שתיקיית ה-bin הגלובלית אינה נמצאת ב-PATH, הריצו pnpm setup, פתחו את המעטפת מחדש, ונסו שוב.

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

npm install -g [email protected] [email protected]

השאירו את סקריפטי ההתקנה של npm ואת התלויות האופציונליות פעילים, כדי ש-pnpm יוכל לספק את קובץ ההרצה הטבעי שלו.

לחלופין, אפשר לדלג על התקנה גלובלית ולהריץ pnpm openclaw ... ישירות מתוך הריפו. לזרימות עבודה מלאות של פיתוח ראו Setup.

#התקנה מ-GitHub main

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

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

#בדיקת תקינות

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

#הפעלה מנוהלת אחרי ההתקנה

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

#השלב הבא: הרצת onboarding וחיבור ערוץ

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

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

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

#גיבוי, עדכון, מעבר והסרה

#מלכודות: 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?

#דגשים לסיום

• אל תערבבו כמה שיטות התקנה על אותה מכונה.
• pnpm נדרש רק לבנייה מקוד מקור.
• ברירת המחדל של סקריפט ההתקנה היא לפתוח את אשף ההגדרה. אם אתם מתקינים באוטומציה או ב-CI, השתמשו בדגל --no-onboard או -NoOnboard.

בפרק הבא נעבור את שלבי האשף בצורה נכונה ומאובטחת.