Scripts

scripts/ contiene scripts auxiliares para flujos de trabajo locales y tareas operativas. Úselos cuando una tarea esté claramente vinculada a un script; de lo contrario, prefiera la CLI.

Convenciones

• Los scripts son opcionales, salvo que se mencionen en la documentación o en las listas de verificación de versiones.
• Prefiera las interfaces de la CLI cuando existan (ejemplo: openclaw models status --check).
• Suponga que los scripts son específicos del host; léalos antes de ejecutarlos en una máquina nueva.

Scripts de supervisión de autenticación

La autenticación general de modelos se trata en Autenticación. Los scripts siguientes constituyen un sistema independiente y opcional para supervisar un token de suscripción de Claude Code CLI en un host remoto o sin interfaz gráfica y volver a autenticarse desde un teléfono:

• scripts/setup-auth-system.sh - configuración inicial: comprueba la autenticación actual, ayuda a generar un claude setup-token de larga duración y muestra los pasos de instalación para systemd/Termux.
• scripts/claude-auth-status.sh [full|json|simple] - comprueba el estado de autenticación de Claude Code y OpenClaw.
• scripts/auth-monitor.sh - consulta periódicamente el estado y envía una notificación (mediante el envío de OpenClaw o ntfy.sh, o ambos) cuando el token está próximo a caducar. Variables de entorno: WARN_HOURS (valor predeterminado: 2), NOTIFY_PHONE, NOTIFY_NTFY. Ejecútelo de forma programada mediante scripts/systemd/openclaw-auth-monitor.{service,timer}, incluido con el proyecto (cada 30 minutos).
• scripts/mobile-reauth.sh - vuelve a ejecutar claude setup-token y muestra las URL que deben abrirse en un teléfono, para utilizarlo por SSH desde Termux.
• scripts/termux-quick-auth.sh, scripts/termux-auth-widget.sh, scripts/termux-sync-widget.sh - scripts de Termux:Widget que se conectan al host mediante SSH, muestran una notificación breve de estado y abren la consola o las instrucciones de reautenticación cuando la autenticación ha caducado.

Auxiliar de lectura de GitHub

Use scripts/gh-read cuando quiera que gh utilice un token de instalación de una aplicación de GitHub para realizar llamadas de lectura limitadas al repositorio, mientras mantiene la sesión personal normal de gh para las acciones de escritura.

Variables de entorno obligatorias:

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Variables de entorno opcionales:

• OPENCLAW_GH_READ_INSTALLATION_ID cuando quiera omitir la búsqueda de la instalación basada en el repositorio
• OPENCLAW_GH_READ_PERMISSIONS como anulación, separada por comas, del subconjunto de permisos de lectura que se solicitará

Orden de resolución del repositorio:

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

Ejemplos:

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

Al añadir scripts

• Mantenga los scripts bien delimitados y documentados.
• Añada una entrada breve en el documento correspondiente (o créelo si no existe).

Contenido relacionado

• Pruebas
• Pruebas en vivo