mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00

Files

T

BeaconCat 403ceb39be docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

## Config field fixes (cross-verified against Go source)
- MaixCam: server_address → host + port
- IRC: use_tls → tls, channels_to_join → channels (all 6 languages)
- WeCom AI Bot: callback port 18791 → 18790
- credential_encryption: base_url → api_base, add required model field,
  remove incorrect passphrase-only mode docs
- providers.md: agents.defaults.model → model_name (×4), remove
  non-existent session.backlog_limit
- migration guide, troubleshooting: agents.defaults.model → model_name
- ANTIGRAVITY_AUTH: fix file path, Go 1.21 → 1.25, model → model_name
- spawn-tasks: fix truncated file, add Heartbeat introduction
- tools_configuration: add Tavily/SearXNG/GLMSearch, exec allow_remote/
  timeout_seconds/custom_allow_patterns, cron allow_command, skills
  github/search_cache, clawhub timeout/max_zip_size/max_response_size
- configuration: fix builtin skills path (build-time embedded, not cwd),
  HEARTBEAT.md marked auto-generated

## Broken link fixes (15 total)
- chat-apps.md: WeCom/Matrix links with wrong relative paths
- providers.md: migration link with extra docs/ prefix
- hardware-compatibility.md: README links with wrong depth (all 5 langs)
- chat-apps.md: WhatsApp dead links → anchor links (zh/ja)

## Getting-started accuracy
- README (all 6 langs): add picoclaw.io as recommended download,
  add missing picoclaw model CLI command
- docker.md: clarify first-run trigger condition (all 6 langs)
- configuration.md: fix builtin skills path description (all 6 langs)

## QQ channel
- Add quick setup via q.qq.com/qqbot/openclaw (one-click bot creation)
- Add manual setup as fallback (all 6 languages)

## Feishu channel
- Update setup flow: WebSocket/SDK mode, no webhook URL needed
- Preserve Lark international domain note (all 6 languages)

## chat-apps.md
- Add Feishu, Slack, IRC, OneBot detail sections (all 6 languages)
- Add MaixCam section to ja/fr/pt-br/vi
- Fix all channel doc links to point to correct language version

## New translations (25 files, 5 docs × 5 languages)
debug.md, credential_encryption.md, hardware-compatibility.md,
ANTIGRAVITY_AUTH.md, ANTIGRAVITY_USAGE.md → zh/ja/fr/pt-br/vi

## Channel docs (6 languages each, 60 new files)
telegram, discord, qq, feishu, maixcam, dingtalk, line, slack, onebot,
wecom/wecom_aibot, wecom/wecom_app, wecom/wecom_bot

Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com>

2026-03-20 22:37:05 +08:00

2.9 KiB

Raw Blame History

Retour au README

Utiliser le fournisseur Antigravity dans PicoClaw

Ce guide explique comment configurer et utiliser le fournisseur Antigravity (Google Cloud Code Assist) dans PicoClaw.

Prérequis

Un compte Google.
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 :

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 :

Exécutez la commande ci-dessus.
Copiez l'URL fournie et ouvrez-la dans votre navigateur local.
Complétez la connexion.
Votre navigateur sera redirigé vers une URL localhost:51121 (qui ne se chargera pas).
Copiez cette URL finale depuis la barre d'adresse de votre navigateur.
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 :

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 :

# 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 :

Variables d'environnement :
- PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-flash
Persistance de l'authentification : Si vous vous êtes connecté localement, vous pouvez copier vos identifiants vers le serveur :
```
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)

2.9 KiB Raw Blame History