Telegram Üzerinden Kodlama Ajanları: Sıfırdan Cevap Veren Bir Ajan Yapmaya

Okumayı bırakın ve yapmaya başlayın.

Bu kılavuzun sonunda, bir kodlama ajanının mesajlarınıza yanıt verdiği bir Telegram konusu (topic) sahibi olacaksınız. Bu ajan, kendi makinenizdeki bir tmux panelini yönetecek.

Temel hedef budur. Henüz belleğe, monitörlere veya araç sunucularına (tool servers) ihtiyacınız yok. Sadece ajanın size cevap vermesini sağlamanız yeterli.

⏱️ Gereken Süre: 30–45 dakika.

🛠️ Ön Koşullar

Başlamadan önce, şu öğelerin hazır olduğundan emin olun:

  • tmux ve kabuk (shell) erişimi olan bir makine.
  • Bir tmux panelinde halihazırda çalışan, işlevsel bir kodlama ajanı (OpenCode veya Claude Code gibi).
  • Ajanınız için tam tmux hedefi (örnek: mybox:1.1).
  • Ajanınızı başlatmak için gereken tam komut.
  • Yüklü bir OpenClaw çalışma zamanı (runtime).
  • Bir Telegram hesabı ve Telegram uygulaması.

📦 Gerekli Versiyonlar

Bunları atlamayın. Yanlış versiyonlar sessiz hatalara (silent failures) neden olur.

• Node.js: 24.11.1 • Paket Yöneticisi: pnpm 11.2.2 • OpenClaw: Belirli bir commit'e sabitleyin.

🚀 Hızlı Kurulum Yolu

Yerel kurulumu gerçekleştirmek için bu betikleri (scripts) kullanabilirsiniz:

  1. Betikleri indirin: 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. Kurulumu bot token'ınız ile çalıştırın: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Kurulumu doğrulayın: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Telegram Yapılandırması

Telegram uygulamanızda şu adımları izleyin:

  • @BotFather aracılığıyla bir bot oluşturun ve token'ı kaydedin.
  • Yeni bir grup oluşturun ve botunuzu ekleyin.
  • Botu Yönetici (Administrator) yapın. Bu, mesajlarınızı görmesini sağlar.
  • Grup ayarlarından "Konular"ı (Topics) etkinleştirin.
  • Projeniz için bir konu oluşturun.
  • Günlüklerinizde (logs) bir Topic ID oluşturmak için o konuya bir mesaj gönderin.

⚙️ Her Şeyi Birbirine Bağlama

Gateway, ~/.openclaw/openclaw.json konumundaki bir JSON yapılandırmasını kullanır.

Bir mesaj gönderip gateway günlüklerini kontrol ederek Chat ID ve Topic ID'nizi bulmak için Aşama 1'i (Phase 1) kullanın.

Grubu kısıtlamak için Aşama 2'yi (Phase 2) kullanın. Politikayı "allowlist" olarak değiştirin ve yalnızca kendi sayısal Telegram Kullanıcı Kimliğinizi (User ID) ekleyin. Topic ID'nizi belirli Ajan Kimliğinizle (Agent ID) eşleştirin.

📝 Ajan Sözleşmesi

Agent çalışma alanınızda bir AGENTS.md dosyası oluşturun. Bu dosya, ajana nasıl davranacağını söyler. Şunları tanımlamanız gerekir:

  • Paneli nasıl okuyacağı (tmux capture-pane).
  • Panele nasıl yazacağı (tmux send-keys).
  • "status", "send" veya "restart" gibi belirli komutları nasıl işleyeceği.

✅ Hazırlık Testi

Ancak şu beş kontrolü geçtiğinizde işlemi tamamlamış sayılırsınız:

  1. Bot, Telegram konunuzda yanıt verir.
  2. Komutunuz (prompt) tmux paneline ulaşır.
  3. Kodlama ajanı komut üzerinde çalışmaya başlar.
  4. Bir günlük (log) dosyası, ajanın konunuzu işlediğini kanıtlar.
  5. Grup yalnızca sizin Kullanıcı Kimliğinize (User ID) kilitlenmiştir.

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

İsteğe bağlı öğrenme topluluğu: https://t.me/GyaanSetuAi