OpenClaw 5.2: המדריך המלא לעדכון היציבות והביצועים הגדול

The Pulse:

• מנגנון ה-doctor החדש ב-OpenClaw 5.2 מזהה רשומות התקנה שמצביעות לקבצים שנמחקו ומתקין מחדש אוטומטית לפני מסלול העדכון הרגיל, כך שסטאק שבור למחצה הופך לדבר עבר.
• gateway startup ב-5.2 מפסיק להריץ plugin backoff profile overlays במהלך secret preflight, ומפסיק לחשב מחדש את אותו hash בכל פעם ב-tool descriptor planning, שני שינויים שמקצרים את זמן האתחול באופן מורגש אפילו בסטאק עם 15 פלאגינים ועשרות sessions פעילות.
• פרצת האבטחה בנתוב הודעות נסגרה: Telegram ID עם prefix של telegram: יכול היה להתנתב דרך WhatsApp כ-fallback, ו-xAI Grok web search קיבל timeout ברירת מחדל של 60 שניות עם structured timeout errors במקום קריסה שקטה של ה-tool call.

OpenClaw 5.2 הוא העדכון השני בסדרת 5.x, והוא מתמקד בדיוק במה שמפריע למי שמריץ אוטומציות בפרודקשן: פלאגינים שנשברים אחרי עדכון, gateway שמתעכב בהפעלה, ונתוב הודעות שמגיע למקום הלא נכון. הפער בין "עדכון שמוסיף פיצ'רים" לבין "עדכון שגורם לסטאק לעבוד כמו שהיה אמור תמיד" הוא בדיוק מה שמייחד את הגרסה הזו.

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

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

תיקון התקנת הפלאגינים: NPM-First ו-Doctor Repair

אם התקנת פלאגין ב-OpenClaw והוא נשבר אחרי עדכון, או שרשומת ההתקנה אמרה שהוא קיים אבל הקבצים נעלמו מהדיסק, אתה לא לבד: זה היה הבעיה המרכזית שכולם שנאו. גרסה 5.2 עשתה מעבר NPM-first מלא לפלאגינים חיצוניים, וזה משנה הכל. כעת רשומות ההתקנה בעצם תואמות את מה שקיים על הדיסק, במקום להשאיר אותך עם סטאק שבור למחצה שנראה שהכל בסדר.

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

הגישה הקונוונציונלית	הגישה של OpenClaw 5.2
רשומות התקנה מצביעות לקבצים שנמחקו, אבל השינוי לא מזוהה	doctor מזהה קבצים חסרים ומתקין מחדש לפני המסלול הרגיל של העדכון
עדכון כושל משאיר סטאק שבור למחצה ללא הודעה ברורה	עדכון נכשל בקול רם עם הודעה שגיאה מפורשת
אין דרך לדעת אם תלויות החבילה בעצם מותקנות	openclaw plugins list מדווח בבירור על מצב ההתקנה של כל תלות
ClawHub אין metadata על מה נשבר או למה	ClawHub מעביר Clawpack metadata בכל רשומות ההתקנה: הרופא יש "קבלות"
עדכוני beta channel מדלגים או מוריידים בשקט	עדכוני beta channel מתבצעים בצורה אמינה ללא דילוגים

המעבר ל-NPM-first אומר שפלאגינים חיצוניים זורמים דרך npm בדיוק כמו שאתה מצפה. רשומות ההתקנה בעצם תואמות את מה שנמצא על הדיסק. אם רשומת התקנה של פלאגין מצביעה לקבצים שנעלמו במהלך עדכון OpenClaw, ה-doctor עכשיו תופסת זאת, מתקינה מחדש לפני שמסלול העדכון הרגיל רץ, ואומרת לך בדיוק מה קרה. אם משהו עדיין מצביע על payload חסר אחרי זה, העדכון נכשל בקול רם במקום להשאיר אותך עם סטאק שבור למחצה שנראה שהכל בסדר. זה ענק, כי הסוג הגרוע ביותר של באג הוא זה שמעמיד פנים שהכל עובד בצורה חלקה.

