channels-reference.md

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

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

Για κρυπτογραφημένα δωμάτια στο Matrix, συμβουλευτείτε τον:

• Οδηγό Matrix E2EE

---

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

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

[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	Όχι
iMessage	BlueBubbles webhook (/bluebubbles)	Ναι (ο διακομιστής BlueBubbles πρέπει να έχει πρόσβαση)

---

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 με αυξημένο επίπεδο καταγραφής:

RUST_LOG=info zeroclaw daemon

Κοινά σφάλματα:

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