> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Скрипты

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

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

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

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

Общая аутентификация моделей описана в разделе [Аутентификация](https://docs2.openclaw.ai/ru/gateway/authentication.md). Приведённые ниже скрипты представляют собой отдельную необязательную систему для мониторинга **токена подписки 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`

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

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

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

* [Тестирование](https://docs2.openclaw.ai/ru/help/testing.md)
* [Тестирование в реальной среде](https://docs2.openclaw.ai/ru/help/testing-live.md)