Skip to main content
Run Fliiq as a Telegram bot you can message from anywhere — your phone, tablet, or desktop. Full agent capabilities, always available.

​
Setup

​
1. Create a Bot

Message @BotFather on Telegram: 
/newbot
Name: My Fliiq
Username: my_fliiq_bot
BotFather gives you a token like 123456:ABC-DEF....

​
2. Configure

.env
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...

​
3. Run Telegram Setup

fliiq telegram setup
This will prompt you to send a message to your bot, then auto-detect and save your chat ID. You can also set TELEGRAM_ALLOWED_CHAT_IDS manually in .env.

​
4. Start the Daemon

fliiq daemon start
The Telegram listener starts automatically. Check with: 
fliiq daemon status
# Shows: Telegram: active

​
Using It

Message your bot from Telegram. It responds with the full Fliiq agent — same skills, same memory, same capabilities as the CLI. Examples: 
You: What's the weather in Tokyo?
Bot: Currently 12C, partly cloudy, humidity 65%...

You: Check my email for anything from Alice
Bot: Found 2 emails from Alice Chen:
     1. "Q1 Planning" — asking about Thursday's meeting
     2. "Budget Review" — attached updated spreadsheet

You: Create a chill playlist on Spotify
Bot: Created "Chill Vibes" with 15 tracks. Link: https://open.spotify.com/...

​
Per-Chat Sessions

Each Telegram chat maintains its own conversation history. The bot remembers context within a chat — you can have multi-turn conversations just like the interactive REPL.

​
Security

TELEGRAM_ALLOWED_CHAT_IDS ensures only authorized users can interact with the bot. Messages from other chat IDs are silently ignored. Add multiple IDs separated by commas:
.env
TELEGRAM_ALLOWED_CHAT_IDS=12345678,87654321