Release and CI

Скрипты

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

Соглашения

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

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

Общая аутентификация моделей описана в разделе Аутентификация. Приведённые ниже скрипты представляют собой отдельную необязательную систему для мониторинга токена подписки 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

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

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

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

Was this useful?
On this page

On this page