AgentPlayground
Docs
Telegram

AgentPlayground can run as a Telegram bot — bidirectional DMs with the coordinator, group
notifications for task completions, and quick Brain commands, all from your phone.

What's real and shipped
  • Direct messages to the coordinator — text, voice notes, audio files, photos, and documents. Voice/audio messages are transcribed automatically before being handled.
  • Brain commands — /note <text> saves a note directly to the Brain, /brain <query> semantically searches it, /daily shows today's daily note. Any other plain text you send is also saved to the vault automatically, not just replied to.
  • Owner alerts — when an agent hits a request_human_input checkpoint or needs a decision, it can DM you directly instead of waiting silently in a chat window you're not looking at.
  • Group notifications — task completions and other events can post into a Telegram group, so a small team can watch agent activity together.
Setting it up
  1. Create a bot with @BotFather on Telegram — you'll get a TELEGRAM_BOT_TOKEN.
  2. Generate a webhook secret: openssl rand -hex 20.
  3. Register the webhook: `` curl "https://api.telegram.org/bot<TOKEN>/setWebhook" \ -d "url=https://<your-domain>/api/telegram/webhook?secret_token=<SECRET>" \ -d "allowed_updates=[\"message\"]" ``
  4. Add TELEGRAM_BOT_TOKEN and TELEGRAM_WEBHOOK_SECRET to your .env file (see Environment variables).
  5. For group notifications or owner DMs, also set TELEGRAM_GROUP_CHAT_ID / TELEGRAM_OWNER_CHAT_ID.
  6. Check Settings in the app — it shows whether each of these is actually detected/set, so you can confirm the setup landed correctly without guessing.