Перейти до основного вмісту

Скрипти

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

Угоди

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

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

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

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

Використовуйте scripts/gh-read, коли хочете, щоб gh використовував токен встановлення GitHub App для викликів читання в межах репозиторію, водночас залишаючи звичайний 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

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

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