Przeglądaj dokumentację
Pierwsze kroki
Spróbuj wyszukać Google przed rejestracją, a następnie podłącz konto właściciela, aby utrzymać przy użyciu tego samego profilu CLI.
Na tej stronie
1. Sprawdź istniejący dostęp
Sprawdź to w środowisku twojego agenta. Jeśli data.accessVerified en true oraz Google Search jest dozwolone, ponowne użycie, że dostęp i przejść do kroku 3. Bez zapisanego profilu, kontynuuj krok 2. Wznowienie dostępu oczekującego lub zablokowanego za pomocą poniższego punktu odzyskiwania.
flashdata auth status --json --non-interactiveZachowaj ten sam profil
Raporty o dostępie roboczym data.accessVerified: true, access: ready w data.identity.identity oraz google_search w data.identity.permittedSources.
Polecenia te używają domyślnego profilu i działają w Bash lub PowerShell. W przypadku istniejącego profilu lub katalogu stanu niestandardowego należy dołączyć tę samą nazwę --profile oraz --state-dir ABSOLUTE_PATH do każdego polecenia, w tym w nowym terminalu.
FLASHDATA_API_KEY ma pierwszeństwo przed zapisanym kluczem. Nie ustawiaj tej zmiennej podczas testowania dostępu próbnego i przekazywania danych uwierzytelniających tego profilu. Używaj tego samego użytkownika systemu i zachowaj prywatny katalog stanu; zawiera dane uwierzytelniające, dowód rejestracji i historię uruchomień.
Sprawdzić credentialProtection w auth status. Windows używa DPAPI, macOS używa Keychain, a bezgłowy Linux może używać tylko własnego pliku. Dostępny sklep OS może być wymagany z --credential-store os.
Użyj istniejącego klucza właściciela
Osoba w terminalu może zaimportować klucz przez ukryty sygnał poniżej i pomiń rejestrację próbną i roszczenia. Agenci powinni dostarczyć go na stdin z --api-key-stdin --non-interactive ze swojego tajnego sklepu; nigdy nie umieszczać klucza w argumentach lub czacie.
Jeśli profil posiada już inny dostęp, należy go przejrzeć przed użyciem auth login --replace. Importowanie innego klucza nie jest obowiązkiem przekazania roszczenia. MCP OAuth jest również oddzielnym połączeniem hosta.
flashdata auth login
flashdata auth status --json --non-interactive2. Rozpocząć jeden kwalifikujący się proces
Uruchom najpierw discover. Sprawdź data.onboardingAvailable i zasiłek w data.onboarding.trial. Jeśli jest dostępny, uruchom init raz dla Google Search. Serwer sprawdza kwalifikowalność; CLI zapisuje tymczasowy klucz bez otwierania rejestracji lub składania zapytania.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveSprawdź potwierdzenie rejestracji
Oczekuj ok: true, data.status: trial i google_search w data.connection.scopes. Przeczytaj data.connection.trialExpiresAt i data.startingAllowanceCredits. Klucz jest zapisany lokalnie, a nie drukowany. Jeśli data.currentBalanceAvailable jest false, przed zapytaniem należy ponownie uruchomić bezpłatne sprawdzenie salda.
Jeśli konfiguracja już stworzyła dostęp, użyj go ponownie. Aby oznaczyć pierwszą rejestrację agenta, należy dodać --client codex --audience coding lub --client openclaw --audience personal. Utrzymanie dokładnego wejścia na powtórkę; etykiety nie przyznają uprawnień.
Dodatek na badania i limity
Ekwiwalenty wniosków dzielą ten sam początkowy bilans kredytowy; nie są to pozostałe wnioski ani niezależne kwoty. Tylko właściciele źródeł, takich jak YouTube Download, nie mogą wydawać kredytów próbnych.
| Granica | Co sprawdzić |
|---|---|
| Kredyty / wygaśnięcie | Bieżące niewykonanie zobowiązania: kredyt 1 dla godzin 72. Odczytaj odkrycie dotacji i okresu jej trwania; pokwitowanie daje wygaśnięcie i przyznane źródła. |
| Rejestracja | 3 rejestracje na IP na 24 godziny, udostępniane przez użytkowników tego IP. Globalny limit próbny może również wstrzymać nowe rejestracje. |
| Konkursowe | Zachować pracę próbną sekwencyjną: jeden element na partię i jeden w toku pracy. Sprawdź zwrócone limity przed przesłaniem więcej. |
3. Spróbuj jednego wyszukiwania
Podgląd pierwszy. Wymagane data.estimateAvailable, dostępna cena google_search w data.estimate.prices i availableCredits na pokrycie estimatedCredits. Zatrzymaj się, jeśli czek nie wypali. Podgląd jest darmowy; następne polecenie przedstawia jedno wyszukiwanie.
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactiveSprawdź wynik
Oczekuj ok: true i data.status: done. Czytaj tytuły, linki i snippety z data.results[].organic, a opłata z data.usage.credits. Pusty wynik organiczny jest ważny. Przed twierdzeniem, powtarzając to dokładne zadanie z trial-search zwraca zapisany wynik. Zachowaj profil i stan, i zachować wszelkie wyniki badań, których potrzebujesz.
flashdata account balance --json --non-interactive4. Zachować dostęp do konta właściciela
Zaskarżyć przed zakończeniem procesu, jeśli chcesz kontynuować lub ponownie używać. Kiedy właściciel jest gotowy, uruchom to w oryginalnym profilu. Podziel się tylko data.claimUrl i data.confirmationCode z nimi; data.expiresAt podaje termin.
Link trwa 15 minut, lub do czasu wygaśnięcia procesu, jeśli wcześniej. Tworzenie odnośnika nie zatwierdza kredytów dostępu lub zakupu.
flashdata auth claim --json --non-interactiveZatwierdzenie w przeglądarce
- Właściciel otwiera link i podpisuje się, lub tworzy nowe konto i weryfikuje e-mail. Nowy podpis ponownie zgłasza wniosek po weryfikacji.
- Sprawdź konto pokazane na stronie roszczenia. Dla innego lub nowego właściciela, użyj oddzielnej sesji przeglądarki. Konto signed- na koncie jest to konto, które będzie płacić za późniejsze wnioski.
- Wprowadź ośmiocyfrowy kod na tej stronie, przejrzyj uprawnienia do produktów i dostęp do bilansu, a następnie zatwierdź. Właściciel zajmuje się rejestrowaniem, akceptacją prawną, weryfikacją e-mailem i zgodą.
Zakończ w oryginalnym terminalu
Po zatwierdzeniu, uruchomić finish w oryginalnym profilu w obrębie 24 godzin. CLI zapisuje klucz właściciela, weryfikuje go w nowym procesie i uznaje instalację. Żaden klucz nie jest kopiowany z przeglądarki.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactivePotwierdź właściciela i saldo
W auth status zweryfikuj zamierzony accountId i przyznaj zakresy, plus pola poniżej. Odczyt świeżej równowagi oddzielnie; przyszłe wnioski wydają wspólne kredyty właściciela. Niewykorzystane tymczasowe kredyty nie są przenoszone. Nowe konto jest zgodne ze zwykłą kwalifikacją do rejestracji; twierdzenie nie dodaje dodatkowej dotacji do rejestracji.
Twierdzenie zmienia rachunek. Dla nowego zadania pod właścicielem, wybierz nowy bieg ID. Ponowne użycie przebiegu próbnego ID zwraca run_account_mismatch bez składania kolejnego zapytania; nie przenosi się go do właściciela.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Wybierz uprawnienia do produktów
Katalog uprawnień HTTP rozróżnia trialEligible i ownerAllowed. Przed pierwszą rejestracją poproś tylko o źródła potrzebne do zadania. requestedScopes zawiera żądane uprawnienia, a scopes określa bieżący dostęp klucza. Nowe produkty wymagają wyraźnego przyznania uprawnień.
Zatwierdzenie umożliwia korzystanie ze wspólnego salda właściciela, w tym zakupionych kredytów. Ograniczenia źródeł nie ustanawiają limitu wydatków na agenta. MCP OAuth to oddzielne połączenie i nie wiąże tego profilu CLI z kontem.
Potrzebujesz tylko YouTube Download?
Użyj klucza właściciela za pozwoleniem youtube_download, zaimportuj go, a następnie skonfiguruj miejsce przeznaczenia. Pobieranie nie wykorzystuje tymczasowych kredytów próbnych.
CLI 1.2.1 nadal wymaga źródła kwalifikowanego do badania dla init. Do pobrania - tylko na pokładzie przed rejestracją, należy użyć przepływu reklamacji HTTP w auth.md. Nie dodawaj niepowiązanego źródła prób tylko po to, by obejść to ograniczenie klientów.
Wznowić zatrzymany przepływ
| Co się zatrzymało | Następna akcja |
|---|---|
| Rejestr | Dla 429, czekać na Retry-After. Aby uzyskać utraconą odpowiedź, ponownie wypróbuj init z tym samym profilem, dowodem i dokładnym wejściem. Zachować istniejący stan; nie przełączać IP ani nie rozpoczynać próby zastępczej. |
| Szukaj | Sprawdź trial-search poniżej. Timeout nie dowodzi, że praca nie została zaakceptowana; nie zmieniaj biegu ID, aby wymusić ponowną próbę. |
| Powiązanie stron | Jeśli link wygasł, ale proces jest ważny, utworzyć nowy link w tym samym profilu, gdy właściciel jest gotowy. Sprawdzić podpis właściciela przed zatwierdzeniem. |
| Przekazywanie | Po zatwierdzeniu, ponownie uruchomić auth finish w oryginalnym profilu w ciągu 24 godzin. W oczekiwaniu na zatwierdzenie, przerwa w czekaniu lub utracone potwierdzenie nie wymaga nowej rejestracji. |
| Wygasłe / utracone | W przypadku przeterminowanego procesu lub przekazania, lub utraconego prywatnego katalogu państwowego, należy użyć zatwierdzonego przez właściciela ponownego połączenia lub zaimportować klucz właściciela. |
flashdata runs show trial-search --json --non-interactive