Release and CI

Script

scripts/ contiene script ausiliari per i flussi di lavoro locali e le attività operative. Usali quando un'attività è chiaramente legata a uno script; altrimenti, preferisci la CLI.

Convenzioni

Gli script sono facoltativi, a meno che non siano citati nella documentazione o nelle liste di controllo per il rilascio.
Preferisci le funzionalità della CLI quando disponibili (esempio: openclaw models status --check).
Presumi che gli script siano specifici dell'host; leggili prima di eseguirli su una nuova macchina.

Script di monitoraggio dell'autenticazione

L'autenticazione generale dei modelli è descritta in Autenticazione. Gli script seguenti costituiscono un sistema separato e facoltativo per monitorare un token di abbonamento alla CLI di Claude Code su un host remoto o senza interfaccia grafica e ripetere l'autenticazione da un telefono:

scripts/setup-auth-system.sh - configurazione iniziale: verifica l'autenticazione corrente, aiuta a generare un claude setup-token di lunga durata e mostra i passaggi di installazione per systemd/Termux.
scripts/claude-auth-status.sh [full|json|simple] - verifica lo stato dell'autenticazione di Claude Code e OpenClaw.
scripts/auth-monitor.sh - controlla periodicamente lo stato e invia una notifica (tramite l'invio di OpenClaw e/o ntfy.sh) quando il token è prossimo alla scadenza. Variabili d'ambiente: WARN_HOURS (valore predefinito 2), NOTIFY_PHONE, NOTIFY_NTFY. Eseguilo a intervalli regolari tramite i file inclusi scripts/systemd/openclaw-auth-monitor.{service,timer} (ogni 30 minuti).
scripts/mobile-reauth.sh - esegue nuovamente claude setup-token e mostra gli URL da aprire su un telefono, per l'utilizzo tramite SSH da Termux.
scripts/termux-quick-auth.sh, scripts/termux-auth-widget.sh, scripts/termux-sync-widget.sh - script per Termux:Widget che si connettono all'host tramite SSH, mostrano una notifica temporanea sullo stato e aprono la console o le istruzioni per ripetere l'autenticazione quando questa è scaduta.

Utilità di lettura per GitHub

Usa scripts/gh-read quando vuoi che gh utilizzi un token di installazione di un'app GitHub per le chiamate di lettura limitate al repository, mantenendo al contempo il normale gh connesso al tuo account personale per le operazioni di scrittura.

Variabili d'ambiente obbligatorie:

OPENCLAW_GH_READ_APP_ID
OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Variabili d'ambiente facoltative:

OPENCLAW_GH_READ_INSTALLATION_ID quando vuoi ignorare la ricerca dell'installazione basata sul repository
OPENCLAW_GH_READ_PERMISSIONS come valore alternativo separato da virgole per il sottoinsieme di autorizzazioni di lettura da richiedere

Ordine di risoluzione del repository:

gh ... -R owner/repo
GH_REPO
git remote origin

Esempi:

scripts/gh-read pr view 123
scripts/gh-read run list -R openclaw/openclaw
scripts/gh-read api repos/openclaw/openclaw/pulls/123

Quando aggiungi script

Mantieni gli script mirati e documentati.
Aggiungi una breve voce nella documentazione pertinente (oppure creane una se manca).

Contenuti correlati

Was this useful?