Skrypty

Katalog scripts/ zawiera skrypty pomocnicze do lokalnych przepływów pracy i zadań operacyjnych. Używaj ich, gdy zadanie jest wyraźnie powiązane ze skryptem; w przeciwnym razie preferuj CLI.

# Konwencje

• Skrypty są opcjonalne, chyba że odwołują się do nich dokumentacja lub listy kontrolne wydań.
• Preferuj powierzchnie CLI, gdy istnieją (przykład: monitorowanie uwierzytelniania używa openclaw models status --check).
• Zakładaj, że skrypty są specyficzne dla hosta; przeczytaj je przed uruchomieniem na nowym komputerze.

# Skrypty monitorowania uwierzytelniania

Monitorowanie uwierzytelniania opisano w sekcji Uwierzytelnianie. Skrypty w katalogu scripts/ są opcjonalnymi dodatkami do przepływów pracy na telefonach z systemd/Termux.

# Pomocnik odczytu GitHub

Użyj scripts/gh-read, gdy chcesz, aby gh używał tokenu instalacji GitHub App do wywołań odczytu ograniczonych do repozytorium, pozostawiając zwykłe gh na Twoim osobistym loginie do działań zapisu.

Wymagane zmienne środowiskowe:

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Opcjonalne zmienne środowiskowe:

• OPENCLAW_GH_READ_INSTALLATION_ID, gdy chcesz pominąć wyszukiwanie instalacji na podstawie repozytorium
• OPENCLAW_GH_READ_PERMISSIONS jako rozdzielone przecinkami nadpisanie podzbioru uprawnień odczytu, o które należy poprosić

Kolejność rozpoznawania repozytorium:

• gh ... -R owner/repo
• GH_REPO
• git remote origin

Przykłady:

• scripts/gh-read pr view 123
• scripts/gh-read run list -R openclaw/openclaw
• scripts/gh-read api repos/openclaw/openclaw/pulls/123

# Podczas dodawania skryptów

• Skrypty powinny być wąsko ukierunkowane i udokumentowane.
• Dodaj krótki wpis w odpowiedniej dokumentacji (lub utwórz go, jeśli go brakuje).

# Powiązane

• Testowanie
• Testowanie na żywo