OpenClaw 인증 상태 모니터링: CLI로 1분 만에 확인하기

API 인증이 갑자기 만료되어 작업이 중단된 적 있으신가요? 매번 수동으로 확인하는 건 정말 번거로운 일이죠. OpenClaw는 이런 불편함을 줄이기 위해 OAuth 만료 상태를 쉽게 확인할 수 있는 기능을 제공합니다.

인증 모니터링

OpenClaw는 openclaw models status를 통해 OAuth 만료 상태를 노출합니다. 이 기능을 자동화나 알림 설정에 활용해 보세요. 스크립트는 모바일 워크플로우를 위한 추가 옵션일 뿐입니다.

권장 방법: CLI 체크 (이식성 좋음)

openclaw models status --check

종료 코드(Exit codes):

• 0: 정상 (OK)
• 1: 인증 정보 만료 또는 누락
• 2: 곧 만료 예정 (24시간 이내)

이 방식은 cron이나 systemd에서 잘 작동하며 별도의 추가 스크립트가 필요 없습니다.

선택 사항: 스크립트 (운영 / 모바일 워크플로우)

이 스크립트들은 scripts/ 디렉토리에 있으며 선택 사항입니다. Gateway 호스트에 대한 SSH 접속을 가정하며, 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 인증 체크 도구입니다 (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 타이머가 필요 없다면 이 스크립트들은 건너뛰어도 괜찮습니다.

AI Setup Assistant