תוספים לבוט Telegram של סוכן AI: התקנה ובדיקה

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

אנשים מחפשים בדיוק את זה כשהם מחפשים „איך להתקין תוסף ב־Telegram”. הם לא מתכוונים לחנות מדבקות. הם רוצים לדעת איך להוסיף לבוט יכולות חדשות. בהמשך, צעד אחר צעד: מהו תוסף, היכן באמת מתקינים אותו, איך מתקינים אחד בחמש דקות ואיך נמנעים מהכנסת קוד זדוני לסוכן. התיאור הזה מבוסס על התיעוד הרשמי ועל תהליך ההתקנה שתיאר ארטמי מילר.

מידע מעשי על עבודה עם Ailoot מופיע בתיעוד.

מהו תוסף לסוכן AI, במילים פשוטות?#

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

הנה דוגמה פשוטה. התקינו תוסף לעבודה עם GitHub, והסוכן יקבל פקודות ליצירת commit, לפתיחת pull request ולסקירת היסטוריית השינויים. התקינו תוסף לסקירת קוד, והסוכן יבדוק את הקוד שלכם לאיתור שגיאות ופרצות אבטחה לפי רשימת בדיקה מוגדרת מראש. לא הגדרתם את כל זה בעצמכם: מחבר התוסף כבר חיבר הכול, ואתם רק קישרתם אותו.

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

במה תוסף שונה ממיומנות, מ־MCP ומסוכן משנה?#

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

בעולם של Claude Code, חיבור לשירות חיצוני נקרא MCP. זהו תקן שמאפשר לסוכן להתחבר ל־GitHub, למסד נתונים או לדפדפן. ארבע השורות הראשונות בטבלה הן אבני בניין נפרדות.

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

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

מה פירוש „להתקין תוסף ב־Telegram”, ומה הקשר של Telegram לזה?#

כאן מתעורר בלבול נפוץ. ל־Telegram עצמו אין תוספים: אפליקציית המסרים לא מאחסנת את היכולות של הבוט. היא מעבירה את ההודעות שלכם לסוכן ומציגה את התשובות שלו. המוח נמצא במקום אחר — במחשב הנייד שלכם או בשרת שמריץ סוכן כמו Hermes Agent, OpenClaw או Claude Code שמחובר לצ'אט.

יש שתי דרכים להתקין תוסף, ושתיהן עובדות:

1. ישירות מהצ'אט. כתבו לסוכן ב־Telegram בקשה בשפה טבעית: „תתקין לעצמך תוסף ל־GitHub”. הסוכן מתקין אותו במחשב שלו ומשיב שהוא מוכן. זה נוח כשהשרת רחוק ואתם משתמשים בטלפון.
2. במסוף. התחברו למחשב שבו הסוכן פועל והתקינו שם את התוסף באמצעות פקודה. זו הדרך האמינה יותר בפעם הראשונה: אפשר לראות את כל הפלט ולא לפספס דבר.

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

איך מתקינים תוסף בסוכן בחמש דקות?#

אדגים עם Claude Code, כי התהליך מתואר מילה במילה בתיעוד שלו וקל לחזור עליו. הפקודות זהות במסוף ובשליחה לסוכן דרך Telegram.

1. פתחו את רשימת התוספים. הפקודה /plugin פותחת חלונית ישירות במסוף, עם לשונית שמציגה את כל התוספים הזמינים ומדריך ב־claude.com/plugins. זו חנות שאפשר לעיין בה לפני ההתקנה.
2. חברו את השוק הרשמי. הזינו /plugin marketplace add anthropics/claude-plugins-official. שוק הוא מדריך שממנו הסוכן מוריד תוספים. השוק הרשמי מופעל בידי Anthropic.
3. התקינו את התוסף הדרוש לכם. השתמשו בשם התוסף ואחריו בשם השוק, כשהם מופרדים בסימן at:

/plugin install github@claude-plugins-official

4. טענו מחדש את התוספים. אם לאחר ההתקנה הבוט אומר “Run /reload-plugins to activate.”, הריצו /reload-plugins. עד לטעינה מחדש, הפקודות החדשות לא יופיעו בשיחה הנוכחית. אם מופיעה אזהרה שהטעינה מחדש תקרא שוב את השיחה, חזרו על הפקודה כך: /reload-plugins --force.

זהו. עכשיו יש לסוכן את הפקודות של התוסף. ב־Claude Code משתמשים בשם התוסף כקידומת, למשל /commit-commands:commit, כך שאפשר לראות מיד שהפקודה הגיעה מתוסף.