בנוסף לזה, openclaw plugins list עכשיו מדווח האם תלויות החבילה שלך בעצם מותקנות. בתוך ה-JSON, הסקריפטים והאג'נטים שלך יכולים לזהות את הפער ללא צורך לטעון את הפלאגין בזמן ריצה ולהתרסק. ClawHub קיבל את אותה טיפול. Diagnostics, onboarding, doctor repair, וגם channel setup כולם מעבירים Clawpack metadata דרך רשומות ההתקנה עכשיו, מה שאומר שכשה-doctor מנסה להבין מה השתבש, יש לה בעצם את "הקבלות". עדכוני beta channel של פלאגינים תוקנו גם כן. אם היית על beta channel והתקנה שלך הייתה מתדרדרת או מדולגת בעדכון, זה נעלם. כל שכבת הפלאגין פשוט מרגישה ממש טוב עכשיו, מה שקצת מדהים.

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

מהירות Gateway: פחות latency, אתחול מהיר יותר, פקודת restart חדשה

OpenClaw 5.2 מקצר משמעותית את זמן אתחול ה-gateway על ידי הסרת חישובים מיותרים ממסלול ההפעלה הקריטי, ופקודת restart חדשה עם force ו-wait flags מחסכת זמן בייביסיטינג של משימות תקועות. אם סטאק שלך עם 15 פלאגינים או עשרות sessions פעיל היה מרגיש איטי אחרי restart, העדכון הזה יהיה מורגש מיד.

הצוות עברו על כל ה-hot path (מסלול ההפעלה הקריטי שרץ בכל בקשה) וחיתכו שומן בכל שכבה. Gateway startup כבר לא מריץ plugin backoff profile overlays במהלך secret preflight, מה שלבדו מקצר משמעותית את ה-latency של gateway readiness. ה-reload OAuth recovery path עדיין מקבל את ה-overlays כשהם בעצם נדרשים, אבל בהפעלה רגילה הם כבר לא משקעים את הזמן. Session listing הפך הרבה יותר זול מבחינת compute, task maintenance הפך הרבה יותר זול, prompt prep הפך זול יותר, ו-plugin loading הפך זול יותר. כל אחד מהתיקונים הללו קטן בנפרד, אבל ביחד הם יוצרים הבדל משמעותי בזמן התחלה כללי.

הנקודה הקריטית היא שה-tool descriptor planning step עצר לחשב מחדש את אותו hash בכל פעם. אם יש לך runtime config גדול, התשובות שלך לא יהיו חסומות עוד כל זמן שOpenClaw בונה מחדש את אותו hash שוב ושוב. File system guards הפכו הרבה יותר חזקים. התוצאה היא שאם הרגשת שהסטאק שלך מתעכב כשאתה מוסיף יותר פלאגינים, פשוט עדכן ל-5.2 וראה מה קורה: הסטאק שלך יהיה מהיר יותר בצורה ניכרת. אתה לא צריך לשנות כלום בקונפיגורציה שלך. אתה פשוט תרגיש את זה מיד כשאתה מעלה מחדש את ה-gateway.

יש גם פקודת gateway restart חדשה שכדאי להזכיר. openclaw gateway restart עכשיו מקבלת force flag ו-wait flag עם duration. זה אומר שאם יש לך משימה תקועה ואתה צריך שה-gateway יהיה בחזרה בפעולה עד deadline, אתה יכול לעשות את זה בפקודה אחת במקום להשגיח עליה. ה-active task run IDs מתועדים לפני שה-restart deferral מתחיל, וtimeout restarts עכשיו מדווחים כ-explicit force restarts בלוגים. כשאתה חוזר וחוקר מה קרה, אתה יכול בעצם להגיד. זה דבר קטן, אני יודע, אבל אם אתה מריץ cron job שתלוי בזה שה-gateway יהיה בריא, זה חשוב הרבה.

מה זה אומר בפועל: gateway שמתחיל 30-40% מהר יותר ו-restart command שחוסך בייביסיטינג משמעו שצוותים שמריצים אוטומציות בפרודקשן כבר לא מאבדים שעות בהמתנה להתחלה מחדש של infrastructure.

Control UI, WebChat ונתוב הודעות: מה תוקן בממשק ובערוצים

תיקונים קריטיים בממשק הבקרה וערוצי ההודעות מונעים אובדן תגובות חיות, חוצי-ניתוב בין ערוצים, וטעויות rendering שהשפיעו על כל משתמש יום-יום. ה-Control UI הוא המקום שבו אתה מבלה את רוב הזמן אם אתה מריץ אוטומציות ב-OpenClaw: כל בדיקה של session, כל הפעלת cron job, כל בחינה של תגובות agent. התיקונים ב-5.2 נוגעים לכל זוויות של הממשק הזה, וגם לערוצי ההודעות שם בעצם חיים ה-agents שלך.

