Обзор документации
Начало работы
Попробуйте выполнить поиск 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 и --state-dir ABSOLUTE_PATH к каждой команде, включая те, которые находятся в новом терминале.
FLASHDATA_API_KEY имеет приоритет над сохранённым ключом. Не задавайте эту переменную при проверке пробного доступа и передачи учётных данных для этого профиля. Используйте того же пользователя ОС и сохраняйте приватный каталог состояния: он содержит учётные данные, доказательство регистрации и историю запусков.
Проверьте credentialProtection в auth status. Windows использует DPAPI, macOS использует Keychain, а безголовый Linux может использовать файл учетных данных только для владельца. Доступный магазин OS может потребоваться с --credential-store os.
Вместо этого используйте ключ владельца
Человек в терминале может импортировать ключ через скрытую подсказку ниже и пропустить регистрацию проб и претензии. Агенты должны поставлять его на 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