Personal Telegram Assistant

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

​Setup

​1. Create a Bot

​2. Configure

​3. Run Telegram Setup

​4. Start the Daemon

​Using It

​Per-Chat Sessions

​Security