టెలిగ్రామ్ ద్వారా కోడింగ్ ఏజెంట్లు: సున్నా నుండి సమాధానాలు ఇచ్చే ఏజెంట్ వరకు

చదవడం ఆపి, చేయడం ప్రారంభించండి.

ఈ గైడ్ ముగిసే సమయానికి, ఒక కోడింగ్ ఏజెంట్ మీ సందేశాలకు సమాధానం ఇచ్చే టెలిగ్రామ్ టాపిక్ (topic) మీకు సిద్ధంగా ఉంటుంది. ఈ ఏజెంట్ మీ స్వంత మెషీన్‌లోని tmux పేన్‌ను (pane) నడుపుతుంది.

ఇదే ప్రధాన లక్ష్యం. మీకు ఇంకా మెమరీ, మానిటర్లు లేదా టూల్ సర్వర్లు అవసరం లేదు. ఏజెంట్ మీకు సమాధానం ఇచ్చేలా చేయడం మాత్రమే మీ ప్రస్తుత అవసరం.

⏱️ అవసరమైన సమయం: 30–45 నిమిషాలు.

🛠️ ముందస్తు అవసరాలు (Prerequisites)

మీరు ప్రారంభించే ముందు, ఈ క్రింది అంశాలు సిద్ధంగా ఉన్నాయని నిర్ధారించుకోండి:

  • tmux మరియు shell యాక్సెస్ ఉన్న ఒక మెషీన్.
  • ఇప్పటికే ఒక tmux పేన్‌లో నడుస్తున్న వర్కింగ్ కోడింగ్ ఏజెంట్ (OpenCode లేదా Claude Code వంటివి).
  • మీ ఏజెంట్ కోసం ఖచ్చితమైన tmux టార్గెట్ (ఉదాహరణకు: mybox:1.1).
  • మీ ఏజెంట్‌ను ప్రారంభించడానికి అవసరమైన ఖచ్చితమైన కమాండ్.
  • OpenClaw runtime ఇన్‌స్టాల్ అయి ఉండాలి.
  • ఒక టెలిగ్రామ్ ఖాతా మరియు టెలిగ్రామ్ యాప్.

📦 అవసరమైన వెర్షన్లు (Required Versions)

వీటిని వదిలివేయకండి. తప్పు వెర్షన్ల వల్ల సమస్యలు రావచ్చు.

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: ఒక నిర్దిష్ట కమిట్‌కు (commit) పిన్ చేయండి.

🚀 క్విక్ సెటప్ మార్గం (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 ద్వారా ఒక బాట్‌ను సృష్టించి, టోకెన్‌ను సేవ్ చేయండి.
  • కొత్త గ్రూప్‌ను సృష్టించి, మీ బాట్‌ను జోడించండి.
  • బాట్‌ను అడ్మినిస్ట్రేటర్‌గా చేయండి. దీనివల్ల అది మీ సందేశాలను చూడగలుగుతుంది.
  • గ్రూప్ సెట్టింగ్స్‌లో "Topics"ను ఎనేబుల్ చేయండి.
  • మీ ప్రాజెక్ట్ కోసం ఒక టాపిక్‌ను సృష్టించండి.
  • మీ లాగ్స్‌లో Topic ID జనరేట్ కావడానికి ఆ టాపిక్‌లో ఒక సందేశాన్ని పంపండి.

⚙️ వైరింగ్ ఇట్ టుగెదర్ (Wiring it Together)

గేట్‌వే ~/.openclaw/openclaw.json లోని JSON కాన్ఫిగరేషన్‌ను ఉపయోగిస్తుంది.

ఒక సందేశాన్ని పంపి మరియు గేట్‌వే లాగ్స్‌ను తనిఖీ చేయడం ద్వారా మీ Chat ID మరియు Topic IDని కనుగొనడానికి Phase 1ని ఉపయోగించండి.

గ్రూప్‌ను సురక్షితంగా ఉంచడానికి (lock down) Phase 2ని ఉపయోగించండి. పాలసీని "allowlist"గా మార్చి, మీ నంబరిక్ టెలిగ్రామ్ యూజర్ IDని మాత్రమే జోడించండి. మీ Topic IDని మీ నిర్దిష్ట Agent IDకి మ్యాప్ చేయండి.

📝 ఏజెంట్ కాంట్రాక్ట్ (The Agent Contract)

మీ ఏజెంట్ వర్క్‌స్పేస్‌లో ఒక AGENTS.md ఫైల్‌ను సృష్టించండి. ఈ ఫైల్ ఏజెంట్ ఎలా ప్రవర్తించాలో తెలియజేస్తుంది. మీరు వీటిని నిర్వచించాలి:

  • ప్లేన్‌ను ఎలా చదవాలి (tmux capture-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