התקנת OpenClaw והגדרת OmniProxy

OpenClaw הוא עוזר AI המותקן על המחשב האישי שלכם. ניתן לשוחח איתו ישירות דרך Telegram, Discord, WhatsApp או Feishu מבלי להשאיר חלון צ’אט נוסף פתוח. השיחות והרישומים נשארים במחשב זה, והוא יכול להמשיך לבצע שלבים עוקבים באופן מקומי.

לפני שמתחילים

OpenClaw דורש Node 24.16 ומעלה. ניתן להשתמש גם ב-Node 26.1 ומעלה, כאשר Node 26 היא הגרסה המומלצת. Node מספק את סביבת הריצה הנדרשת על ידי OpenClaw.

ניתן להתקין אותו על macOS, Linux ו-Windows. אם במחשב אין גרסת Node מתאימה, סקריפט ההתקנה יכין אחת באופן אוטומטי: Node 26 ב-macOS ו-Node 24 LTS ב-Linux. pnpm נדרש רק כאשר בונים את OpenClaw מקוד המקור.

אם מותקנת כבר גרסה ישנה יותר של Node, אין צורך להסיר אותה תחילה. במהלך בדיקה ב-2026-10-09, גרסת ה-Node המערכתית במחשב זה הייתה 24.2.0, נמוכה מהנדרש (24.16), וסקריפט ההתקנה הלא-אינטראקטיבי הכין אוטומטית את Node 24.21.0.

רוצים חלון גרפי

בן לוויה לשולחן העבודה

• השתמשו במתקין Hub ב-Windows
• השתמשו ב-DMG מ-GitHub ב-macOS
• ניתן להתקין את ה-Gateway המקומי במהלך ההגדרה הראשונית

מומלץ רשמית

סקריפט התקנה

• macOS Linux WSL2
• השתמשו ב-PowerShell ב-Windows
• ניתן להוסיף --no-onboard

Node כבר מותקן

מנהל חבילות

• npm pnpm או bun
• לאחר מכן הריצו onboard
• ראו את דף ההתקנה עבור גרסת ה-Node

התקנה והפעלה ראשונית

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

אם ברצונכם בחלון גרפי

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

בעת הפתיחה הראשונה, ניתן לאפשר ל-OpenClaw להכין את ה-Gateway במחשב זה או להתחבר ל-Gateway מרוחק קיים.

התקנה דרך הטרמינל

עבור macOS, Linux ו-WSL2, השתמשו ב:

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

עבור Windows PowerShell, השתמשו ב:

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

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

אם אינכם רוצים להתחיל את ה-onboarding עדיין, השתמשו בפקודה הבאה במקום זאת ב-macOS, Linux ו-WSL2:

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

ב-Windows, השתמשו באפשרות ה--NoOnboard הרשמית:

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

אם אתם מנהלים את Node בעצמכם, ניתן להשתמש גם ב-npm, pnpm או bun. עם npm 12 או npm 11.16 ומעלה, הריצו:

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

עבור npm 11.15 וגרסאות מוקדמות יותר, הסירו את --allow-scripts=openclaw. בעת שימוש ב-pnpm, הוסיפו את --allow-build=openclaw. עיינו בדף ההתקנה להבדלים המדויקים.

לאחר ההתקנה, הריצו את שלוש הפקודות הללו לפי הסדר:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version מציג את הגרסה, openclaw doctor בודק בעיות סביבה נפוצות, ו-openclaw gateway status מראה האם ה-Gateway פועל. ההתקנה הבסיסית הושלמה רק כאשר כל שלוש הפקודות מפיקות פלט תקין.

אם הטרמינל מדווח שלא ניתן למצוא את openclaw, בדרך כלל תיקיית ה-bin הגלובלית של npm חסרה ב-PATH. PATH היא רשימת המיקומים שבהם הטרמינל מחפש תוכניות. השוו את הפלט של node -v, npm prefix -g ו-echo "$PATH", הוסיפו את תיקיית ה-bin המתאימה ל-PATH, ואז פתחו מחדש את הטרמינל.

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard הוא התנהגות ברירת המחדל של סקריפט זה. ב-2026-10-09, פקודה זו התקינה את OpenClaw 2026.9.9. לאחר ההתקנה, הריצו את קובץ ההפעלה openclaw מתיקיית ה-bin.

קבלת ערכי חיבור מ-OmniProxy

תחילה ודאו ש-OmniProxy פועל, ואז פתחו את רשימת המודלים שלו והכינו את שלושת הערכים הבאים:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl היא הכתובת אליה OpenClaw שולח בקשות למודל, והיא חייבת להסתיים ב-/v1. בעת התחברות ל-OmniProxy, השתמשו ב-openai-completions עבור api. שנו ל-openai-responses רק אם המודל אכן פועל דרך /v1/responses.

מזהה המודל (Model ID) הוא המזהה המלא של המודל ברשימה. העתיקו אותו בדיוק כפי שהוא מוצג, כולל כל קו נטוי (/). שני השמות הבאים הם ייחוסים בלבד מתיעוד הספקים נכון ל-2026-10-09; אל תשתמשו בהם אם הם אינם מופיעים ברשימה: claude-sonnet-5-5, gpt-6-luna.

גם אם ה-gateway אינו מאמת את המפתח, apiKey עדיין חייב להכיל ערך. ניתן להשתמש במחרוזת placeholder המשמשת רק במחשב זה. אל תבצעו commit של מפתח אמיתי למאגר קוד (repository).

הזנת הגדרות הכלי

ניתן להבין ספק (Provider) כאוסף של הגדרות חיבור שבהן OpenClaw משתמש כדי לאתר שירות מודלים. כאן, הספק נקרא omniproxy.