באג שהיה שותק וקשה לאבחון היה זה: כשאתה שולח chat turn מ-session alias גולמי כמו "main", אבל ה-gateway פולט events תחת canonical session key שונה לאותה ההרצה, התגובות החיות שלך פשוט נעלמות מה-UI באמצע הזרימה. זה לא אומר שה-model הפסיק לעבוד: הוא עדיין עובד, אבל ה-UI לא מציג את התוצאות. התיקון ב-5.2 סוגר את כל המחלקה הזאת של באגים. אם אי פעם הרגשת שהתגובה שלך פשוט התחילה להיעלם, זה כנראה היה בדיוק זה, וזה נעלם עכשיו. בנוסף, ה-iOS PWA bounds: אם התקנת את OpenClaw לבית הבחירה שלך ב-iPhone: סבלו מחיתוך בתחתית המסך. זה תוקן. selection contrast כשאתה מדגיש טקסט בצ'אט, אתה יכול להקרא עכשיו. talk diagnostics הופכים הרבה יותר נקיים. כל ה-dashboard פשוט מרגיש יותר הדוק.

ערוצי ההודעות: כאן בעצם חיים ה-agents שלך. זה המקום שבו רוב הקהילית שלנו מתגוררת. אם אתה מריץ OpenClaw עם Telegram, WhatsApp, Discord, Slack, או כל משהו אחר, זה הממשק בפועל שלך לעולם. ב-5.2, הצוות הלך עמוק בכל אחד מהם. ב-WhatsApp, channel targets ו-newsletter targets עובדים כראוי עכשיו: אם אי פעם ניסית לחוות agent ל-WhatsApp channels ופשוט לא הוא לא הספיק, אתה יודע בדיוק את החלק המתסכל של זה. Telegram topic commands וה-networking התחזקו. Discord delivery ו-startup edge cases נוקו. Slack קיבל run ענק של תיקונים עבור one-to-one DMs ו-thread routing: top-level DMs נשארים על stable DM sessions, public channel allow list matching עובד, וה-routing syntax עכשיו מקבל channel colon, user colon, ו-at bracket user format בדיוק כמו שהיית מצפה. Signal groups ו-media routing תוקנו בו זמנית. invisible reply routing התחזק על פני הלוח כולו. הנקודה: ההודעה הנכונה הולכת למקום הנכון.

אבל יש צד אבטחה ממשי וחשוב לתיקוני ההודעות הללו שכולם צריכים לדעת עליו. הצוות עשה את זה כך ש-provider prefix targets לא יכול להיות מנוצל לערוץ שגוי יותר. לפני תיקון זה, Telegram ID עם prefix של "telegram:" יכול היה להתנתב דרך WhatsApp כ-fallback אם ה-delivery נפל חזרה לערוץ האחרון. ההפרצה הזאת נסגרה עכשיו. אם אתה דואג לרישות ניתוב ערוצים, התיקון הזה לא קיבל כותרת מהבהבת, אבל זה בדיוק סוג הדבר שחשוב כשאתה מריץ workflows שבעצם נוגעים לאנשים אמיתיים בערוצים אמיתיים. cron scheduler גם קיבל עדכון בטיחות משמעותי: אם היה לך cron entry אחד שגוי, ההתנהגות הישנה הייתה שכל ה-tick יבטל, מה שאומר שcron אחד רע יכול בשקט להרוג את כל ה-cron jobs האחרים שלך. ב-5.2, ה-scheduler reload סובל עכשיו ממערכי cron פגומים במקום לבטל את כל ה-tick. ה-crons הטובים שלך ממשיכים לירות. בצד ה-heartbeat, הצוות סוף סוף הסיר את legacy tool call ו-tool result pseudo-blocks שדלפו לתוך channel deliveries. אם אי פעם קיבלת Telegram או Discord message מה-agent שלך שהיה לו bracket call bracket noise בו, זה היה הבאג, וזה נעלם עם העדכון החדש הזה.

התובנה המרכזית: ערוצי ההודעות שלך עכשיו מגנים מפני cross-routing בין providers, ו-cron jobs פגומים לא יוכלו להרוג את כל ההתזמון שלך: שתי הגנות שעוזרות לך להישאר בשיווק בזמן שאתה בטוח שהודעות מגיעות לאנשים הנכונים.

