Переглянути документацію
Початок роботи
Спробуйте пошук Google перед реєстрацією, потім підключіть обліковий запис власника для збереження за допомогою одного профілю CLI.
На цій сторінці
1. Перевірити наявний доступ
Запустіть цю безкоштовну перевірку в середовищі вашого агента. Якщо data.accessVerified є true і Google Search дозволяється використовувати цей доступ і пропустити на крок 3. З не збереженого профілю, продовжуємо крок 2. Зменшення або блокування доступу за допомогою розділу відновлення нижче.
flashdata auth status --json --non-interactiveЗберігати той самий профіль
Звіти про роботу data.accessVerified: true, access: ready в data.identity.identityй google_search в data.identity.permittedSources.
Ці команди використовують профілі за замовчуванням і роботу в Bash або PowerShell. Для існуючого названого профілю або користувальницького державного каталогу, додайте те саме --profile NAME і --state-dir ABSOLUTE_PATH до кожного команди, в тому числі у свіжому терміналі.
FLASHDATA_API_KEY має пріоритет над збереженим ключем. Не задавайте цю змінну під час перевірки пробного доступу й передавання облікових даних цього профілю. Використовуйте того самого користувача ОС і зберігайте приватний каталог стану: він містить облікові дані, доказ реєстрації та історію запусків.
Огляд credentialProtection в auth status. Windows використовує DPAPI, macOS використовує Keychain, а безголовний Linux може використовуватися для користувача постійний достовірний файл. У магазині OS можна скористатися --credential-store.
Використовуйте наявний ключ власника замість
Людина в терміналі може імпортувати ключ через приховану підказку нижче і пропустити реєстрацію і претензії. Агенти повинні поставляти його на stdin з --api-key-stdin --non-interactive з їх секретного магазину; ніколи не кладуть ключ в аргументи або чат.
Якщо профіль вже має різний доступ, перевірте його перед використанням auth login --replace. Імпорт іншого ключа не є позовом. MCP OAuth також є окремим з'єднанням хостів.
flashdata auth login
flashdata auth status --json --non-interactive2. Почати право на право
Запуск discover першим. Перевірте data.onboardingAvailable і припуск в data.onboarding.trial. Якщо на борту є можливість запустити init один раз для Google Search. Сервер перевіряє відповідальність; CLI зберігає тимчасовий ключ без реєстрації або подання запиту.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveПеревірка реєстраційної квитанції
Випробувано ok: true, data.status: trial і google_search в data.connection.scopes. Читати далі data.connection.trialExpiresAt і data.startingAllowanceCredits. Ключ збережений локально, не друкується. Якщо data.currentBalanceAvailable є false, перезапустіть перевірку вільного балансу до запиту.
Якщо налаштування вже створеного доступу, повторно його використання. Для позначення першої реєстрації агента додайте --client codex --audience coding або --client openclaw --audience personal. Забезпечити точний вхід на птицю; етикетки не надають дозволу.
Тривалий припуск і ліміти
Запит еквівалентів, які постачають один і той самий початковий кредитний баланс; вони не залишилися запитами або незалежними квотами. Власник-тільки джерела, такі як YouTube Download не може витрачати тестові кредити.
| Ліміт | Що потрібно перевірити |
|---|---|
| Кредит / витривалість | Поточні за замовчуванням: 1 кредит за 72 години. Читання відкриття для надання гранту та терміну служби; отримання дає можливість викупу та надані джерела. |
| Реєстрація | 3 реєстрації на IP за 24 години; ліміт спільний для користувачів цієї IP-адреси. Глобальний ліміт пробних доступів також може призупинити нові реєстрації. |
| Конваптація | Зберігайте послідовну роботу: один елемент за партію і одну роботу. Перевірити подані ліміти перед поданням більше. |
3. Спробуйте один пошук
Перший перегляд. data.estimateAvailable, доступна ціна google_search в data.estimate.prices, і availableCredits покриття estimatedCredits. Стоп, якщо перевірте невдачу. Відправка на попередній перегляд безкоштовно, наступна команда подає один пошук.
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-interactiveПеревірте результат
Витратити ok: true і data.status: done. Читання назв, посилань та фрагментів з data.results[].organic та заряду від data.usage.credits. Ефективні органічні результати. Перед тим як претендувати, повторюючи це точне завдання з trial-search повертає його збережений результат. Зберігати профіль і стан, і зберігати необхідні результати.
flashdata account balance --json --non-interactive4. Зберігайте доступ до облікового запису власника
Якщо ви хочете продовжити або повторне використання. Коли власник готовий, запустіть його в оригінальний профіль. Поділитися тільки data.claimUrl і data.confirmationCode з ними; data.expiresAt дає термін дії.
Посилання триває хвилин 15, або доки не закінчиться процес. Створення посилання не затверджує доступ або купівлю кредитів.
flashdata auth claim --json --non-interactiveЗатвердження в браузері
- Власник відкриває посилання та підписи, або створює новий обліковий запис та перевіряє електронну пошту. Новий реєстр відновлює позов після перевірки.
- Перевірити рахунок, що відображається на сторінці претензії. Для іншого або нового власника використовуйте окрему браузерну сесію. У зареєстрованому рахунку є рахунок, який сплачує за пізніше запитів.
- Введіть вісім-цифровий код на цій сторінці, перевірте дозвіл на продукт і доступ до спільного доступу, потім затвердження. Власник здійснює реєстрацію, юридичне прийняття, перевірка електронної пошти та згоду.
Оздоблення в оригінальному терміналі
Після затвердження запустіть finish в оригінальному профілі в межах 24 годин. CLI зберігає ключ власника, виправляє його в свіжий процес і визнає установку. Немає ключа, що скопіюється з браузера.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveПідтвердити власника та баланс
У auth status перевірте призначене accountId і надані обсяги, плюс поля нижче. Ознайомитися зі свіжим балансом окремо; майбутні запити проведіть спільні кредити власника. Невикористані тимчасові кредити не передають. Новий обліковий запис, що відповідає нормам підпису, не вимагає додаткового підтвердження.
Здійснення зміни вексельного рахунку. Для нового завдання під власником виберіть новий забіг ID. Відновлення тестового забігу ID Повернутися run_account_mismatch без подання іншої запиту; не передається, що запускається до власника.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Оберіть дозвіл на товар
Каталог дозволів HTTP розділяє trialEligible та ownerAllowed. До першої реєстрації запитуйте лише джерела, потрібні для завдання. requestedScopes містить запитані дозволи, а scopes — поточний доступ ключа. Нові продукти потребують явного надання дозволу.
Схвалення дозволяє використовувати спільний баланс власника, зокрема придбані кредити. Обмеження джерел не встановлюють ліміт витрат для окремого агента. MCP OAuth — окреме підключення, яке не прив’язує цей профіль CLI до облікового запису.
Тільки потрібно YouTube Download?
Імпортуйте ключ власника з дозволом youtube_download, а потім налаштуйте цільове сховище. Download не використовує тимчасові пробні кредити.
CLI 1.2.1 все ще вимагає тестового джерела для init. Для завантаження на борту перед вивіскою використовуйте HTTP претензійний потік у auth.md. Не додавати необґрунтоване джерело даних, щоб обійти обмеження клієнтів.
Сприяти припинному потоку
| Що припинили | Попередня дія |
|---|---|
| Зареєструватися | Для 429 чекатиме Retry-After. Для втраченого відгуку, птиця init з тим же профільом, доказом і точним входом. Не переключайте IP-адресу або запустіть тестову заміну. |
| Пошук | Огляд trial-search нижче. Час роботи не доводить, що не було прийнято, не змінюючи пробіг ID, щоб змусити птицю. |
| Клайм посилання | Якщо посилання прострочене, але пробний доступ ще діє, створіть нове посилання в тому самому профілі, коли власник буде готовий. Перед схваленням перевірте обліковий запис, у якому відкрито сеанс. |
| Зручності | Після затвердження, перезапуск auth finish в оригінальному профілі в межах 24 годин. Попереднє затвердження, переривається очікування або визнання не вимагає нової реєстрації. |
| Очікуваний / втрачений стан | Якщо пробний доступ чи передача ключа прострочені або приватний каталог стану втрачено, підключіться повторно зі схвалення власника або імпортуйте його ключ. |
flashdata runs show trial-search --json --non-interactive