💬 פרק 9

חיבור וואטסאפ, ברקוד ואישור

ערוץ הוואטסאפ של OpenClaw מאפשר לכם לשוחח עם העוזר ישירות מתוך אפליקציית וואטסאפ. החיבור נשען על ספריית הקוד הפתוח Baileys המדמה התחברות של WhatsApp Web (כמכשיר מקושר נוסף בחשבון). אין צורך בהקמת חשבון עסקי של Meta או בשירותי צד שלישי כמו Twilio.

הפרק מבוסס על התיעוד הרשמי בכתובת docs.openclaw.ai/channels/whatsapp.

#הבחנה קריטית: שני סוגי אישורים שונים

לפני שמתחילים, חובה להבין את ההבדל בין שני שלבי האימות:

1. ברקוד התחברות ראשוני (Login QR Code): מחבר את חשבון הוואטסאפ של העוזר אל שרת ה-Gateway, בדיוק כמו חיבור מחשב ב-WhatsApp Web.
2. קוד צימוד משתמש (User Pairing Code): מאשר לאדם ספציפי לשוחח עם העוזר ולקבל תשובות.

סריקת הברקוד אינה מאשרת שולחים אוטומטית, וקוד הצימוד אינו מחבר את החשבון ל-Gateway.

#המלצה: שימוש במספר טלפון ייעודי

התיעוד הרשמי ממליץ בחום להקצות מספר טלפון ייעודי (כרטיס סים משני או מספר וירטואלי) עבור העוזר:

• שימוש במספר ייעודי מונע ערבוב בין שיחות פרטיות וקבוצות משפחתיות לבין קלט המועבר לעיבוד אצל המודל.
• שימוש במספר האישי הראשי (Self-Chat) אפשרי, אך מחייב זהירות רבה כדי שהודעות אישיות לא יהפכו בטעות להנחיות עבור סוכן ה-AI.

#שלב 1: התקנת תוסף הוואטסאפ

ערוץ הוואטסאפ אינו חלק מחבילת הליבה, אלא תוסף רשמי ממאגר ClawHub. מתקינים אותו באמצעות:

openclaw channels add --channel whatsapp

או ישירות דרך מנהל התוספים:

openclaw plugins install clawhub:@openclaw/whatsapp

לאחר ההתקנה, מפעילים מחדש את ה-Gateway:

openclaw gateway restart

#שלב 2: סריקת קוד QR לקישור החשבון

במחשב שבו רץ שרת ה-Gateway, מריצים את פקודת ההתחברות:

openclaw channels login --channel whatsapp

בטרמינל יוצג קוד QR גרפי חי:

1. פתחו את אפליקציית וואטסאפ בטלפון של מספר העוזר.
2. היכנסו ל-הגדרות (Settings) -> מכשירים מקושרים (Linked Devices).
3. לחצו על קישור מכשיר (Link a Device).
4. סרקו את קוד ה-QR המוצג על גבי מסך המחשב.

[!NOTE] קוד ה-QR מתרענן כל מספר שניות. יש לסרוק אותו ישירות מהמסך החי. אם אתם מנהלים שרת לינוקס ללא מסך גרפי (Headless VPS), השתמשו במנהרת SSH עם הפניית פורט ללוח הבקרה המקומי כדי לצפות בברקוד בדפדפן.

לאחר השלמת הסריקה, בודקים שהחיבור תקין:

openclaw channels status --probe

בפלט אמור להופיע הסטטוס Linked (ולא QR required).

#שלב 3: אישור עצמי לשיחה פרטית (Pairing)

1. מהטלפון האישי שלכם, שלחו הודעת וואטסאפ למספר הטלפון של העוזר: שלום.
2. אם מוגדרת מדיניות pairing, תקבלו הודעת תשובה מוואטסאפ עם קוד צימוד בן 8 תווים.
3. אשרו את הבקשה באחת משתי הדרכים:
   • בלוח הבקרה בדפדפן: תחת Settings -> Channels -> DM access requests.
   • בטרמינל:

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <PAIRING_CODE>

4. לאחר האישור, שלחו הודעה נוספת והעוזר ישיב לכם מיד.

#תצורת מדיניות מומלצת

בהגדרות הערוץ (בקובץ ההגדרות או דרך openclaw configure), מומלץ להשתמש בתצורה הבאה:

• מדיניות DM: ערך pairing או allowlist.
• פורמט מספרי טלפון: תמיד בפורמט בינלאומי מלא עם סימן פלוס (לדוגמה: +972501234567).
• קבוצות: רשימת מורשים סגורה (Allowlist) עם חובת תיוג של העוזר.

#תקלות נפוצות וניתוקים

• מצב שקט אינו מעיד על ניתוק: פרוטוקול הוואטסאפ שומר על החיבור גם כאשר לא מתקבלות הודעות. אין לסרוק ברקוד מחדש ללא צורך.
• אבחון מעמיק: הריצו openclaw channels status --probe ו-openclaw doctor כדי לבדוק את תקינות הסשן בדיסק.
• מניעת התנגשות מול GOWA: אין להשתמש באותו מספר וואטסאפ ובאותה תיקיית סשן בו-זמנית עבור OpenClaw ועבור GOWA. לכל כלי יש להקצות מופע נפרד.

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