---
read_when:
    - Запуск скриптов из репозитория
    - Добавление или изменение скриптов в ./scripts
summary: 'Скрипты репозитория: назначение, область применения и примечания по безопасности'
title: Скрипты
x-i18n:
    generated_at: "2026-07-13T19:51:36Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: 323069190ea6647101ee7120e06f6b2a018833d0904a11787fa1b610f5b3d9e1
    source_path: help/scripts.md
    workflow: 16
---

`scripts/` содержит вспомогательные скрипты для локальных рабочих процессов и операционных задач. Используйте их, когда задача явно связана со скриптом; в остальных случаях предпочитайте CLI.

## Соглашения

- Скрипты **необязательны**, если на них нет ссылок в документации или контрольных списках выпуска.
- Предпочитайте интерфейсы CLI, когда они доступны (пример: `openclaw models status --check`).
- Считайте скрипты зависящими от хоста; прочитайте их перед запуском на новой машине.

## Скрипты мониторинга аутентификации

Общая аутентификация моделей описана в разделе [Аутентификация](/ru/gateway/authentication). Приведённые ниже скрипты представляют собой отдельную необязательную систему для мониторинга **токена подписки Claude Code CLI** на удалённом хосте или хосте без графического интерфейса и повторной аутентификации с телефона:

- `scripts/setup-auth-system.sh` — однократная настройка: проверяет текущую аутентификацию, помогает создать долгосрочный `claude setup-token` и выводит инструкции по установке для systemd/Termux.
- `scripts/claude-auth-status.sh [full|json|simple]` — проверяет состояние аутентификации Claude Code и OpenClaw.
- `scripts/auth-monitor.sh` — периодически проверяет состояние и отправляет уведомление (через отправку OpenClaw и/или ntfy.sh), когда срок действия токена близок к истечению. Переменные окружения: `WARN_HOURS` (по умолчанию `2`), `NOTIFY_PHONE`, `NOTIFY_NTFY`. Запускайте по расписанию с помощью включённого `scripts/systemd/openclaw-auth-monitor.{service,timer}` (каждые 30 минут).
- `scripts/mobile-reauth.sh` — повторно запускает `claude setup-token` и выводит URL-адреса, которые нужно открыть на телефоне; предназначен для использования по SSH из Termux.
- `scripts/termux-quick-auth.sh`, `scripts/termux-auth-widget.sh`, `scripts/termux-sync-widget.sh` — скрипты Termux:Widget, которые подключаются к хосту по SSH, показывают всплывающее уведомление о состоянии и открывают консоль или инструкции для повторной аутентификации, когда срок действия аутентификации истёк.

## Вспомогательный инструмент для чтения GitHub

Используйте `scripts/gh-read`, если хотите, чтобы `gh` использовал токен установки GitHub App для вызовов чтения в пределах репозитория, а обычный `gh` оставался в вашей личной учётной записи для операций записи.

Обязательные переменные окружения:

- `OPENCLAW_GH_READ_APP_ID`
- `OPENCLAW_GH_READ_PRIVATE_KEY_FILE`

Необязательные переменные окружения:

- `OPENCLAW_GH_READ_INSTALLATION_ID`, если требуется пропустить поиск установки по репозиторию
- `OPENCLAW_GH_READ_PERMISSIONS` — переопределение в виде списка через запятую для запрашиваемого подмножества разрешений на чтение

Порядок определения репозитория:

- `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`

## При добавлении скриптов

- Делайте скрипты специализированными и документируйте их.
- Добавьте краткую запись в соответствующий документ (или создайте его, если он отсутствует).

## Связанные материалы

- [Тестирование](/ru/help/testing)
- [Тестирование в реальной среде](/ru/help/testing-live)