/start, and you’re talking to your assistant.
Getting started
Open a chat with GAIA
Search for @heygaia_bot and open a private chat. Send
/start to begin.Link your GAIA account
Run Once linked, GAIA carries over your preferences, integrations, and conversation history everywhere.
/auth. You’ll get a link, click it, sign in, and your account is connected.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/:
| Command | What it does |
|---|---|
/todo list | Show all active todos |
/todo add <title> | Create a new todo |
/workflow list | List all your workflows |
/workflow execute <id> | Run a workflow manually |
/new | Start a fresh conversation |
/help | Show all available commands |
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
/newto 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
| Problem | Solution |
|---|---|
| Bot does not respond | Check that the bot is online with /status. |
| Authentication link expired | Run /auth again to get a fresh link. |
| Commands missing from autocomplete | Send /start to refresh. |
| Markdown looks broken | Some advanced formatting isn’t supported, GAIA falls back to plain text. |
Want to run your own instance of the Telegram bot? See Telegram Bot Development.