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 un claude 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 fournis scripts/systemd/openclaw-auth-monitor.{service,timer} (toutes les 30 minutes).
  • scripts/mobile-reauth.sh - réexécute claude setup-token et 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_ID
  • OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Variables d’environnement facultatives :

  • OPENCLAW_GH_READ_INSTALLATION_ID pour ignorer la recherche de l’installation à partir du dépôt
  • OPENCLAW_GH_READ_PERMISSIONS comme 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/repo
  • GH_REPO
  • git remote origin

Exemples :

  • scripts/gh-read pr view 123
  • scripts/gh-read run list -R openclaw/openclaw
  • scripts/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).

Voir aussi

Was this useful?
On this page

On this page