Explorar documentación
Primeros pasos
Prueba una búsqueda en Google antes de registrarte. Después, vincula una cuenta para seguir usando el mismo perfil de la CLI.
En esta página
1. Comprueba el acceso existente
Ejecuta esta comprobación gratuita en el entorno del agente. Si data.accessVerified es true y Google Search está permitido, reutiliza ese acceso y pasa al paso 3. Si no hay un perfil guardado, sigue con el paso 2. Para reanudar un acceso pendiente o bloqueado, consulta la sección de recuperación.
flashdata auth status --json --non-interactiveConserva el mismo perfil
El acceso válido muestra data.accessVerified: true, access: ready en data.identity.identity y google_search en data.identity.permittedSources.
Estos comandos usan el perfil predeterminado y funcionan en Bash y PowerShell. Si utilizas un perfil con nombre o un directorio de estado propio, añade los mismos --profile NAME y --state-dir ABSOLUTE_PATH a todos los comandos, también en una terminal nueva.
FLASHDATA_API_KEY tiene prioridad sobre la clave guardada. Deja esta variable sin definir al probar el acceso de prueba y la transferencia de credenciales de este perfil. Usa el mismo usuario del sistema y conserva el directorio privado de estado: contiene las credenciales, la prueba de registro y el historial de ejecuciones.
Consulta credentialProtection en auth status. Windows usa DPAPI; macOS, Keychain. En Linux sin interfaz gráfica, puede usarse un archivo de credenciales accesible solo por su propietario. Para exigir un almacén del sistema disponible, usa --credential-store os.
Usa una clave existente del titular
Una persona puede importar una clave mediante la entrada oculta que aparece abajo y omitir el registro de prueba y la vinculación. Los agentes deben leerla de su almacén de secretos y enviarla por stdin con --api-key-stdin --non-interactive; nunca deben incluirla en argumentos ni en el chat.
Si el perfil ya contiene otro acceso, revísalo antes de usar auth login --replace. Importar otra clave no equivale a completar la vinculación. MCP OAuth también crea una conexión independiente.
flashdata auth login
flashdata auth status --json --non-interactive2. Inicia una única prueba si cumples los requisitos
Ejecuta discover primero. Consulta data.onboardingAvailable y la asignación de data.onboarding.trial. Si el registro está disponible, ejecuta init una vez para Google Search. El servidor comprueba los requisitos; la CLI guarda la clave temporal sin abrir el registro de usuario ni enviar consultas.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveRevisa el comprobante de registro
Espera ok: true, data.status: trial y google_search en data.connection.scopes. Consulta data.connection.trialExpiresAt y data.startingAllowanceCredits. La clave se guarda localmente y no se muestra. Si data.currentBalanceAvailable es false, repite la comprobación gratuita del saldo antes de consultar.
Si la configuración ya creó un acceso, reutilízalo. Para etiquetar el primer registro del agente, añade --client codex --audience coding o --client openclaw --audience personal. En los reintentos, conserva la entrada exacta; las etiquetas no conceden permisos.
Créditos y límites de la prueba
Las equivalencias de solicitudes comparten el mismo saldo inicial; no representan solicitudes restantes ni cuotas independientes. Las fuentes que exigen una cuenta de titular, como YouTube Download, no pueden usar créditos de prueba.
| Límite | Qué comprobar |
|---|---|
| Créditos y caducidad | Valores predeterminados actuales: 1 crédito durante 72 horas. Consulta discovery para conocer la asignación y la duración; el comprobante indica la caducidad y las fuentes concedidas. |
| Registro | 3 registros por IP cada 24 horas, compartidos por quienes usan esa IP. El límite global de pruebas también puede detener nuevos registros. |
| Concurrencia | Ejecuta las tareas de prueba en secuencia: un elemento por lote y un trabajo pendiente. Revisa los límites devueltos antes de enviar más. |
3. Prueba una búsqueda
Previsualiza primero. Exige data.estimateAvailable, un precio disponible para google_search en data.estimate.prices y un availableCredits suficiente para cubrir estimatedCredits. Detente si falla alguna comprobación. La previsualización es gratuita; el siguiente comando envía una búsqueda.
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-interactiveComprueba el resultado
Espera ok: true y data.status: done. Consulta los títulos, enlaces y fragmentos en data.results[].organic, y el cargo en data.usage.credits. Un resultado organic vacío es válido. Antes de vincular la prueba, repetir esta tarea exacta con trial-search devuelve el resultado guardado. Conserva el perfil, el estado y los resultados de prueba que necesites.
flashdata account balance --json --non-interactive4. Conserva el acceso con una cuenta de titular
Vincula la prueba antes de que caduque para continuar usándola o programar tareas recurrentes. Cuando el titular esté listo, ejecuta este comando con el perfil original. Comparte únicamente data.claimUrl y data.confirmationCode; data.expiresAt indica el plazo.
El enlace dura 15 minutos, o hasta que caduque la prueba si ocurre antes. Crear el enlace no aprueba el acceso ni compra créditos.
flashdata auth claim --json --non-interactiveAprobar en el navegador
- El titular abre el enlace e inicia sesión, o crea una cuenta y verifica su correo. Si crea una cuenta, la vinculación se reanuda automáticamente tras la verificación.
- Comprueba la cuenta que aparece en la página de vinculación. Para usar otra cuenta o crear una nueva, abre una sesión de navegador independiente. La cuenta conectada pagará las solicitudes posteriores.
- Introduce el código de ocho dígitos en esa página, revisa los permisos de productos y el acceso al saldo compartido, y aprueba si todo es correcto. La persona titular completa el registro, la aceptación legal, la verificación del correo y el consentimiento.
Termina en la terminal original
Tras la aprobación, ejecuta finish con el perfil original en un plazo de 24 horas. La CLI guarda la clave del titular, la verifica en un proceso nuevo y confirma su instalación. No se copia ninguna clave desde el navegador.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveConfirma la cuenta y el saldo
En auth status, verifica el accountId previsto y los permisos concedidos, junto con los campos siguientes. Consulta el saldo actualizado por separado; las solicitudes futuras usan los créditos compartidos del titular. Los créditos temporales sin usar no se transfieren. Una cuenta nueva sigue las condiciones normales del registro; vincular una prueba no concede créditos adicionales de registro.
La vinculación cambia la cuenta facturada. Para una tarea nueva con la cuenta del titular, elige un nuevo ID de ejecución. Reutilizar un ID de prueba devuelve run_account_mismatch sin enviar otra consulta; no transfiere esa ejecución al titular.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Elige los permisos de productos
El catálogo de permisos HTTP distingue trialEligible de ownerAllowed. Antes del primer registro, solicita solo las fuentes necesarias para tu tarea. requestedScopes contiene los permisos solicitados; scopes, el acceso actual de la clave. Los productos nuevos requieren una concesión explícita.
La aprobación permite usar el saldo compartido del titular, incluidos los créditos comprados. Restringir las fuentes no establece un límite de gasto por agente. MCP OAuth crea una conexión independiente y no vincula este perfil de la CLI.
¿Solo necesitas YouTube Download?
Importa una clave del titular con permiso youtube_download y configura el almacenamiento de destino. Download no usa créditos temporales de prueba.
La CLI 1.2.1 aún exige una fuente apta para pruebas al ejecutar init. Para configurar solo Download antes de crear una cuenta, usa el flujo de vinculación HTTP de auth.md. No añadas una fuente de prueba ajena a tu tarea para eludir esta restricción del cliente.
Reanuda un flujo detenido
| Paso detenido | Siguiente acción |
|---|---|
| Registro | Ante un 429, respeta Retry-After. Si se pierde la respuesta, repite init con el mismo perfil, la misma prueba de registro y la entrada exacta. Conserva el estado existente; no cambies de IP ni crees otra prueba. |
| Búsqueda | Inspecciona trial-search con el comando de abajo. Un tiempo de espera agotado no demuestra que el trabajo no se aceptó; no cambies el ID de ejecución para forzar otro intento. |
| Enlace de vinculación | Si el enlace caducó pero la prueba sigue vigente, crea otro enlace con el mismo perfil cuando el titular esté listo. Verifica la cuenta conectada antes de aprobar. |
| Transferencia de credenciales | Tras la aprobación, vuelve a ejecutar auth finish con el perfil original en un plazo de 24 horas. Una aprobación pendiente, una espera interrumpida o una confirmación perdida no requieren un registro nuevo. |
| Acceso caducado o estado perdido | Si la prueba o la transferencia caducaron, o se perdió el directorio privado de estado, usa una reconexión aprobada por el titular o importa su clave. |
flashdata runs show trial-search --json --non-interactive