𝗖𝗼𝗱𝗶𝗻𝗴 𝗔𝗴𝗲𝗻𝘁𝘀 𝗼𝘃𝗲𝗿 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: 𝗩𝗮𝗻 𝗭𝗲𝗿𝗼 𝘁𝗼𝗲 𝗲𝗲𝗻 𝗔𝗴𝗲𝗻𝘁 𝗱𝗶𝗲 𝗔𝗻𝘁𝘄𝗼𝗼𝗿𝗱𝘁

Stop met lezen en begin met doen.

Aan het einde van deze gids heb je een Telegram-topic waarin een coding agent je berichten beantwoordt. Deze agent bestuurt een tmux-pane op je eigen machine.

Dit is het hoofddoel. Je hebt nog geen geheugen, monitors of tool-servers nodig. Je hoeft alleen de agent zover te krijgen dat hij je beantwoordt.

⏱️ Benodigde tijd: 30–45 minuten.

🛠️ Vereisten

Voordat je begint, zorg ervoor dat je de volgende zaken klaar hebt staan:

  • Een machine met tmux en shell-toegang.
  • Een werkende coding agent (zoals OpenCode of Claude Code) die al draait in een tmux-pane.
  • Het exacte tmux-doel voor je agent (voorbeeld: mybox:1.1).
  • Het exacte commando om je agent te starten.
  • De OpenClaw runtime geïnstalleerd.
  • Een Telegram-account en de Telegram-app.

📦 Vereiste versies

Sla deze niet over. Verkeerde versies veroorzaken stille fouten.

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: Pin naar een specifieke commit.

🚀 Snelle installatieroute

Je kunt deze scripts gebruiken voor de lokale installatie:

  1. Download de scripts: 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. Voer de installatie uit met je bot-token: OPENCLAW_BOT_TOKEN="" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Controleer de installatie: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Telegram-configuratie

Volg deze stappen in je Telegram-app:

  • Maak een bot aan via @BotFather en sla het token op.
  • Maak een nieuwe groep aan en voeg je bot toe.
  • Maak de bot een Administrator. Hierdoor kan hij je berichten zien.
  • Schakel "Topics" in de groepinstellingen in.
  • Maak een topic aan voor je project.
  • Stuur één bericht in dat topic om een Topic ID in je logs te genereren.

⚙️ Alles aan elkaar koppelen

De gateway gebruikt een JSON-configuratie op ~/.openclaw/openclaw.json.

Gebruik Fase 1 om je Chat ID en Topic ID te vinden door een bericht te sturen en de gateway-logs te controleren.

Gebruik Fase 2 om de groep af te schermen. Wijzig het beleid naar "allowlist" en voeg alleen je numerieke Telegram User ID toe. Koppel je Topic ID aan je specifieke Agent ID.

📝 Het Agent-contract

Maak een AGENTS.md-bestand aan in je agent-workspace. Dit bestand vertelt de agent hoe hij zich moet gedragen. Je moet het volgende definiëren:

  • Hoe het paneel gelezen moet worden (tmux capture-pane).
  • Hoe er naar het paneel geschreven moet worden (tmux send-keys).
  • Hoe specifieke commando's zoals "status", "send" of "restart" afgehandeld moeten worden.

✅ De Readiness Test

Je bent pas klaar als je deze vijf controles hebt doorstaan:

  1. De bot reageert in je Telegram-topic.
  2. Je prompt bereikt het tmux-paneel.
  3. De coding agent begint met werken aan de prompt.
  4. Een logbestand bewijst dat de agent je topic heeft afgehandeld.
  5. De groep is vergrendeld voor alleen jouw User ID.

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

Optionele leercommunity: https://t.me/GyaanSetuAi