Scripts

기준일: 2026-07-26
공식 기준: Scripts

Scripts 문서는 OpenClaw 공식 문서(help/scripts)를 한국어로 정리한 가이드입니다. Repository scripts: purpose, scope, and safety notes 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Repository scripts: purpose, scope, and safety notes

한국어 가이드 범위: help/scripts 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Conventions
• Auth monitoring scripts
• GitHub read helper
• When adding scripts
• 관련 문서

상세 내용

본문

scripts/ holds helper scripts for local workflows and ops tasks. Use these when a task is clearly tied to a script; otherwise prefer the CLI.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Conventions

주요 항목:

• Scripts are optional unless referenced in docs or release checklists.
• Prefer CLI surfaces when they exist (example: openclaw models status --check).
• Assume scripts are host-specific; read them before running on a new machine.

Auth monitoring scripts

General model auth is covered in Authentication. The scripts below are a separate, optional system for monitoring a Claude Code CLI subscription token on a remote/headless host and re-authenticating from a phone:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• scripts/setup-auth-system.sh - one-time setup: checks current auth, helps generate a long-lived claude setup-token, and prints systemd/Termux install steps.
• scripts/claude-auth-status.sh [full|json|simple] - checks Claude Code + OpenClaw auth status.
• scripts/auth-monitor.sh - polls status and sends a notification (via OpenClaw send, and/or ntfy.sh) when the token nears expiry. Env: WARN_HOURS (default 2), NOTIFY_PHONE, NOTIFY_NTFY. Run on a schedule via the bundled scripts/systemd/openclaw-auth-monitor.{service,timer} (every 30 minutes).
• scripts/mobile-reauth.sh - re-runs claude setup-token and prints URLs to open on a phone, for use over SSH from Termux.
• scripts/termux-quick-auth.sh, scripts/termux-auth-widget.sh, scripts/termux-sync-widget.sh - Termux:Widget scripts that SSH to the host, show a status toast, and open the re-auth console/instructions when auth has expired.

GitHub read helper

Use scripts/gh-read when you want gh to use a GitHub App installation token for repo-scoped read calls while leaving normal gh on your personal login for write actions.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE
• OPENCLAW_GH_READ_INSTALLATION_ID when you want to skip repo-based installation lookup
• OPENCLAW_GH_READ_PERMISSIONS as a comma-separated override for the read permission subset to request
• gh ... -R owner/repo
• GH_REPO
• git remote origin
• scripts/gh-read pr view 123
• scripts/gh-read run list -R openclaw/openclaw
• scripts/gh-read api repos/openclaw/openclaw/pulls/123

When adding scripts

주요 항목:

• Keep scripts focused and documented.
• Add a short entry in the relevant doc (or create one if missing).

관련 문서

주요 항목:

• Testing
• Testing live

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/help/scripts
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

관련 링크

• 공식 원문: help/scripts
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.