הריצו את הפקודה הבאה בטרמינל, תוך החלפת הכתובת, המפתח ושני מזהי המודלים בערכים שלכם:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

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

לאחר מכן, ציינו את מודל ברירת המחדל. ייחוס המודל מורכב מ-omniproxy/ ואחריו מזהה המודל. שמרו על כל קו נטוי שכבר קיים במזהה. אם המזהה ברשימת המודלים ארוך מהשם הקצר למטה, השתמשו בערך המלא מתוך הרשימה:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

ניתן להשמיט את reasoning, input, cost, contextWindow ו-maxTokens. כאשר הם אינם מסופקים, מודלי טקסט מטופלים באמצעות ברירות המחדל.

ניתן גם לכתוב את אותן הגדרות ישירות לקובץ ההגדרות. בהגדרות הראשיות, הספק ממוקם תחת models.providers. לכל סוכן (agent) יכולות להיות גם הגדרות models.json משלו; סוכן הוא מופע עוזר המקבל בפועל משימות וקורא למודלים. הקובץ ממוקם ב-agent/models.json בתוך תיקיית הסוכן המתאימה תחת ~/.openclaw/agents/.

אם models.json זה מכיל baseUrl שאינו ריק, הוא דורס את הכתובת בהגדרות הראשיות.

בדיקת התקנה

שלוש פקודות

• openclaw --version
• openclaw doctor
• gateway status

הגדרה

models.providers

• baseUrl מסתיים ב-/v1
• הגדרת ה-api ל-completions
• ציין לפחות את מזהה המודל (model id)

בחר

provider/model

• השתמש בהפניה זו כראשית
• העדף שימוש במשתנה סביבה עבור המפתח
• השתמש ברשימת ה-gateway כמקור האמת

אימות משימה אמיתית

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

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local מריץ את משימת הסוכן הזו באופן מקומי, --model מציין את המודל לשימוש בהרצה זו, ו---timeout 300 מגדיר את זמן ההמתנה המקסימלי ל-300 שניות.

תגובת מודל אמיתית חייבת להופיע בטרמינל. ב-2026-10-09, OpenClaw 2026.9.9 קיבל תגובה באמצעות פקודה זו. הקריאה הראשונה עשויה לקחת דקה או שתיים.

אם מופיעה השגיאה המקורית Request timed out before a response was generated, הגדילו את --timeout ושלחו את הבקשה שוב. הדבר מצביע בדרך כלל על כך שזמן ההמתנה לא היה מספק ואינו מעיד בהכרח על כך שהכתובת שגויה.

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

התקנה

הפקודה מגיבה

• מספר הגרסה מוצג
• ה-doctor מדווח שאין חסימות
• סטטוס ה-gateway קריא

משימה

היא השלימה משימה קטנה

• לדוגמה, קריאת קובץ מקומי
• התגובה אינה שגיאה
• הפניית המודל נכונה

יומנים (Logs)

גלוי ב-gateway

• המקור הוא OpenClaw
• מזהה המודל תואם
• המפתח לא נוסף למאגר (repository)

שגיאות נפוצות

• לא ניתן למצוא את openclaw: הוסיפו את תיקיית ה-bin הגלובלית של npm ל-PATH, ואז פתחו מחדש את הטרמינל. אם התקנתם לתיקייה שצוינה, הריצו את קובץ ההפעלה מתיקיית ה-bin של אותה תיקייה.
• node -v נמוך מ-24.16: אין צורך להסיר את הגרסה הישנה תחילה. בדקו את גרסת ה-Node שהוכנה על ידי סקריפט ההתקנה, או השתמשו ב-24.16+ או 26.1+ כמתואר בדף ההתקנה. Node 26 היא המומלצת.
• המודל אינו מופיע: המודל חייב להיות כלול במערך ה-models תחת models.providers וחייב לכלול לפחות את אותו id. הגדרת agents.defaults.models בלבד אינה רושמת מודל חדש בפני עצמה.
• תגובת 400 מזכירה את תפקיד המפתחים (developer role): כאשר מארח הכתובת אינו api.openai.com, שמרו על ברירת המחדל ואל תגדירו את supportsDeveloperRole ל-true. גם אם הוא מוגדר ל-true, הוא עדיין יידרס.
• מתקבל timeout במהירות: הגדילו את --timeout ליותר מ-300 שניות לפני שינוי הכתובת.
• קריאות כלים נכשלות לאחר בחירת gpt-6-luna: הוא תומך ב-Chat Completions; קריאות לפונקציות ב-Chat Completions נתמכות רק כאשר reasoning_effort הוא none. אם המזהה ברשימה שונה מזה, השתמשו במזהה המוצג ברשימה.
• לא ניתן להגיע לכתובת: ודאו ש-OmniProxy פועל, ש-baseUrl מסתיים ב-/v1, ושניתן לגשת לכתובת שנכתבה להגדרות. כתובות רשת פרטיות אחרות חייבות להיות מורשות בנפרד.
• בקשות עדיין נשלחות לכתובת אחרת לאחר ההגדרה: בדקו האם ה-models.json של אותו סוכן מכיל baseUrl שונה.

הפניות רשמיות

לשלבי התקנה, ראו OpenClaw install. להגדרת ספק מותאם אישית, ראו Custom providers ו-configuration fields. למזהי המודלים המשמשים בדוגמאות, השוו מול Claude model overview ו-GPT-6 Luna.

החלף כל מקום לשימוש בערכים מההגדרה שלך ב-OmniProxy. לעולם לא פרסם מפתח אמיתי.

תוצאה שמורה או HTTP 200 בלבד אינם מוכיחים תאימות מלאה של הסוכן. בדוק את המקור והמודל ברשומת הקריאה של OmniProxy.

מקורות רשמיים · OpenClaw ↗