88 lines
4.7 KiB
Markdown
88 lines
4.7 KiB
Markdown
# Αναφορά Παρόχων ZeroClaw (Providers Reference)
|
||
|
||
Αυτό το έγγραφο περιγράφει τα ID των παρόχων, τα ψευδώνυμα (aliases) και τις μεταβλητές περιβάλλοντος για τη διαχείριση των διαπιστευτηρίων.
|
||
|
||
Τελευταία επαλήθευση: **21 Φεβρουαρίου 2026**.
|
||
|
||
## Προβολή Διαθέσιμων Παρόχων
|
||
|
||
Για να δείτε τη λίστα με τους ενεργούς παρόχους στο σύστημά σας, εκτελέστε:
|
||
```bash
|
||
zeroclaw providers
|
||
```
|
||
|
||
## Επίλυση Διαπιστευτηρίων (Credential Resolution)
|
||
|
||
Το runtime του ZeroClaw αναζητά διαπιστευτήρια με την εξής σειρά προτεραιότητας:
|
||
|
||
1. **Ρητές ρυθμίσεις**: Τιμές που έχουν οριστεί στο αρχείο `config.toml` ή μέσω παραμέτρων CLI.
|
||
2. **Μεταβλητές περιβάλλοντος παρόχου**: Μεταβλητές ειδικές για κάθε πάροχο (π.χ. `OPENAI_API_KEY`).
|
||
3. **Γενικές μεταβλητές**: Εφεδρικές μεταβλητές όπως οι `ZEROCLAW_API_KEY` ή `API_KEY`.
|
||
|
||
> [!NOTE]
|
||
> Σε περίπτωση χρήσης εφεδρικών παρόχων (`reliability.fallback_providers`), η επίλυση διαπιστευτηρίων γίνεται ανεξάρτητα για κάθε πάροχο. Τα κλειδιά του κύριου παρόχου δεν μεταφέρονται αυτόματα στους εφεδρικούς.
|
||
|
||
## Κατάλογος Παρόχων
|
||
|
||
| ID Παρόχου | Ψευδώνυμα | Τοπικός | Μεταβλητές Περιβάλλοντος |
|
||
|:---|:---|:---:|:---|
|
||
| `openrouter` | — | Όχι | `OPENROUTER_API_KEY` |
|
||
| `anthropic` | — | Όχι | `ANTHROPIC_API_KEY`, `ANTHROPIC_OAUTH_TOKEN` |
|
||
| `openai` | — | Όχι | `OPENAI_API_KEY` |
|
||
| `ollama` | — | Ναι | `OLLAMA_API_KEY` (προαιρετικό) |
|
||
| `gemini` | `google`, `google-gemini` | Όχι | `GEMINI_API_KEY`, `GOOGLE_API_KEY` |
|
||
| `bedrock` | `aws-bedrock` | Όχι | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` |
|
||
| `deepseek` | — | Όχι | `DEEPSEEK_API_KEY` |
|
||
| `mistral` | — | Όχι | `MISTRAL_API_KEY` |
|
||
| `groq` | — | Όχι | `GROQ_API_KEY` |
|
||
| `together` | `together-ai` | Όχι | `TOGETHER_API_KEY` |
|
||
| `fireworks` | `fireworks-ai` | Όχι | `FIREWORKS_API_KEY` |
|
||
| `perplexity` | — | Όχι | `PERPLEXITY_API_KEY` |
|
||
| `xai` | `grok` | Όχι | `XAI_API_KEY` |
|
||
| `cohere` | — | Όχι | `COHERE_API_KEY` |
|
||
| `ollama` | — | Ναι | - |
|
||
| `lmstudio` | `lm-studio` | Ναι | - |
|
||
|
||
## Ειδικές Σημειώσεις
|
||
|
||
### Gemini (Google)
|
||
|
||
- Υποστηρίζει έλεγχο ταυτότητας μέσω API Key ή OAuth (`~/.gemini/oauth_creds.json`).
|
||
- Τα μοντέλα συλλογιστικής (thinking models) υποστηρίζονται εγγενώς· το ZeroClaw φιλτράρει αυτόματα τα εσωτερικά metadata της συλλογιστικής.
|
||
|
||
### Ollama
|
||
|
||
- **Vision**: Υποστηρίζεται μέσω της σύνταξης `[IMAGE:<source>]` στα μηνύματα.
|
||
- **Cloud Routing**: Χρησιμοποιήστε το επίθεμα `:cloud` (π.χ. `llama3:cloud`) για απομακρυσμένα instances. Το `api_url` πρέπει να οριστεί ρητά.
|
||
- **Reasoning**: Η συμπεριφορά συλλογιστικής ελέγχεται μέσω της ρύθμισης `reasoning_enabled` στο αρχείο `config.toml`.
|
||
|
||
### AWS Bedrock
|
||
|
||
- Απαιτεί πλήρη διαπιστευτήρια AWS (Access Key ID και Secret Access Key).
|
||
- Χρησιμοποιεί το Converse API για τη διασφάλιση συμβατότητας με κλήσεις εργαλείων (tool calling).
|
||
|
||
## Προσαρμοσμένα Endpoints
|
||
|
||
Μπορείτε να ορίσετε παρόχους που ακολουθούν τα πρότυπα της αγοράς:
|
||
- **OpenAI-compatible**: `custom:https://your-api-url`
|
||
- **Anthropic-compatible**: `anthropic-custom:https://your-api-url`
|
||
|
||
## Δρομολόγηση Μοντέλων (Model Hints)
|
||
|
||
Χρησιμοποιήστε την ενότητα `[[model_routes]]` για να δημιουργήσετε σταθερά ψευδώνυμα για τα μοντέλα σας:
|
||
|
||
```toml
|
||
[[model_routes]]
|
||
hint = "fast"
|
||
provider = "groq"
|
||
model = "llama-3.3-70b-versatile"
|
||
```
|
||
|
||
Κλήση μέσω CLI: `zeroclaw agent --model hint:fast --message "..."`.
|
||
|
||
## Σχετική Τεκμηρίωση
|
||
|
||
- [config-reference.md](config-reference.md)
|
||
- [commands-reference.md](commands-reference.md)
|
||
- [custom-providers.md](custom-providers.md)
|