10.3 认证监控

OpenClaw 通过 openclaw models status 命令暴露 OAuth 过期健康状态。您可以使用该命令进行自动化监控和告警;提供的脚本是可选的额外工具,主要用于手机端工作流。

推荐方式:CLI 检查(可移植)

openclaw models status --check

退出码说明:

  • 0:正常
  • 1:凭证已过期或缺失
  • 2:即将过期(24小时内)

此命令可在 cron/systemd 中运行,无需额外脚本。

可选脚本(运维 / 手机工作流)

这些脚本位于 scripts/ 目录下,是可选的。它们假设可以通过 SSH 访问网关主机,并针对 systemd + Termux 进行了优化。

  • scripts/claude-auth-status.sh 现在使用 openclaw models status --json 作为数据源(如果 CLI 不可用则回退到直接读取文件),因此请确保 openclawPATH 中以供定时器使用。
  • 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 定时器,可以跳过这些脚本。