סוכני קוד ב-Telegram: מאפס לסוכן שעונה

תפסיקו לקרוא ותתחילו לעשות.

עד סוף המדריך הזה, יהיה לכם נושא (topic) ב-Telegram שבו סוכן קוד עונה להודעות שלכם. הסוכן הזה ינהל tmux pane במכונה שלכם.

זו המטרה המרכזית. אתם עדיין לא זקוקים לזיכרון, למסכים או לשרתי כלים (tool servers). אתם רק צריכים לגרום לסוכן לענות לכם.

⏱️ זמן נדרש: 30–45 דקות.

🛠️ דרישות קדם

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

  • מכונה עם tmux וגישת shell.
  • סוכן קוד פעיל (כמו OpenCode או Claude Code) שכבר רץ בתוך tmux pane.
  • היעד המדויק ב-tmux עבור הסוכן שלכם (לדוגמה: mybox:1.1).
  • הפקודה המדויקת להרצת הסוכן שלכם.
  • סביבת ההרצה (runtime) של OpenClaw מותקנת.
  • חשבון Telegram ואפליקציית Telegram.

📦 גרסאות נדרשות

אל תדלגו על אלה. גרסאות שגויות גורמות לכשלים שקטים.

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: Pin ל-commit ספציפי.

🚀 נתיב הגדרה מהיר

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

  1. הורדת הסקריפטים: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

  2. הרצת ההגדרה עם ה-bot token שלכם: OPENCLAW_BOT_TOKEN="" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. אימות ההגדרה: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 הגדרות Telegram

בצעו את השלבים הבאים באפליקציית Telegram שלכם:

  • צרו בוט דרך @BotFather ושמרו את ה-token.
  • צרו קבוצה חדשה והוסיפו את הבוט שלכם.
  • הפכו את הבוט למנהל (Administrator). זה מאפשר לו לראות את ההודעות שלכם.
  • הפעילו "Topics" בהגדרות הקבוצה.
  • צרו נושא (topic) עבור הפרויקט שלכם.
  • שלחו הודעה אחת בנושא הזה כדי ליצור Topic ID ביומנים (logs) שלכם.

⚙️ חיבור הכל יחד

ה-gateway משתמש בקובץ קונפיגורציה מסוג JSON בכתובת ~/.openclaw/openclaw.json.

השתמשו ב-Phase 1 כדי למצוא את ה-Chat ID וה-Topic ID שלכם על ידי שליחת הודעה ובדיקת ה-gateway logs.

השתמשו ב-Phase 2 כדי להגביל את הקבוצה. שנו את המדיניות (policy) ל-"allowlist" והוסיפו רק את ה-Telegram User ID המספרי שלכם. מיפו את ה-Topic ID שלכם ל-Agent ID הספציפי שלכם.

📝 חוזה הסוכן (The Agent Contract)

צור קובץ AGENTS.md בסביבת העבודה של הסוכן שלך. קובץ זה אומר לסוכן כיצד להתנהג. עליך להגדיר:

  • כיצד לקרוא את הפאנל (tmux capture-pane).
  • כיצד לכתוב לפאנל (tmux send-keys).
  • כיצד לטפל בפקודות ספציפיות כמו "status", "send", או "restart".

✅ בדיקת המוכנות

סיימת רק כאשר אתה עובר את חמש הבדיקות הללו:

  1. הבוט עונה בתוך נושא ה-Telegram שלך.
  2. הפרומפט שלך מגיע לפאנל ה-tmux.
  3. סוכן הקידוד מתחיל לעבוד על הפרומפט.
  4. קובץ לוג מוכיח שהסוכן טיפל בנושא שלך.
  5. הקבוצה נעולה עבור ה-User ID שלך בלבד.

מקור: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

קהילת למידה אופציונלית: https://t.me/GyaanSetuAi