Langue et traductions
Les chaînes d’interface de ZeroClaw (messages CLI, aide des commandes et l’interface TUI zerocode) peuvent être affichées dans des langues autres que l’anglais. L’anglais est toujours intégré ; les autres langues sont téléchargées à la demande.
Définir votre langue
ZeroClaw lit une clé locale de premier niveau dans votre configuration. Définissez-la sur un code de locale tel que ja, fr ou zh-CN. Si locale n’est pas définie, ZeroClaw utilise la langue de votre système d’exploitation et se rabat sur l’anglais lorsqu’aucune traduction n’est disponible.
Récupérez vos fichiers de langue
L’anglais est intégré au binaire. Pour toute autre langue, vous récupérez les fichiers traduits une seule fois :
sh
zeroclaw locales fetch ja
Cette commande télécharge les fichiers de traduction japonaise depuis le projet ZeroClaw et les installe dans ~/.zeroclaw/data/ftl/ja/, où ZeroClaw les recherche au démarrage. Redémarrez ensuite ZeroClaw (et zerocode) pour les prendre en compte.
Récupérez n’importe quelle locale de la même manière :
sh
zeroclaw locales fetch fr # Français
zeroclaw locales fetch zh-CN # 简体中文
Récupérer seulement une partie d’une langue
Par défaut, fetch télécharge tous les catalogues pour la locale. Pour n’en télécharger que certains, passez --catalog avec une liste séparée par des virgules :
| Catalogue | Couvre |
|---|---|
cli | Messages CLI et aide des commandes |
tools | Descriptions des outils intégrés |
zerocode | L’interface utilisateur du terminal zerocode |
sh
zeroclaw locales fetch ja --catalog cli # seulement les chaînes CLI
zeroclaw locales fetch ja --catalog cli,zerocode # CLI + l'interface TUI
Si un catalogue n’a pas encore été traduit pour votre langue, fetch l’ignore et vous en informe : les catalogues qui existent sont tout de même installés.
Emplacement des fichiers
| Chemin | Que |
|---|---|
~/.zeroclaw/data/ftl/<locale>/cli.ftl | Traductions des messages CLI |
~/.zeroclaw/data/ftl/<locale>/tools.ftl | Traductions des descriptions d’outils |
~/.zeroclaw/data/ftl/<locale>/zerocode.ftl | zerocode Traductions TUI |
Si vous exécutez ZeroClaw avec un répertoire de configuration personnalisé (--config-dir ou ZEROCLAW_CONFIG_DIR), les fichiers s’installent dans le data/ftl/ de ce répertoire à la place.
Dépannage
- Toujours en anglais après la récupération. Vérifiez que
localedans votre configuration correspond à la locale récupérée, puis redémarrez le processus. ZeroClaw charge les fichiers de langue au démarrage. fetchsignale qu’un catalogue a été ignoré. Ce catalogue n’a pas encore été traduit pour votre langue. Les catalogues disponibles restent installés ; les chaînes non traduites reviennent à l’anglais.- Une chaîne spécifique est en anglais alors que le reste est traduit. Cette chaîne en particulier n’a pas encore de traduction et revient à l’anglais par conception.