Pocket Agent

Telegram

Chat with your agent from anywhere via Telegram.

Setup

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Follow the prompts to name your bot
  4. Copy the bot token (format: 123456789:ABC-DEF...)
  5. Enable Telegram in Pocket Agent settings
  6. Paste the token and click Test

Settings

Enable TelegramToggle the bot on/off
Bot TokenYour bot token from @BotFather
Allowed UsersComma-separated Telegram user IDs that can use the bot.
Leave empty to allow anyone (not recommended)
Default ChatChat ID for proactive notifications

Get Your User ID

To find your Telegram user ID:

  1. Message @userinfobot
  2. It will reply with your user ID
  3. Add this ID to Allowed Users

Commands

Use these slash commands to control your bot:

/startWelcome message with your user ID and available commands
/helpDetailed help and usage tips
/newFresh start — clears conversation history but keeps your facts and reminders
/modelView available models or switch with /model sonnet
/statusShow agent stats: messages, facts, cron jobs, memory usage
/factsBrowse what the agent remembers about you, or search with /facts query
/mychatidGet your Chat ID and User ID for scheduling notifications
/linkLink a group to a session with /link session-name (groups only)
/unlinkRemove group-to-session linking (groups only)

Group Chats

Create Telegram groups to isolate different conversations. Each group syncs to a matching chat tab in the app.

Create a Linked Group

  1. Create a new Telegram group
  2. Add your bot to the group
  3. Name the group exactly the same as your chat tab in Pocket Agent
  4. Messages in that group will now sync to that specific chat

Example: If your chat tab is named "Work", create a Telegram group called "Work" and add your bot. That group will be linked to that chat session.

Disable Privacy Mode

By default, bots can only see messages that start with / or mention the bot. To let your agent see all messages in a group:

  1. Open @BotFather
  2. Send /mybots
  3. Select your bot
  4. Tap Bot Settings
  5. Tap Group Privacy
  6. Tap Turn off

Note: After disabling privacy mode, remove and re-add the bot to existing groups for the change to take effect.