Release and CI
Scripts
scripts/ contient des scripts auxiliaires pour les workflows locaux et les tâches d’exploitation. Utilisez-les lorsqu’une tâche est clairement liée à un script ; sinon, privilégiez la CLI.
Conventions
- Les scripts sont facultatifs, sauf s’ils sont mentionnés dans la documentation ou les listes de contrôle de publication.
- Privilégiez les interfaces de la CLI lorsqu’elles existent (exemple :
openclaw models status --check). - Partez du principe que les scripts sont propres à l’hôte ; lisez-les avant de les exécuter sur une nouvelle machine.
Scripts de surveillance de l’authentification
L’authentification générale des modèles est décrite dans Authentification. Les scripts ci-dessous constituent un système distinct et facultatif permettant de surveiller un jeton d’abonnement à la CLI Claude Code sur un hôte distant ou sans interface graphique, puis de se réauthentifier depuis un téléphone :
scripts/setup-auth-system.sh- configuration initiale : vérifie l’authentification actuelle, aide à générer unclaude setup-tokenà longue durée de vie et affiche les étapes d’installation pour systemd/Termux.scripts/claude-auth-status.sh [full|json|simple]- vérifie l’état de l’authentification de Claude Code et d’OpenClaw.scripts/auth-monitor.sh- interroge régulièrement l’état et envoie une notification (via l’envoi OpenClaw et/ou ntfy.sh) lorsque le jeton approche de son expiration. Variables d’environnement :WARN_HOURS(valeur par défaut :2),NOTIFY_PHONE,NOTIFY_NTFY. Exécutez-le de façon planifiée à l’aide des fichiers fournisscripts/systemd/openclaw-auth-monitor.{service,timer}(toutes les 30 minutes).scripts/mobile-reauth.sh- réexécuteclaude setup-tokenet affiche les URL à ouvrir sur un téléphone, pour une utilisation via SSH depuis Termux.scripts/termux-quick-auth.sh,scripts/termux-auth-widget.sh,scripts/termux-sync-widget.sh- scripts Termux:Widget qui se connectent à l’hôte via SSH, affichent une notification contextuelle d’état et ouvrent la console ou les instructions de réauthentification lorsque l’authentification a expiré.
Utilitaire de lecture GitHub
Utilisez scripts/gh-read lorsque vous souhaitez que gh emploie un jeton d’installation d’application GitHub pour les appels en lecture limités au dépôt, tout en conservant la connexion de votre compte personnel dans l’utilisation normale de gh pour les actions d’écriture.
Variables d’environnement requises :
OPENCLAW_GH_READ_APP_IDOPENCLAW_GH_READ_PRIVATE_KEY_FILE
Variables d’environnement facultatives :
OPENCLAW_GH_READ_INSTALLATION_IDpour ignorer la recherche de l’installation à partir du dépôtOPENCLAW_GH_READ_PERMISSIONScomme remplacement, séparé par des virgules, du sous-ensemble d’autorisations de lecture à demander
Ordre de résolution du dépôt :
gh ... -R owner/repoGH_REPOgit remote origin
Exemples :
scripts/gh-read pr view 123scripts/gh-read run list -R openclaw/openclawscripts/gh-read api repos/openclaw/openclaw/pulls/123
Lors de l’ajout de scripts
- Veillez à ce que les scripts restent ciblés et documentés.
- Ajoutez une courte entrée dans la documentation concernée (ou créez-en une si elle n’existe pas).