> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 身分驗證監控

# automation/auth-monitoring.md

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

## Preferred: CLI check (portable)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models status --check
```

結束碼：

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

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

## Optional scripts (ops / phone workflows)

These live under `scripts/` and are **optional**. 這些檔案位於 `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 計時器，可以跳過這些腳本。