תיקוני Power User: macOS Wake Path, Doctor Channel ו-Heartbeat

משתמשים מתקדמים שמריצים voice automation, cron jobs ומיגרציות בין מכונות קיבלו שלוש תיקונים קריטיים ב-5.2: wake word ו-push-to-talk transcripts עוברים כעת לסשן macOS שנבחר במקום ל-main web chat, doctor מזהה אחרי מיגרציה אם חסרים tokens ב-Telegram או Discord, והסרת legacy tool call pseudo-blocks מ-channel deliveries מונעת הודעות מקולקלות.

ב-OpenClaw, משתמשים מתקדמים המשתמשים בקול (voice automation) או בעבודות cron מתוזמנות התמודדו עם שלוש בעיות שהשפיעו ישירות על אמינות הסטאק. הראשונה: wake word ו-push-to-talk transcripts היו נשלחים תמיד ל-main web chat session, גם אם הגדרת את הקול לדבר עם agent ספציפי בסשן אחר. משמעות הדבר היא שהיית מדברת עם סוכן אחד, אך התמלול שלך היה נוחת בסשן לגמרי שונה: זו בעיה קריטית שהרסה את האמון בקול עצמו. ב-5.2, wake word ו-push-to-talk transcripts עוברים כעת ל-macOS session target שנבחר ולא ל-main web chat. משמעות הדבר: אם אמרת ל-OpenClaw "דבר עם agent X בסשן Y", זה בדיוק מה שיקרה. התמלול נוחת בסשן הנכון, ה-agent הנכון מעבד אותו, וה-context נשמר. זו נראית כמו תיקון קטן, אך עבור מישהו שמריץ voice automation בייצור, זה הבדל בין סטאק שאתה יכול להאמין וסטאק שאתה לא.

הבעיה השנייה משפיעה על כל מי שעשה migration בין מכונות או ביצע fresh install של bot ב-Telegram או Discord. אחרי migration, אם ה-default account שלך ב-Telegram או Discord לא היה עם token מוגדר, ואין fallback environment variable, הסוכן פשוט היה נפסק: ללא הודעת שגיאה שימושית. ב-5.2, doctor מזהה אחרי מיגרציה אם ל-Telegram או Discord אין token מוגדר ומפנה ל-ENV file עם documentation בטוחה של migration. במילים אחרות: אם משהו נשבר אחרי migration, doctor אומר לך בדיוק איפה להסתכל בקובץ ה-ENV שלך כדי לתקן את זה. זה חוסך שעה בערך בשעה 2 בלילה כשמשהו פשוט לא עובד.

הבעיה השלישית היא קטנה יותר אך מעצבנת עבור משתמשים שמשדרים הודעות דרך Telegram, Discord או ערוצים אחרים. legacy tool call ו-tool result pseudo-blocks הוסרו מ-channel deliveries ב-5.2. מה זה אומר? אם ה-agent שלך קרא tool ובחר להשתמש בו, קוד הפסאודו (pseudo-code) של אותה קריאה כלי היה לפעמים נוצר בתוך הודעת ערוץ: אז אתה מקבל הודעה ב-Telegram שאומרת משהו כמו "[tool_call: search_web]" במקום רק התוצאה הסופית. ב-5.2, pseudo-blocks אלה הוסרו לחלוטין. המשמעות: ההודעות שמגיעות לחברים שלך או ללקוחות שלך נראות נקיות ומקצועיות, ללא artifact של הטוקן הפנימי של OpenClaw.

יש עוד תיקון אחד קטן אך חשוב עבור power users המשתמשים בפקודת model set. אם ניסית להשתמש ב-agent flag עם model set או set image, הפקודה היתה שוקטת וכתבה את הדגם הזה כ-global default: גם אם התכוונת רק לשנות אותו לסוכן אחד. ב-5.2, model set עם agent flag נדחה עכשיו עם שגיאה ברורה במקום לכתוב global default בשקט. זה מונע את התרחיש המעצבן שבו אתה מוציא שעה לניפוי באגים כדי להבין למה הדגם הגלובלי שלך השתנה כשלא ביקשת זאת.

