Release and CI
Skrypty
scripts/ zawiera skrypty pomocnicze do lokalnych przepływów pracy i zadań operacyjnych. Używaj ich, gdy zadanie jest wyraźnie związane ze skryptem; w przeciwnym razie preferuj CLI.
Konwencje
- Skrypty są opcjonalne, chyba że odwołują się do nich dokumentacja lub listy kontrolne wydania.
- Preferuj interfejsy CLI, jeśli są dostępne (przykład:
openclaw models status --check). - Zakładaj, że skrypty są specyficzne dla hosta; przeczytaj je przed uruchomieniem na nowej maszynie.
Skrypty monitorowania uwierzytelniania
Ogólne uwierzytelnianie modeli opisano w sekcji Uwierzytelnianie. Poniższe skrypty stanowią oddzielny, opcjonalny system do monitorowania tokenu subskrypcji Claude Code CLI na zdalnym hoście bez interfejsu graficznego oraz ponownego uwierzytelniania za pomocą telefonu:
scripts/setup-auth-system.sh— jednorazowa konfiguracja: sprawdza bieżący stan uwierzytelniania, pomaga wygenerować długoterminowyclaude setup-tokeni wyświetla instrukcje instalacji dla systemd/Termux.scripts/claude-auth-status.sh [full|json|simple]— sprawdza stan uwierzytelniania Claude Code i OpenClaw.scripts/auth-monitor.sh— cyklicznie sprawdza stan i wysyła powiadomienie (za pomocą wysyłania OpenClaw i/lub ntfy.sh), gdy zbliża się termin wygaśnięcia tokenu. Zmienne środowiskowe:WARN_HOURS(domyślnie2),NOTIFY_PHONE,NOTIFY_NTFY. Uruchamiaj zgodnie z harmonogramem za pomocą dołączonych plikówscripts/systemd/openclaw-auth-monitor.{service,timer}(co 30 minut).scripts/mobile-reauth.sh— ponownie uruchamiaclaude setup-tokeni wyświetla adresy URL do otwarcia na telefonie; przeznaczony do użycia przez SSH z Termux.scripts/termux-quick-auth.sh,scripts/termux-auth-widget.sh,scripts/termux-sync-widget.sh— skrypty Termux:Widget, które łączą się z hostem przez SSH, wyświetlają wyskakujące powiadomienie o stanie i otwierają konsolę lub instrukcje ponownego uwierzytelnienia po wygaśnięciu uwierzytelniania.
Narzędzie pomocnicze do odczytu z GitHub
Użyj scripts/gh-read, gdy chcesz, aby gh używało tokenu instalacyjnego aplikacji GitHub do wywołań odczytu ograniczonych do repozytorium, pozostawiając zwykłe gh zalogowane na Twoim koncie osobistym do wykonywania operacji zapisu.
Wymagane zmienne środowiskowe:
OPENCLAW_GH_READ_APP_IDOPENCLAW_GH_READ_PRIVATE_KEY_FILE
Opcjonalne zmienne środowiskowe:
OPENCLAW_GH_READ_INSTALLATION_ID, jeśli chcesz pominąć wyszukiwanie instalacji na podstawie repozytoriumOPENCLAW_GH_READ_PERMISSIONSjako rozdzielone przecinkami zastąpienie podzbioru żądanych uprawnień do odczytu
Kolejność rozpoznawania repozytorium:
gh ... -R owner/repoGH_REPOgit remote origin
Przykłady:
scripts/gh-read pr view 123scripts/gh-read run list -R openclaw/openclawscripts/gh-read api repos/openclaw/openclaw/pulls/123
Podczas dodawania skryptów
- Skrypty powinny być ukierunkowane i udokumentowane.
- Dodaj krótki wpis w odpowiednim dokumencie (lub utwórz go, jeśli nie istnieje).