✈️ פרק 8

חיבור טלגרם, לחיצה אחרי לחיצה

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

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

#שלב 1: יצירת בוט מול BotFather

1. פתחו את אפליקציית טלגרם וחפשו את המשתמש הרשמי @BotFather (ודאו שיש לידו סימן אימות כחול).
2. שלחו לו את הפקודה /newbot.
3. הזינו שם תצוגה עבור העוזר שלכם (לדוגמה: My Personal AI).
4. הזינו שם משתמש ייחודי באנגלית המסתיים בסיומת bot (לדוגמה: my_personal_claw_bot).
5. BotFather יחזיר לכם הודעת סיכום הכוללת טוקן גישה ארוך (HTTP API Token). העתיקו את הטוקן ושמרו אותו במנהל סיסמאות מאובטח.

#שלב 2: הזנת הטוקן ב-OpenClaw

במחשב שבו רץ ה-Gateway, פתחו חלון טרמינל והריצו:

openclaw configure

1. בתפריט בחרו בערוץ Telegram.
2. הדביקו את טוקן ה-API שהעתקתם מ-BotFather ולחצו Enter.
3. ודאו שמדיניות ה-DM מוגדרת כ-pairing.
4. הפעילו מחדש את שרת ה-Gateway לקליטת ההגדרות:

openclaw gateway restart

[!NOTE] ערוץ טלגרם אינו דורש הרצה של openclaw channels login. הטוקן מספק את כל נתוני האימות הנדרשים.

#שלב 3: שליחת הודעה ראשונה מהטלפון

1. היכנסו בטלגרם לבוט החדש שיצרתם ולחצו על Start (או שלחו את המילה שלום).
2. אם מוגדרת מדיניות pairing, הבוט ישיב בהודעה המכילה קוד צימוד ייחודי בן 8 תווים. המערכת תמתין לאישורכם ולא תעבד את ההודעה מול המודל עד לאישור הקוד.

#שלב 4: אישור בקשת הצימוד (Pairing Approval)

באפשרותכם לאשר את בקשת הצימוד באחת משתי דרכים:

#דרך לוח הבקרה בדפדפן

היכנסו ללוח הבקרה המקומי (openclaw dashboard), עברו לנתיב Settings -> Channels -> DM access requests, אתרו את הבקשה ולחצו על Approve.

#דרך שורת הפקודה בטרמינל

צפו ברשימת הבקשות הממתינות:

openclaw pairing list telegram

אשרו את הבקשה באמצעות הקוד שקיבלתם:

openclaw pairing approve telegram <PAIRING_CODE>

[!IMPORTANT] קוד הצימוד תקף למשך שעה אחת בלבד, וכל חשבון מוגבל לעד 3 בקשות ממתינות במקביל. לאחר האישור, שלחו שוב הודעה בצ'אט והעוזר ישיב לכם מיד.

#איתור מזהה המשתמש המספרי שלכם (User ID)

כדי להוסיף את עצמכם לרשימת מורשים קבועה (allowlist) ללא צורך באישור עתידי, דרוש מזהה המשתמש המספרי שלכם בטלגרם:

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

openclaw logs --follow

3. אתרו בלוג שורה המכילה את השדה from.id (מספר בן 9-10 ספרות). זהו המזהה האישי שלכם.

#שימוש בבוט בתוך קבוצות טלגרם

כדי לשלב את העוזר בקבוצה:

1. הוסיפו את הבוט כחבר בקבוצה הרצויה.
2. אם ברצונכם שהבוט יוכל לקרוא הודעות מבלי שתתייגו אותו בכל פעם, היכנסו ל-BotFather, שלחו /setprivacy, בחרו בבוט שלכם ובחרו ב-Disable. לאחר מכן הוציאו והחזירו את הבוט לקבוצה.
3. אתרו בלוגים את מזהה הקבוצה המספרי (מזהה קבוצת-על בטלגרם מתחיל בקידומת -100).
4. הוסיפו את מזהה הקבוצה לרשימת הקבוצות המורשות בהגדרות הערוץ.
5. בקבוצה עצמה, תייגו את הבוט: @YourBotName שלום.

#תקלות נפוצות ופתרונן

• שגיאת 401 Unauthorized: הטוקן שהוזן שגוי או בוטל ב-BotFather. הפיקו טוקן חדש והזינו אותו מחדש ב-openclaw configure.
• הבוט אינו מגיב להודעות: בדקו ששרת ה-Gateway פעיל באמצעות openclaw gateway status ובדקו את תקינות הערוץ באמצעות openclaw channels status.
• הבוט מתעלם מהודעות בקבוצה: ודאו שתייגתם את הבוט במפורש ושהקבוצה מופיעה ברשימת הקבוצות המורשות.

בפרק הבא נלמד כיצד לחבר את ערוץ הוואטסאפ באמצעות סריקת ברקוד.