כששולחים לבוט פקודה ב־Telegram במקום להשתמש במסוף, ל־Claude Code יש גם פקודת התקנה עצמאית בלי החלונית האינטראקטיבית: claude plugin install. בתיעוד מצוין פרט אחד: הפקודה הזאת לא טוענת את התוסף לשיחה שכבר פתוחה. הסוכן יזהה אותו בהפעלה הבאה או אחרי /reload-plugins. במילים אחרות, אחרי ההתקנה צריך להפעיל מחדש את הבוט, אחרת הפקודות החדשות לא יהיו זמינות.

ב־Hermes Agent מפעילים ומשביתים הרחבות באמצעות הפקודה hermes tools, בעוד שלמיומנויות יש תיקייה משלהן. OpenClaw פועל באופן דומה: מחברים חבילה ומפעילים מחדש את הבוט. השמות שונים, אבל סדר הפעולות זהה: מחברים מקור, מתקינים לפי שם ומפעילים מחדש את הסוכן.

מאיפה כדאי לקבל תוספים, ועל אילו מהם אפשר לסמוך?#

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

כדי להתקין מהשוק הקהילתי, השתמשו בפקודה דומה, אבל עם שוק אחר: /plugin install plugin-name@claude-community. התיעוד מציין במפורש שהתוספים האלה עברו בדיקת אבטחה אוטומטית ושכל אחד מהם מוצמד לגרסה מסוימת של הקוד. פירוש הדבר שתקבלו בדיוק את מה שנבדק, בלי שינויים מאוחרים שהמחבר הכניס בלי ידיעתכם.

לפני ההתקנה, Claude Code מציג סעיף “Will install”: רשימה של הפקודות, העוזרים, המיומנויות, הפעולות האוטומטיות והחיבורים שהתוסף יוסיף. קראו אותה. כך תוכלו להבחין, למשל, בהרחבת פתקים שמבקשת מסיבה כלשהי גישה למסוף. התיעוד הרשמי מנסח את הכלל בפשטות:

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

איך בודקים שהתוסף מותקן ופועל ב־Telegram?#

הקדישו דקה לבדיקה: הודעה שהתוסף „הותקן” עדיין לא אומרת שהבוט אכן זיהה אותו. פעלו לפי השלבים הבאים:

1. בדקו את הרשימה. פתחו שוב את החלונית /plugin או בקשו מהסוכן להציג את הפקודות הזמינות לו. הפקודות של התוסף החדש אמורות להופיע ברשימה, עם שם התוסף כקידומת ב־Claude Code.
2. תנו לו משימת בדיקה. בחרו משהו בטוח, לא משימה פעילה. אם התקנתם תוסף ל־GitHub, בקשו ממנו להציג את ה־commits האחרונים. אם התקנתם תוסף לסקירת קוד, תנו לו קובץ קטן. בדקו דבר אחד: האם הבוט מטפל במשימה באמצעות היכולת החדשה?
3. בדקו מאותו צ'אט שבו אתם עובדים. אם אתם שולטים בסוכן דרך Telegram, שלחו את פקודת הבדיקה ב־Telegram. לפעמים התוסף גלוי במסוף, אבל הבוט שבצ'אט עוד לא טען אותו מחדש.

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

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

איך מעדכנים ומסירים תוספים בלי להעמיס על הסוכן?#

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

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

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

אילו תוספים הייתי מתקין קודם?#

לא אציג רשימת 100 המובילים — זה ראוי למדריך נפרד, וכבר יש לי מאמר על עשרת תוספי Claude Code המובילים. הנה שלושה תחומים שאני ממליץ עליהם למתחילים שמנהלים סוכן דרך Telegram.

1. עבודה עם GitHub. תוסף שנותן לסוכן פקודות ליצירת commits, ענפים ו־pull requests. כתבו לבוט בצ'אט „שמור את העבודה ודחוף אותה למאגר”, והוא יעשה זאת. כך מוסר החשש העיקרי של מי שיוצרים קוד בשיטת vibe-coding ללא ניסיון: הפחד לאבד קוד.
2. סקירת קוד. תוסף עם רשימת בדיקה לאיתור שגיאות, פרצות אבטחה ונקודות תורפה. הוא שימושי במיוחד עם Telegram: שלחו קטע קוד בצ'אט וקבלו סקירה בלי לפתוח עורך.
3. יצירת commits בסגנון עקבי. תוסף קטן שגורם לסוכן לעצב commits לפי תבנית אחת. זה אולי נראה שולי, אבל אחרי חודש היסטוריית הפרויקט נראית מסודרת, כמו של צוות, במקום להפוך לבלגן.

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

מה עוד אנשים שואלים על תוספים בסוכן Telegram?#

עברו אל Ailoot.