Skip to content

config-reference.md

Latest commit

 

History

History
80 lines (55 loc) · 5.03 KB

config-reference.md

File metadata and controls

80 lines (55 loc) · 5.03 KB

Οδηγός Ρυθμίσεων ZeroClaw (config.toml)

Αυτός ο οδηγός εξηγεί τις πιο σημαντικές ρυθμίσεις που μπορείτε να κάνετε στο αρχείο config.toml.

Τελευταίος έλεγχος: 19 Φεβρουαρίου 2026.

Πού βρίσκεται το αρχείο ρυθμίσεων;

Το ZeroClaw ψάχνει για τις ρυθμίσεις με την εξής σειρά:

  1. Στη διαδρομή που ορίζει η μεταβλητή ZEROCLAW_WORKSPACE.
  2. Στο αρχείο ~/.zeroclaw/config.toml (αυτή είναι η συνηθισμένη θέση).

Βασικές Ρυθμίσεις (Core)

Ρύθμιση Τι ορίζει
default_provider Ποιον πάροχο AI χρησιμοποιείτε (π.χ. openai, ollama).
default_model Ποιο συγκεκριμένο μοντέλο AI χρησιμοποιείτε (π.χ. gpt-4o).
default_temperature Πόσο "δημιουργική" θα είναι η AI (τιμή από 0 έως 2).

1. Συμπεριφορά της AI (Agent)

  • max_tool_iterations: Πόσες φορές μπορεί η AI να χρησιμοποιήσει εργαλεία για να απαντήσει σε 1 μήνυμα (προεπιλογή: 10).
  • max_history_messages: Πόσα προηγούμενα μηνύματα θυμάται η AI στη συνομιλία (προεπιλογή: 50).

2. Αυτονομία και Ασφάλεια (Autonomy)

Εδώ ρυθμίζετε πόση ελευθερία έχει η AI να κάνει αλλαγές στον υπολογιστή σας.

  • level:
    • read_only: Μπορεί μόνο να διαβάζει αρχεία.
    • supervised: Χρειάζεται την έγκρισή σας για σημαντικές ενέργειες (προεπιλογή).
    • full: Μπορεί να τρέχει εντολές ελεύθερα (προσοχή!).
  • allowed_commands: Λίστα με τις εντολές που επιτρέπεται να τρέχει η AI.
  • forbidden_paths: Φάκελοι που η AI δεν επιτρέπεται να αγγίξει (π.χ. /etc).

3. Μνήμη (Memory)

Πώς αποθηκεύει η AI τις πληροφορίες που της δίνετε.

  • backend: Μπορεί να είναι sqlite (βάση δεδομένων), markdown (απλά αρχεία κειμένου) ή none (καμία μνήμη).

4. Κανάλια Επικοινωνίας (Channels)

Κάθε κανάλι (Telegram, Discord κ.λπ.) έχει τη δική του ενότητα στο αρχείο.

Παράδειγμα για το Telegram:

[channels_config.telegram]
bot_token = "το-κλειδί-σας"
allowed_users = ["το-όνομά-σας"] # Ποιοι επιτρέπεται να μιλάνε στο bot

5. Έλεγχος Κόστους (Cost)

Αν χρησιμοποιείτε πληρωμένες υπηρεσίες AI, μπορείτε να βάλετε όρια.

  • daily_limit_usd: Μέγιστο ποσό ανά ημέρα (π.χ. 10.00 δολάρια).
  • monthly_limit_usd: Μέγιστο ποσό ανά μήνα.

6. Εικόνες (Multimodal)

Ρυθμίσεις για το πώς η AI βλέπει εικόνες.

  • max_images: Μέγιστος αριθμός εικόνων ανά μήνυμα.
  • allow_remote_fetch: Αν επιτρέπεται στην AI να κατεβάζει εικόνες από το ίντερνετ μέσω συνδέσμων (links).

Συμβουλές

  • Αν αλλάξετε το αρχείο config.toml, πρέπει να κάνετε επανεκκίνηση το ZeroClaw για να δει τις αλλαγές.
  • Χρησιμοποιήστε την εντολή zeroclaw doctor για να βεβαιωθείτε ότι οι ρυθμίσεις σας είναι σωστές.

Ενημέρωση (2026-03-03)

  • Στην ενότητα [agent] προστέθηκαν τα allowed_tools και denied_tools.
    • Αν το allowed_tools δεν είναι κενό, ο primary agent βλέπει μόνο τα εργαλεία της λίστας.
    • Το denied_tools εφαρμόζεται μετά το allowlist και αφαιρεί επιπλέον εργαλεία.
  • Άγνωστες τιμές στο allowed_tools αγνοούνται (με debug log) και δεν μπλοκάρουν την εκκίνηση.
  • Αν allowed_tools και denied_tools καταλήξουν να αφαιρέσουν όλα τα εκτελέσιμα εργαλεία, η εκκίνηση αποτυγχάνει άμεσα με σαφές μήνυμα ρύθμισης.
  • Για πλήρη πίνακα πεδίων και παράδειγμα, δείτε το αγγλικό config-reference.md στην ενότητα [agent].
  • Μην μοιράζεστε ποτέ το αρχείο config.toml με άλλους, καθώς περιέχει τα μυστικά κλειδιά σας (tokens).