2.5 KiB
2.5 KiB
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Scripts du dépôt : objectif, portée et remarques de sécurité | Scripts |
|
Le répertoire scripts/ contient des scripts d’assistance pour les flux de travail locaux et les tâches d’exploitation.
Utilisez-les lorsqu’une tâche est clairement liée à un script ; sinon préférez la CLI.
Conventions
- Les scripts sont facultatifs sauf s’ils sont référencés dans la documentation ou les listes de contrôle de publication.
- Préférez les surfaces CLI lorsqu’elles existent (exemple : la surveillance de l’authentification utilise
openclaw models status --check). - Supposez que les scripts sont spécifiques à l’hôte ; lisez-les avant de les exécuter sur une nouvelle machine.
Scripts de surveillance de l’authentification
La surveillance de l’authentification est couverte dans Authentification. Les scripts sous scripts/ sont des extras facultatifs pour les flux systemd/Termux sur téléphone.
Assistant de lecture GitHub
Utilisez scripts/gh-read lorsque vous voulez que gh utilise un jeton d’installation GitHub App pour des appels de lecture limités au dépôt, tout en laissant le gh normal sur votre connexion personnelle 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_IDsi vous voulez ignorer la recherche d’installation basée sur le dépôtOPENCLAW_GH_READ_PERMISSIONScomme remplacement séparé par des virgules pour le 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
- Gardez les scripts ciblés et documentés.
- Ajoutez une courte entrée dans la documentation pertinente (ou créez-en une si elle manque).