Telegram Bot

The Telegram Bot provides mobile access to all Agents Machine features — chat with your AI, manage memories, invoke skills, and check task status from anywhere.

Setup

Create a Bot

Open Telegram, search for @BotFather, send /newbot, and follow the prompts. Copy the bot token.

Store the Token

Store secret TELEGRAM_BOT_TOKEN with value 123456:ABC-DEF...
Category: token
Description: Telegram bot token for mobile access

Get Your Chat ID

Send any message to your bot, then find your chat ID via the Telegram API. Store it:

Store secret TELEGRAM_CHAT_ID with value 12345678
Category: env_var
Description: Your Telegram chat ID

Done

The bot starts automatically when the MCP server runs with both secrets configured.

Features

Send messages directly to the bot:

You: What do we know about the authentication system?
Bot: Based on stored memories, your auth system uses JWT with...

You: /memory store Our deployment uses Docker Compose on a VPS
Bot: ✅ Memory stored with tags: deployment, docker

You: /memory search authentication
Bot: Found 3 memories related to authentication...

You: /skill code-reviewer Review the auth middleware
Bot: Running code-reviewer skill...
[Formatted review output]

You: /tasks list pending
Bot: 📋 Pending tasks:
  - auth-01: Design JWT flow (P1)
  - auth-02: Implement token refresh (P2)

You: /tasks update auth-01 status in_progress
Bot: ✅ Task auth-01 moved to in_progress

You: /standup
Bot: 📊 Daily Standup:
  Completed: 2 tasks
  In Progress: 1 task
  Blocked: 0 tasks

Security

🔒 Chat ID Restriction

The bot only responds to your configured chat ID.

🚫 No Secret Exposure

Secrets are never displayed in Telegram messages.

📝 Audit Trail

All operations use the same vault and audit trail as the desktop app.