115 lines
7.0 KiB
Markdown
115 lines
7.0 KiB
Markdown
# Οδηγός Ρυθμίσεων 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**:
|
||
```toml
|
||
[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).
|
||
|
||
## Ενημέρωση (2026-03-12)
|
||
|
||
- Στην ενότητα `[agent]` προστέθηκε το `tool_filter_groups` για φιλτράρισμα schema tool MCP ανά γύρο.
|
||
|
||
### `tool_filter_groups`
|
||
|
||
Μειώνει τα tokens ανά γύρο περιορίζοντας ποια schema tool MCP αποστέλλονται στο LLM. Τα ενσωματωμένα εργαλεία (χωρίς πρόθεμα `mcp_`) περνούν πάντα αναλλοίωτα.
|
||
|
||
Κάθε εγγραφή είναι πίνακας με τα εξής πεδία:
|
||
|
||
| Πεδίο | Τύπος | Σκοπός |
|
||
|---|---|---|
|
||
| `mode` | `"always"` \| `"dynamic"` | `always`: το εργαλείο συμπεριλαμβάνεται πάντα. `dynamic`: συμπεριλαμβάνεται μόνο όταν το μήνυμα χρήστη περιέχει λέξη-κλειδί. |
|
||
| `tools` | `[string]` | Μοτίβα ονόματος εργαλείου. Υποστηρίζεται ένα `*` wildcard (π.χ. `"mcp_vikunja_*"`). |
|
||
| `keywords` | `[string]` | (Μόνο για dynamic) Υποαλφαριθμητικά χωρίς διάκριση πεζών-κεφαλαίων που αντιστοιχούν στο τελευταίο μήνυμα χρήστη. |
|
||
|
||
Όταν το `tool_filter_groups` είναι κενό, η λειτουργία είναι ανενεργή και όλα τα εργαλεία περνούν κανονικά (συμβατό με προηγούμενες εκδόσεις).
|
||
|
||
Παράδειγμα:
|
||
|
||
```toml
|
||
[agent]
|
||
# Τα εργαλεία MCP Vikunja είναι πάντα διαθέσιμα.
|
||
[[agent.tool_filter_groups]]
|
||
mode = "always"
|
||
tools = ["mcp_vikunja_*"]
|
||
|
||
# Τα εργαλεία MCP browser συμπεριλαμβάνονται μόνο όταν ο χρήστης αναφέρει πλοήγηση.
|
||
[[agent.tool_filter_groups]]
|
||
mode = "dynamic"
|
||
tools = ["mcp_browser_*"]
|
||
keywords = ["περιήγηση", "πλοήγηση", "άνοιγμα url", "στιγμιότυπο"]
|
||
```
|