התובנה המרכזית: כל שלוש התיקונים הללו מטפלים בתרחישים שבהם OpenClaw משתק או מסתיר מידע קריטי: voice transcripts הולכים לסשן הלא נכון, doctor לא אומר לך איפה token חסר, וקריאות כלים מתחזות כ-pseudo-blocks בהודעות חוצות ערוצים. ב-5.2, OpenClaw מדבר בקול: הודעות שגיאה ברורות, routing נכון, ומצב נקי בערוצים: זה בדיוק מה שצריך power user כדי להריץ automation בייצור בביטחון.

שאלות נפוצות

איך מריצים את openclaw doctor עם ה-fix flag אחרי עדכון ל-5.2?

אחרי שמעדכנים ל-5.2 דרך תהליך העדכון הסטנדרטי, מריצים את הפקודה openclaw doctor –fix ישירות מהטרמינל. ה-doctor יסרוק את כל רשומות ההתקנה של הפלאגינים, יזהה כל רשומה שמצביעה לקבצים שנמחקו מהדיסק, ויתקין מחדש את הפלאגינים הרלוונטיים לפני שמסלול העדכון הרגיל רץ. אם הסטאק מרגיש מוזר אחרי העדכון, זו הפקודה הראשונה שכדאי להריץ, כי כל ה-doctor messages ב-5.2 עוצבו מחדש כדי להיות שימושיים בפועל ולא סתם הודעות שגיאה כלליות.

האם beta channel plugin installs מקבלים את אותם תיקונים כמו ה-stable channel?

כן, ב-5.2 זה סוף סוף תוקן. לפני העדכון הזה, משתמשים שהיו על ה-beta channel חוו מצב שבו התקנות פלאגינים היו מורדות לגרסה ישנה יותר או מדולגות לגמרי במהלך עדכון. הבאג הספציפי הזה נסגר ב-5.2, כך שגם beta installs עוברים עכשיו דרך מסלול ה-NPM-first המלא ומקבלים את אותה התנהגות עקבית כמו stable channel. אם ניהלתם פלאגינים על beta ושמתם לב לדגרדציות לא מוסברות, העדכון הזה פותר את הבעיה.

מה קורה אם יש לי cron entry פגום – האם 5.2 ימנע ממנו להרוג את שאר ה-cron jobs?

בדיוק זה התיקון. לפני 5.2, רשומת cron אחת פגומה הייתה מבטלת את כל ה-tick, כלומר כל ה-cron jobs האחרים שלכם היו מפסיקים לרוץ בשקט בגלל רשומה אחת בעייתית. ב-5.2, ה-scheduler reload סובל מרשומות פגומות במקום למות עליהן. ה-cron jobs התקינים ממשיכים לירות כרגיל, והרשומה הפגומה מבודדת. זה קריטי במיוחד אם יש לכם gateway health checks שרצים על cron, כי לפני העדכון רשומה אחת שגויה יכלה לשבש את כל מערך הניטור.

מה ההבדל המעשי בין force flag ל-wait flag בפקודת gateway restart?

ה-force flag מאלץ את ה-gateway לבצע restart גם אם יש tasks פעילים שרצים ברגע זה. ה-wait flag מקבל duration ומאפשר לכם לקבוע deadline מקסימלי לפני שה-restart מתבצע בכפייה. השילוב של השניים נותן שליטה מלאה: אתם יכולים לכתוב פקודה אחת שאומרת "תן ל-tasks הפעילים עד 30 שניות להסתיים, ואחרי זה תבצע restart בכל מקרה." ה-active task run IDs מתועדים ב-logs לפני ה-deferral, כך שאתם יודעים בדיוק אילו tasks הופסקו ויכולים לטפל בהם אחרי שה-gateway חוזר לפעולה.

האם שיפורי המהירות של 5.2 דורשים שינוי בקונפיגורציה הקיימת?

לא. כל האופטימיזציות של ה-hot path, הפחתת עלות session listing, tool descriptor planning ו-file system guards הן שיפורים ברמת הפנים של המערכת. אתם לא צריכים לשנות שום דבר בקונפיגורציה שלכם. פשוט מעדכנים ל-5.2 ומריצים restart לגייטוויי, והשיפור מורגש מיד. זה רלוונטי במיוחד למי שמריץ 15 פלאגינים ומעלה או עשרות sessions במקביל, שם הצבירה של החישובים החוזרים הייתה גורמת להאטה משמעותית.