mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
wenjie
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
> Retour au [README](../project/README.fr.md)
|
|
|
|
# Utiliser le fournisseur Antigravity dans PicoClaw
|
|
|
|
Ce guide explique comment configurer et utiliser le fournisseur **Antigravity** (Google Cloud Code Assist) dans PicoClaw.
|
|
|
|
## Prérequis
|
|
|
|
1. Un compte Google.
|
|
2. Google Cloud Code Assist activé (généralement disponible via l'intégration « Gemini for Google Cloud »).
|
|
|
|
## 1. Authentification
|
|
|
|
Pour vous authentifier avec Antigravity, exécutez la commande suivante :
|
|
|
|
```bash
|
|
picoclaw auth login --provider antigravity
|
|
```
|
|
|
|
### Authentification manuelle (Headless/VPS)
|
|
Si vous exécutez PicoClaw sur un serveur (Coolify/Docker) et ne pouvez pas accéder à `localhost`, suivez ces étapes :
|
|
1. Exécutez la commande ci-dessus.
|
|
2. Copiez l'URL fournie et ouvrez-la dans votre navigateur local.
|
|
3. Complétez la connexion.
|
|
4. Votre navigateur sera redirigé vers une URL `localhost:51121` (qui ne se chargera pas).
|
|
5. **Copiez cette URL finale** depuis la barre d'adresse de votre navigateur.
|
|
6. **Collez-la dans le terminal** où PicoClaw attend.
|
|
|
|
PicoClaw extraira automatiquement le code d'autorisation et terminera le processus.
|
|
|
|
## 2. Gestion des modèles
|
|
|
|
### Lister les modèles disponibles
|
|
Pour voir quels modèles sont accessibles à votre projet et vérifier leurs quotas :
|
|
|
|
```bash
|
|
picoclaw auth models
|
|
```
|
|
|
|
### Changer de modèle
|
|
Vous pouvez modifier le modèle par défaut dans `~/.picoclaw/config.json` ou le remplacer via le CLI :
|
|
|
|
```bash
|
|
# Remplacer pour une seule commande
|
|
picoclaw agent -m "Hello" --model claude-opus-4-6-thinking
|
|
```
|
|
|
|
## 3. Utilisation en production (Coolify/Docker)
|
|
|
|
Si vous déployez via Coolify ou Docker, suivez ces étapes pour tester :
|
|
|
|
1. **Variables d'environnement** :
|
|
* `PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-flash`
|
|
2. **Persistance de l'authentification** :
|
|
Si vous vous êtes connecté localement, vous pouvez copier vos identifiants vers le serveur :
|
|
```bash
|
|
scp ~/.picoclaw/auth.json user@your-server:~/.picoclaw/
|
|
```
|
|
*Alternativement*, exécutez la commande `auth login` une fois sur le serveur si vous avez un accès terminal.
|
|
|
|
## 4. Dépannage
|
|
|
|
* **Réponse vide** : Si un modèle renvoie une réponse vide, il peut être restreint pour votre projet. Essayez `gemini-3-flash` ou `claude-opus-4-6-thinking`.
|
|
* **429 Limite de débit** : Antigravity a des quotas stricts. PicoClaw affichera le « temps de réinitialisation » dans le message d'erreur si vous atteignez une limite.
|
|
* **404 Non trouvé** : Assurez-vous d'utiliser un ID de modèle provenant de la liste `picoclaw auth models`. Utilisez l'ID court (par ex. `gemini-3-flash`) et non le chemin complet.
|
|
|
|
## 5. Résumé des modèles fonctionnels
|
|
|
|
D'après les tests, les modèles suivants sont les plus fiables :
|
|
* `gemini-3-flash` (Rapide, haute disponibilité)
|
|
* `gemini-2.5-flash-lite` (Léger)
|
|
* `claude-opus-4-6-thinking` (Puissant, inclut le raisonnement)
|