Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

Okres próbny agenta i powiązanie konta

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.

Sprawdź ten profil
flashdata auth status --json --non-interactive

Zachowaj 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.

Ukryty klucz short · terminal ludzki
flashdata auth login
flashdata auth status --json --non-interactive

2. 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.

Sprawdź dostępność · za darmo
flashdata discover --json --non-interactive
Uruchomienie tymczasowego dostępu
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Sprawdź 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.

GranicaCo sprawdzić
Kredyty / wygaśnięcieBieżą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.
Rejestracja3 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.
KonkursoweZachować 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.

Sprawdź bilans i koszt · bez zapytania
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Jedno wyszukiwanie · do pięciu wyników
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Sprawdź 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.

Sprawdź pozostałe saldo · wolne
flashdata account balance --json --non-interactive

4. 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.

Utwórz link do roszczenia, gdy właściciel jest gotowy
flashdata auth claim --json --non-interactive

Zatwierdzenie w przeglądarce

  1. Właściciel otwiera link i podpisuje się, lub tworzy nowe konto i weryfikuje e-mail. Nowy podpis ponownie zgłasza wniosek po weryfikacji.
  2. 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.
  3. 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.

Zapisz i zweryfikuj dostęp właściciela
flashdata auth finish --wait --timeout 10m --json --non-interactive
Następnie sprawdzić ze świeżego terminala · ten sam użytkownik OS i profil
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Potwierdź 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.

Oczekiwane pola · fragment odpowiedzi
{
  "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łoNastępna akcja
RejestrDla 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.
SzukajSprawdź trial-search poniżej. Timeout nie dowodzi, że praca nie została zaakceptowana; nie zmieniaj biegu ID, aby wymusić ponowną próbę.
Powiązanie stronJeś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.
PrzekazywaniePo 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 / utraconeW 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.
Sprawdź zapisane wyszukiwanie · nie ma nowego zapytania
flashdata runs show trial-search --json --non-interactive