跳到內容

OpenClaw 驗證監控:透過 CLI 快速檢查 OAuth 狀態

你有沒有遇過這種情況?正準備讓 AI 幫你處理緊急任務,結果因為 OAuth 憑證過期直接報錯,還得手動去檢查到底是哪裡出問題。這種重複性的維護工作最適合交給自動化工具來處理。

OpenClaw 透過 openclaw models status 暴露了 OAuth 的過期健康狀態。你可以將它用於自動化和告警;至於腳本部分,則是針對手機工作流提供的額外選項。

Terminal window
openclaw models status --check

結束代碼(Exit codes):

  • 0: 正常
  • 1: 憑證已過期或缺失
  • 2: 即將過期(24 小時內)

這套機制在 cron 或 systemd 中運作良好,而且不需要額外的腳本。

選用腳本(維運 / 手機工作流)

Section titled “選用腳本(維運 / 手機工作流)”

這些腳本存放在 scripts/ 目錄下,並且是選配的。它們假設你可以透過 SSH 存取 Gateway 主機,並針對 systemd 和 Termux 進行了優化。

  • scripts/claude-auth-status.sh 現在使用 openclaw models status --json 作為單一事實來源(如果 CLI 無法使用,則會退回到直接讀取檔案),所以請確保 openclaw 在 PATH 中以便計時器執行。
  • 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 計時器,可以直接跳過這些腳本。

AI Setup Assistant

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。