Chummy
82 lines
3.9 KiB
Markdown
82 lines
3.9 KiB
Markdown
# Οδηγός Καναλιών Επικοινωνίας (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).
|