Skip to content

channels-reference.md

Latest commit

 

History

History
93 lines (63 loc) · 5.57 KB

channels-reference.md

File metadata and controls

93 lines (63 loc) · 5.57 KB

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

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

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

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 ελέγχεται μέσω των ρυθμίσεων allowlist. Το όνομα πεδίου διαφέρει ανά κανάλι (allowed_users, allowed_senders, κ.λπ.) — δείτε το αγγλικό έγγραφο για πλήρη λίστα.

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

Εξαίρεση BlueBubbles: όταν το dm_policy = "open" (προεπιλογή), η κενή allowed_senders επιτρέπει όλους τους αποστολείς για συμβατότητα με παλιότερες εκδόσεις. Ορίστε dm_policy = "allowlist" για να απαγορεύσετε όλα όταν η λίστα είναι κενή. Η πρόσβαση σε ομαδικές συνομιλίες ελέγχεται ξεχωριστά μέσω group_policy και group_allow_from.

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).