# Οδηγός Καναλιών Επικοινωνίας (Channels)

Αυτός ο οδηγός περιγράφει τη διαδικασία διαμόρφωσης των καναλιών επικοινωνίας (Telegram, Discord, κ.λπ.) στο ZeroClaw.

Για κρυπτογραφημένα δωμάτια στο Matrix, συμβουλευτείτε τον:
- [Οδηγό Matrix E2EE](./matrix-e2ee-guide.md)

---

## 1. Διαμόρφωση Καναλιών

Οι ρυθμίσεις αποθηκεύονται στο αρχείο `~/.zeroclaw/config.toml`, στην ενότητα `[channels_config]`.

```toml
[channels_config]
cli = true # Ενεργοποίηση διεπαφής τερματικού (CLI)
```

Για την προσθήκη νέου καναλιού (π.χ. Telegram), δημιουργήστε την αντίστοιχη υποενότητα: `[channels_config.telegram]`.

## 2. Διαχείριση Μοντέλων μέσω Συνομιλίας

Σε πλατφόρμες όπως το Telegram και το Discord, μπορείτε να ελέγχετε το ZeroClaw με εντολές:

- `/models`: Προβολή διαθέσιμων παρόχων και μοντέλων.
- `/models <provider>`: Αλλαγή παρόχου AI (π.χ. `openai`, `anthropic`).
- `/model <name>`: Επιλογή συγκεκριμένου μοντέλου (π.χ. `gpt-4`).

## 3. Αποστολή και Ανάλυση Εικόνων

Το ZeroClaw υποστηρίζει την ανάγνωση εικόνων μέσω της σύνταξης:
`[IMAGE:<source>]`
Η πηγή μπορεί να είναι τοπική διαδρομή αρχείου ή URL.

---

## 4. Μέθοδοι Λήψης Δεδομένων ανά Κανάλι

| Κανάλι | Μηχανισμός | Απαιτεί Ανοιχτές Θύρες (Port Forwarding); |
|:---|:---|:---:|
| CLI | Direct Output | Όχι |
| Telegram | Polling | Όχι |
| Discord | Websocket | Όχι |
| Slack | Events API | Όχι |
| Matrix | Sync API | Όχι |
| Nextcloud Talk | Webhook | **Ναι** |
| Email | IMAP | Όχι |

---

## 5. Πολιτική Ασφαλείας (Allowlist)

Η πρόσβαση στο bot ελέγχεται μέσω της ρύθμισης `allowed_users`:
- **Κενή λίστα**: Αποκλεισμός όλων των χρηστών.
- **`["*"]`**: Ελεύθερη πρόσβαση (χρήση αποκλειστικά για δοκιμές).
- **Συγκεκριμένη λίστα**: Πρόσβαση μόνο στους εξουσιοδοτημένους λογαριασμούς.

---

## 6. Αντιμετώπιση Προβλημάτων

Εάν το bot δεν ανταποκρίνεται:
1. **Εξουσιοδότηση**: Επαληθεύστε ότι το ID σας συμπεριλαμβάνεται στο `allowed_users`.
2. **Σύνδεση**: Βεβαιωθείτε ότι το bot έχει προστεθεί στο σωστό δωμάτιο/κανάλι.
3. **Credentials**: Ελέγξτε την εγκυρότητα των Tokens και API Secrets.
4. **Δίκτυο**:
    - Τα κανάλια **Webhook** απαιτούν προσβάσιμη HTTPS διεύθυνση από το διαδίκτυο.
    - Τα κανάλια **Polling/Websocket** λειτουργούν πίσω από NAT χωρίς ρυθμίσεις router.
5. **Επανεκκίνηση**: Κάθε αλλαγή στο `config.toml` απαιτεί επανεκκίνηση του `zeroclaw daemon`.

### Διαγνωστικά Μηνύματα (Logs)

Εκτελέστε το ZeroClaw με αυξημένο επίπεδο καταγραφής:
```bash
RUST_LOG=info zeroclaw daemon
```

**Κοινά σφάλματα**:
- `ignoring message from unauthorized user`: Ο χρήστης δεν ανήκει στο allowlist.
- `401 / token mismatch`: Λανθασμένο διακριτικό πρόσβασης.
- `sync error`: Αδυναμία σύνδεσης με τον homeserver (σύνηθες στο Matrix).