Auth Monitoring
Monitor OAuth expiry for model providers.
OpenClaw exposes OAuth expiry health via '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'openclaw models status'</code>'. Use it for
automation and alerting; scripts are optional add-ons for phone workflows.
Preferred: CLI check (portable)
openclaw models status --check
Exit codes:
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'0'</code>': OK
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'1'</code>': Credentials expired or missing
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'2'</code>': Expiring soon (within 24 hours)
This works in cron/systemd and doesn't require extra scripts.
Optional scripts (actions/phone workflows)
These live under '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/'</code>' and are '<strong>'optional'</strong>'. They assume SSH access to
the gateway host and are tuned for systemd + Termux.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/claude-auth-status.sh'</code>' now uses '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'openclaw models status --json'</code>' as
source of truth (falls back to direct file read if CLI unavailable),
so keep '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'openclaw'</code>' on PATH for timers.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/auth-monitor.sh'</code>': cron/systemd timer target; sends alerts (ntfy or phone).
- <code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">scripts/systemd/openclaw-auth-monitor.{service,timer}'</code>: systemd user timer.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/claude-auth-status.sh'</code>': Claude code + OpenClaw auth checker (full/json/simple).
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/mobile-reauth.sh'</code>': guide reauth flow via SSH.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/termux-quick-auth.sh'</code>': one-tap widget status + open auth URL.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/termux-auth-widget.sh'</code>': full guided widget flow.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'scripts/termux-sync-widget.sh'</code>': sync Claude code credits → OpenClaw.
Skip these scripts if you don't need phone automation or systemd timers.