Скрипти

Каталог scripts/ містить допоміжні скрипти для локальних робочих процесів і операційних завдань. Використовуйте їх, коли завдання явно пов’язане зі скриптом; інакше віддавайте перевагу CLI.

# Конвенції

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

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

Моніторинг автентифікації описано в розділі Автентифікація. Скрипти в scripts/ є необов’язковими доповненнями для робочих процесів телефонів із systemd/Termux.

# Допоміжний скрипт читання GitHub

Використовуйте scripts/gh-read, коли потрібно, щоб gh використовував токен інсталяції GitHub App для repo-обмежених викликів читання, залишаючи звичайний gh у вашому особистому логіні для дій запису.

Обов’язкові env:

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Необов’язкові env:

• 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

# Під час додавання скриптів

• Робіть скрипти сфокусованими й документованими.
• Додайте короткий запис у відповідну документацію (або створіть її, якщо вона відсутня).

# Пов’язане

• Тестування
• Тестування в реальному середовищі