டெலிகிராம் மூலம் கோடிங் ஏஜென்ட்கள்: பூஜ்ஜியத்திலிருந்து பதிலளிக்கும் ஏஜென்ட் வரை
வாசிப்பதை நிறுத்திவிட்டுச் செய்யத் தொடங்குங்கள்.
இந்த வழிகாட்டியின் முடிவில், ஒரு கோடிங் ஏஜென்ட் உங்கள் செய்திகளுக்குப் பதிலளிக்கும் ஒரு டெலிகிராம் டாபிக்கை (Telegram topic) நீங்கள் வைத்திருப்பீர்கள். இந்த ஏஜென்ட் உங்கள் சொந்த இயந்திரத்தில் உள்ள ஒரு tmux பேனை (pane) இயக்கும்.
இதுதான் முக்கிய இலக்கு. உங்களுக்கு இன்னும் மெமரி (memory), மானிட்டர்கள் அல்லது டூல் சர்வர்கள் (tool servers) தேவையில்லை. ஏஜென்ட் உங்களுக்குப் பதிலளிக்க வைப்பதே உங்கள் ஒரே தேவை.
⏱️ தேவைப்படும் நேரம்: 30–45 நிமிடங்கள்.
🛠️ முன்நிபந்தனைகள் (Prerequisites)
தொடங்குவதற்கு முன், உங்களிடம் இவை இருப்பதை உறுதி செய்து கொள்ளுங்கள்:
- tmux மற்றும் shell அணுகல் கொண்ட ஒரு இயந்திரம்.
- ஏற்கனவே ஒரு tmux பேனில் இயங்கிக் கொண்டிருக்கும் ஒரு வேலை செய்யும் கோடிங் ஏஜென்ட் (OpenCode அல்லது Claude Code போன்றது).
- உங்கள் ஏஜென்ட்டிற்கான சரியான tmux இலக்கு (உதாரணம்: mybox:1.1).
- உங்கள் ஏஜென்ட்டைத் தொடங்குவதற்கான சரியான கட்டளை (command).
- OpenClaw runtime நிறுவப்பட்டிருக்க வேண்டும்.
- ஒரு டெலிகிராம் கணக்கு மற்றும் டெலிகிராம் செயலி.
📦 தேவையான பதிப்புகள் (Required Versions)
இவற்றைத் தவிர்க்க வேண்டாம். தவறான பதிப்புகள் அமைதியான தோல்விகளுக்கு (silent failures) வழிவகுக்கும்.
• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: ஒரு குறிப்பிட்ட commit-க்கு முடக்குங்கள் (Pin).
🚀 விரைவான அமைப்பிற்கான வழி (Quick Setup Path)
உள்ளூர் அமைப்பைக் கையாள இந்த ஸ்கிரிப்ட்களைப் பயன்படுத்தலாம்:
- ஸ்கிரிப்ட்களைப் பதிவிறக்கவும்:
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
- உங்கள் பாட் டோக்கனுடன் (bot token) அமைப்பை இயக்கவும்:
OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh
- அமைப்பைச் சரிபார்க்கவும்:
AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh
📱 டெலிகிராம் கட்டமைப்பு (Telegram Configuration)
உங்கள் டெலிகிராம் செயலியில் இந்த வழிமுறைகளைப் பின்பற்றவும்:
- @BotFather மூலம் ஒரு பாட்டை (bot) உருவாக்கி, அதன் டோக்கனைச் சேமிக்கவும்.
- ஒரு புதிய குழுவை உருவாக்கி, அதில் உங்கள் பாட்டைச் சேர்க்கவும்.
- பாட்டை ஒரு நிர்வாகியாக (Administrator) மாற்றவும். இது உங்கள் செய்தைகளைப் பார்க்க அனுமதிக்கும்.
- குழு அமைப்புகளில் "Topics"-ஐ இயக்கவும்.
- உங்கள் திட்டத்திற்காக ஒரு டாபிக்கை உருவாக்கவும்.
- உங்கள் லாகுகளில் (logs) ஒரு Topic ID உருவாக அந்த டாபிக்கில் ஒரு செய்தியை அனுப்பவும்.
⚙️ அனைத்தையும் இணைத்தல் (Wiring it Together)
கேட்வே (gateway) ~/.openclaw/openclaw.json என்ற இடத்தில் ஒரு JSON கட்டமைப்பைப் பயன்படுத்துகிறது.
ஒரு செய்தியை அனுப்பி, கேட்வே லாகுகளைச் சரிபார்ப்பதன் மூலம் உங்கள் Chat ID மற்றும் Topic ID-ஐக் கண்டறிய Phase 1-ஐப் பயன்படுத்தவும்.
குழுவைப் பாதுகாப்பாக மாற்ற Phase 2-ஐப் பயன்படுத்தவும். கொள்கையை (policy) "allowlist" என மாற்றி, உங்கள் எண் சார்ந்த டெலிகிராம் பயனர் ஐடியை (numeric Telegram User ID) மட்டும் சேர்க்கவும். உங்கள் Topic ID-ஐ உங்கள் குறிப்பிட்ட Agent ID-உடன் இணைக்கவும்.
📝 ஏஜென்ட் ஒப்பந்தம் (The Agent Contract)
Create an AGENTS.md file in your agent workspace. This file tells the agent how to behave. You must define:
- How to read the pane (tmux capture-pane).
- How to write to the pane (tmux send-keys).
- How to handle specific commands like "status", "send", or "restart".
✅ The Readiness Test
You are finished only when you pass these five checks:
- The bot replies in your Telegram topic.
- Your prompt reaches the tmux pane.
- The coding agent starts working on the prompt.
- A log file proves the agent handled your topic.
- The group is locked to your User ID only.
Source: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777
Optional learning community: https://t.me/GyaanSetuAi