automation/auth-monitoring.md¶

OpenClaw 透過 openclaw models status 提供 OAuth 到期健康狀態。請將其用於 自動化與警示；腳本僅為手機工作流程的選用加值。 Use that for automation and alerting; scripts are optional extras for phone workflows.

建議：CLI 檢查（可攜式）¶

openclaw models status --check

結束碼：

• 0：正常
• 1：憑證已到期或缺失
• 2：即將到期（24 小時內）

可在 cron/systemd 中運作，且不需要額外腳本。

可選腳本（維運／手機工作流程）¶

這些檔案位於 scripts/ 目錄下，且為 可選。它們假設可透過 SSH 存取該 gateway host and are tuned for systemd + Termux.

• scripts/claude-auth-status.sh 現在使用 openclaw models status --json 作為 事實來源（若 CLI 無法使用，則回退為直接讀取檔案）， 因此請在 PATH 上為計時器保留 openclaw。
• scripts/auth-monitor.sh：cron/systemd 計時器目標；傳送警示（ntfy 或手機）。
• scripts/systemd/openclaw-auth-monitor.{service,timer}：systemd 使用者計時器。
• scripts/claude-auth-status.sh：Claude Code + OpenClaw 身分驗證檢查器（完整／json／簡易）。
• scripts/mobile-reauth.sh：透過 SSH 的引導式重新身分驗證流程。
• scripts/termux-quick-auth.sh：一鍵小工具狀態 + 開啟身分驗證 URL。
• scripts/termux-auth-widget.sh：完整的引導式小工具流程。
• scripts/termux-sync-widget.sh：同步 Claude Code 憑證 → OpenClaw。

如果您不需要手機自動化或 systemd 計時器，可以跳過這些腳本。