ٹیلی گرام پر کوڈنگ ایجنٹس: صفر سے ایک جواب دینے والے ایجنٹ تک

پڑھنا بند کریں اور کام شروع کریں۔

اس گائیڈ کے اختتام تک، آپ کے پاس ٹیلی گرام کا ایک ایسا ٹاپک (topic) ہوگا جہاں ایک کوڈنگ ایجنٹ آپ کے پیغامات کا جواب دے گا۔ یہ ایجنٹ آپ کی اپنی مشین پر ایک tmux pane کو کنٹرول کرے گا۔

یہ بنیادی مقصد ہے۔ آپ کو ابھی میموری، مانیٹرز، یا ٹول سرورز کی ضرورت نہیں ہے۔ آپ کو صرف ایجنٹ سے جواب دلوانا ہے۔

⏱️ درکار وقت: 30–45 منٹ۔

🛠️ ضروری شرائط (Prerequisites)

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس درج ذیل چیزیں تیار ہیں:

  • ایک مشین جس میں tmux اور shell تک رسائی ہو۔
  • ایک کام کرنے والا کوڈنگ ایجنٹ (جیسے OpenCode یا Claude Code) جو پہلے سے ہی ایک tmux pane میں چل رہا ہو۔
  • آپ کے ایجنٹ کے لیے درست tmux target (مثال کے طور پر: mybox:1.1)۔
  • آپ کے ایجنٹ کو شروع کرنے کے لیے درست کمانڈ۔
  • OpenClaw runtime انسٹال شدہ ہو۔
  • ایک ٹیلی گرام اکاؤنٹ اور ٹیلی گرام ایپ۔

📦 مطلوبہ ورژنز (Required Versions)

انہیں نظر انداز نہ کریں۔ غلط ورژنز کی وجہ سے خاموش ناکامی (silent failures) ہو سکتی ہے۔

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: کسی مخصوص commit پر پن (pin) کریں۔

🚀 فوری سیٹ اپ کا راستہ (Quick Setup Path)

آپ لوکل سیٹ اپ کے لیے ان اسکرپٹس کا استعمال کر سکتے ہیں:

  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. اپنے بوٹ ٹوکن کے ساتھ سیٹ اپ چلائیں: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. سیٹ اپ کی تصدیق کریں: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 ٹیلی گرام کنفیگریشن (Telegram Configuration)

اپنی ٹیلی گرام ایپ میں ان مراحل پر عمل کریں:

  • @BotFather کے ذریعے ایک بوٹ بنائیں اور ٹوکن محفوظ کریں۔
  • ایک نیا گروپ بنائیں اور اپنا بوٹ شامل کریں۔
  • بوٹ کو ایڈمنسٹریٹر (Administrator) بنائیں۔ اس سے اسے آپ کے پیغامات دیکھنے کی اجازت مل جائے گی۔
  • گروپ سیٹنگز میں "Topics" کو فعال کریں۔
  • اپنے پروجیکٹ کے لیے ایک ٹاپک بنائیں۔
  • اپنے لاگز (logs) میں Topic ID تیار کرنے کے لیے اس ٹاپک میں ایک پیغام بھیجیں۔

⚙️ سب کو آپس میں جوڑنا (Wiring it Together)

گیٹ وے ~/.openclaw/openclaw.json پر ایک JSON کنفیگریشن استعمال کرتا ہے۔

ایک پیغام بھیج کر اور گیٹ وے لاگز چیک کر کے اپنی Chat ID اور Topic ID تلاش کرنے کے لیے Phase 1 کا استعمال کریں۔

گروپ کو محدود (lock down) کرنے کے لیے Phase 2 کا استعمال کریں۔ پالیسی کو "allowlist" میں تبدیل کریں اور صرف اپنی نمبرک ٹیلی گرام یوزر آئی ڈی شامل کریں۔ اپنی Topic ID کو اپنے مخصوص Agent ID کے ساتھ میپ (map) کریں۔

📝 ایجنٹ کنٹریکٹ (The Agent Contract)

اپنے ایجنٹ ورک اسپیس میں ایک AGENTS.md فائل بنائیں۔ یہ فائل ایجنٹ کو بتاتی ہے کہ اسے کیسے برتاؤ کرنا ہے۔ آپ کو درج ذیل چیزیں متعین کرنی ہوں گی:

  • پین (pane) کو کیسے پڑھنا ہے (tmux capture-pane)۔
  • پین (pane) میں کیسے لکھنا ہے (tmux send-keys)۔
  • مخصوص کمانڈز جیسے کہ "status"، "send"، یا "restart" کو کیسے ہینڈل کرنا ہے۔

✅ تیاری کا ٹیسٹ

آپ کا کام تب ہی مکمل تصور ہوگا جب آپ ان پانچ چیک پاس کر لیں گے:

  1. بوٹ آپ کے ٹیلی گرام ٹاپک میں جواب دیتا ہے۔
  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