Skip to main content
Telegram is the fastest way to reach GAIA. There’s no server to join and no permissions to configure. Open a chat, send /start, and you’re talking to your assistant.

​
Getting started

1

Open a chat with GAIA

Search for @heygaia_bot and open a private chat. Send /start to begin.
2

Link your GAIA account

Run /auth. You’ll get a link, click it, sign in, and your account is connected.
Once linked, GAIA carries over your preferences, integrations, and conversation history everywhere.
3

Just type

In a private Telegram chat, every message you send goes straight to GAIA. No command prefix needed.
Telegram DMs are fully private, only you and GAIA see the conversation.

​
What you can do

Ask GAIA anything, in plain language: Or use commands for quick actions, the bot registers its full command list with Telegram, so you get native autocomplete when you type /: For the complete reference including subcommand options, see the Bot Commands Reference.

​
Good to know

  • Responses use plain text and Markdown, rich embeds are limited compared to Discord and Slack, so GAIA falls back to simpler formatting when needed.
  • Start fresh when switching topics. Run /new to clear conversation context before asking about something unrelated.
  • Connect your integrations first. Link Gmail, Google Calendar, GitHub, and other tools from the GAIA web app so GAIA can act on your behalf.

​
Troubleshooting

Want to run your own instance of the Telegram bot? See Telegram Bot Development.