Skip to content

channels-reference.md

Latest commit

 

History

History
120 lines (83 loc) · 6.62 KB

channels-reference.md

File metadata and controls

120 lines (83 loc) · 6.62 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 πρέπει να έχει πρόσβαση)

4.1 Ρύθμιση BlueBubbles (iMessage)

Το BlueBubbles είναι αυτο-φιλοξενούμενος διακομιστής macOS που παρέχει iMessage μέσω REST API και webhook.

[channels_config.bluebubbles]
server_url = "http://192.168.1.100:1234"
password   = "κωδικός-bluebubbles"

allowed_senders = ["+15551234567", "user@example.com"]
ignore_senders  = []
webhook_secret  = "προαιρετικό-secret"

# Πολιτική DM: "open" | "allowlist" | "disabled". Προεπιλογή: "open".
dm_policy = "open"
# Πολιτική ομάδας: "open" | "allowlist" | "disabled". Προεπιλογή: "open".
group_policy = "open"
# Επιτρεπόμενα chat GUIDs ομάδας όταν group_policy = "allowlist".
group_allow_from = ["iMessage;+;chat-abc123"]
# Αποστολή read receipt μετά από κάθε επεξεργασμένο μήνυμα. Προεπιλογή: true.
send_read_receipts = true

# Απαιτείται αναφορά σε ομάδες (προαιρετικό). Τα DM δεν επηρεάζονται.
# require_mention_in_groups = false
# mention_keyword = "Hey Bot"

Η πολιτική ομάδας λειτουργεί με τον ίδιο τρόπο χρησιμοποιώντας group_allow_from αντί για allowed_senders. Όταν η επαλήθευση αναφοράς είναι ενεργή, το κείμενο του μηνύματος πρέπει να περιέχει mention_keyword (αντιστοίχιση χωρίς διάκριση πεζών-κεφαλαίων). Εάν δεν βρεθεί η λέξη-κλειδί, το μήνυμα αποσύρεται αθόρυβα — χωρίς απόκριση, χωρίς σφάλμα.

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