OpenClawの認証監視：CLIで有効期限を自動チェックする方法

開発を進めている最中に、突然認証エラーで作業が止まってしまった経験はありませんか？OAuthの期限切れは、気づかないうちにやってくる厄介な問題です。OpenClawでは、こうしたトラブルを未然に防ぐための仕組みが用意されています。

OpenClawは、openclaw models status を通じてOAuthの有効期限の状態を確認できます。これを自動化やアラートに活用するのがおすすめです。スクリプトは、スマートフォンでのワークフローなど、特定の用途に合わせて追加で利用できます。

推奨：CLIによるチェック（ポータブル）

openclaw models status --check

終了コード（Exit codes）は以下の通りです：

• 0: 正常
• 1: 認証情報の期限切れ、または不足
• 2: まもなく期限切れ（24時間以内）

この方法は cron や systemd で動作し、追加のスクリプトを必要としません。

オプションのスクリプト（運用・スマホ用ワークフロー）

これらは scripts/ ディレクトリに用意されているオプションのツールです。Gateway ホストへの SSH アクセスを前提としており、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 の認証チェッカーです（full/json/simple モードに対応）。
• 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 タイマーが必要ない場合は、これらのスクリプトはスキップして構いません。

次のステップ

• CLI Reference
• Configuration Guide

AI Setup Assistant