> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Personal Telegram Assistant

> Chat with Fliiq from your phone via Telegram

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](https://t.me/botfather) on Telegram:

```
/newbot
Name: My Fliiq
Username: my_fliiq_bot
```

BotFather gives you a token like `123456:ABC-DEF...`.

### 2. Configure

```bash .env theme={null}
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
```

### 3. Run Telegram Setup

```bash theme={null}
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

```bash theme={null}
fliiq daemon start
```

The Telegram listener starts automatically. Check with:

```bash theme={null}
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:

```bash .env theme={null}
TELEGRAM_ALLOWED_CHAT_IDS=12345678,87654321
```