Saltar al contenido principal
scripts/ contiene scripts auxiliares para flujos de trabajo locales y tareas de operaciones. Úsalos cuando una tarea esté claramente vinculada a un script; de lo contrario, prefiere la CLI.

​
Convenciones

  • Los scripts son opcionales salvo que se mencionen en la documentación o en listas de comprobación de lanzamiento.
  • Prefiere las superficies de CLI cuando existan (ejemplo: openclaw models status --check).
  • Asume que los scripts son específicos del host; léelos antes de ejecutarlos en una máquina nueva.

​
Scripts de monitoreo de autenticación

La autenticación general de modelos se trata en Autenticación. Los scripts siguientes son un sistema separado y opcional para monitorear un token de suscripción de Claude Code CLI en un host remoto/sin interfaz y volver a autenticarse desde un teléfono:
  • scripts/setup-auth-system.sh - configuración única: comprueba la autenticación actual, ayuda a generar un claude setup-token de larga duración e imprime los pasos de instalación de systemd/Termux.
  • scripts/claude-auth-status.sh [full|json|simple] - comprueba el estado de autenticación de Claude Code + OpenClaw.
  • scripts/auth-monitor.sh - sondea el estado y envía una notificación (mediante OpenClaw send y/o ntfy.sh) cuando el token se acerca a su vencimiento. Env: WARN_HOURS (predeterminado 2), NOTIFY_PHONE, NOTIFY_NTFY. Ejecútalo según una programación mediante los scripts/systemd/openclaw-auth-monitor.{service,timer} incluidos (cada 30 minutos).
  • scripts/mobile-reauth.sh - vuelve a ejecutar claude setup-token e imprime las URL para abrir en un teléfono, para usar 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 por SSH al host, muestran un aviso de estado y abren la consola/instrucciones de reautenticación cuando la autenticación ha expirado.

​
Ayudante de lectura de GitHub

Usa scripts/gh-read cuando quieras que gh use un token de instalación de GitHub App para llamadas de lectura con alcance de repo, mientras dejas el gh normal con tu inicio de sesión personal para acciones de escritura. Env requeridas:
  • OPENCLAW_GH_READ_APP_ID
  • OPENCLAW_GH_READ_PRIVATE_KEY_FILE
Env opcionales:
  • OPENCLAW_GH_READ_INSTALLATION_ID cuando quieras omitir la búsqueda de instalación basada en el repo
  • OPENCLAW_GH_READ_PERMISSIONS como anulación separada por comas para el subconjunto de permisos de lectura que se solicitará
Orden de resolución del repo:
  • 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 agregar scripts

  • Mantén los scripts enfocados y documentados.
  • Agrega una entrada breve en la documentación relevante (o crea una si falta).

​
Relacionado