Saltar al contenido
ES
Obtener clave API
Explorar documentación

Integraciones

OpenClaw

Añade herramientas de Google Search y YouTube a tu agente OpenClaw para investigar y crear informes periódicos.

En esta página

Antes de empezar

Comprueba que OpenClaw esté instalado y funcione. Esta conexión MCP remota usa OAuth para Google Search, YouTube Search, Metadata y Transcripts. Puedes crear una cuenta de FlashData al iniciar sesión.

1. Añade el servidor MCP

Ejecuta este comando en el equipo y con el perfil que usa tu gateway de OpenClaw. Guarda la configuración; los pasos siguientes verifican el inicio de sesión y el uso de las herramientas. Mantén el mismo perfil en todos los comandos de esta página.

Bash / PowerShell 7
openclaw mcp set flashdata '{
  "url": "https://data.flashdata.dev/mcp",
  "transport": "streamable-http",
  "auth": "oauth",
  "oauth": {
    "scope": "mcp:research",
    "clientMetadataUrl": "https://api.flashdata.dev/oauth/clients/openclaw.json"
  }
}'

2. Inicia sesión

Ejecuta el comando de inicio de sesión. En el navegador, inicia sesión o crea y verifica una cuenta, y autoriza el acceso. Espera a que la terminal confirme la conexión. Las consultas usan los créditos de esa cuenta.

Iniciar sesión
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe

Comprueba la conexión gratis

Abre una nueva conversación en la interfaz Control UI o en tu canal de chat conectado. Envía este mensaje y comprueba que ambas llamadas funcionan. La comprobación del registro MCP por sí sola no confirma que esta conversación pueda usar las herramientas.

Pega este mensaje en tu agente
Usa la conexión MCP flashdata.
Llama a get_balance con {} y a get_pricing con {"source":"google_search","request_count":1}.
Indica los créditos disponibles y el precio estimado. No ejecutes ninguna búsqueda.

3. Ejecuta tu primera tarea

Envía este mensaje al agente conectado. Las comprobaciones son gratuitas; la búsqueda consume créditos.

Primera tarea
Usa el servidor MCP flashdata. Consulta mi saldo y el precio de una búsqueda de Google.
Si hay créditos suficientes, llama a google_search una sola vez con query "battery recycling research", num 5 y mode "realtime".
Dame un informe breve con los títulos, las URL y los extractos de las fuentes.
Cita las fuentes e indica los créditos realmente utilizados. Detente al terminar esta tarea.

Comprueba el resultado

Comprueba que la llamada a google_search termina con status: done, devuelve enlaces en results[].organic y permite responder a partir de esas fuentes. El consumo se indica en usage.credits; no es el número de resultados. Si no hay resultados, el agente debe indicarlo.

Tareas que puedes pedir

Esta conexión OAuth da acceso a las herramientas de investigación. Para YouTube Download, usa la API o la CLI con una clave API del titular y un destino de almacenamiento.

TareaHerramienta MCP
Buscar fuentes para responder o implementar una funcióngoogle_search
Buscar vídeos relevantes en YouTubeyoutube_search
Leer títulos de vídeo, canales y metadatosyoutube_metadata
Obtener la transcripción de un vídeo para resumirloyoutube_transcript
Consultar el saldo y el coste de una solicitudget_balance · get_pricing

Reutiliza el acceso en tareas recurrentes

Usa el perfil y el agente de OpenClaw con los que completaste la primera tarea. Las tareas programadas del gateway deben usar la misma conexión MCP y los mismos permisos de herramientas que tu chat.

Comprueba el acceso guardado

Ejecuta esta comprobación gratuita en una nueva sesión, dentro del entorno donde se ejecutará la tarea programada. Ambas llamadas deben completarse sin errores y sin volver a iniciar sesión en el navegador.

Comprobar la reutilización
Reutiliza la conexión MCP flashdata existente.
Llama a get_balance con {} y a get_pricing con {"source":"google_search","request_count":1}.
Indica si ambas llamadas se completaron sin errores. No busques ni crees un nuevo acceso.

Programar la tarea recurrente

En el programador de tu agente, elige la hora y la zona horaria; por ejemplo, cada día a las 09:00 en Asia/Shanghai. Usa el texto siguiente como instrucciones de la tarea. Ejecútala una vez en ese entorno y revisa el informe guardado antes de activar la repetición.

Instrucciones de la tarea
Reutiliza la conexión MCP flashdata existente. Consulta get_balance y get_pricing para una búsqueda de Google.
Si tienes permiso y créditos suficientes, ejecuta google_search una sola vez para "battery recycling research" con num 5 y mode "realtime".
Guarda un informe con fecha, URL de las fuentes, extractos y créditos realmente utilizados.
Detente si el acceso está revocado o faltan créditos; respeta Retry-After. No crees una prueba ni solicites una nueva autorización. No repitas una solicitud cuyo resultado se desconoce.

Almacenamiento y renovación de credenciales

Esta configuración usa la conexión OAuth compartida de quien administra OpenClaw. Los participantes autorizados del chat y las tareas programadas usan esa misma cuenta de FlashData y su saldo. No se crea una cuenta distinta para cada participante.

El cliente renueva los tokens de acceso OAuth, válidos durante una hora, mediante tokens de renovación rotatorios. Vuelve a conectar cuando la autorización de 90 días caduque o se revoque. Cada instalación guarda sus propios tokens; no compartas archivos de tokens de renovación entre clientes.

Revocar o volver a conectar

  1. Pausa las tareas programadas y revoca la conexión OAuth correspondiente en FlashData: Settings → Connected apps.
  2. Pide al agente que llame a get_balance una sola vez con la conexión guardada. La autenticación debe fallar o pedir que vuelvas a conectar. No autorices un nuevo inicio de sesión durante esta comprobación.
  3. Elimina las credenciales OAuth locales con el comando siguiente. Para volver a conectar más adelante, repite el paso 2 con la aprobación del titular y ejecuta la comprobación gratuita.
Eliminar credenciales OAuth locales
openclaw mcp logout flashdata

Más opciones de configuración

Añade skills a tu conexión MCP, o elige el acceso por CLI o un servidor MCP local.

Añadir la skill MCP

La skill flashdata-mcp enseña a tu agente a usar las herramientas conectadas. Reutiliza la conexión anterior.

Con Node.js 22.20+ y npm, ejecuta estos comandos en el espacio de trabajo activo de OpenClaw. La skill completa se guarda en skills/flashdata-mcp. Abre una nueva conversación y pide que use flashdata-mcp.

En tu espacio de trabajo de OpenClaw
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible

Usar skills de la CLI o iniciar una prueba

Instala la CLI de FlashData v1.2.1 y ejecuta los comandos desde el espacio de trabajo activo de OpenClaw. Elige una pestaña de acceso. Los ejemplos usan el perfil predeterminado de la CLI, separado de OAuth para MCP. Si ya usas --profile y --state-dir personalizados, conserva esos valores.

Instala las dos skills siguientes con Node.js 22.20+ y npm. Después, abre una nueva conversación de OpenClaw. El comando setup de la CLI nativa no admite OpenClaw como destino.

Instalar las skills para usar la CLI
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible

Pega una clave con permiso google_search cuando el comando la solicite; la entrada no se muestra en pantalla. Para importarla sin interacción, pásala desde tu gestor de secretos a la entrada estándar de flashdata auth login --api-key-stdin --non-interactive.

1. Importa y verifica la clave
flashdata auth login
flashdata auth status --json --non-interactive
2. Saldo y coste · sin buscar
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# Continúa solo si accessVerified y estimateAvailable son true,
# google_search está permitido y availableCredits cubre estimatedCredits.
3. Ejecuta una vez → ./openclaw-first-search.json
flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive

# Lee el archivo guardado: status, results[].organic, usage.credits.
# El JSON de la terminal indica la ruta de salida; conserva el ID de ejecución para recuperar el resultado.

Usar MCP local con una clave API

Necesitas Node.js 22.18+, npm y una clave API con permiso google_search para la primera tarea. Esta opción ejecuta @flashdata-dev/mcp 0.2.0. No lee la clave guardada por la CLI de FlashData ni los tokens OAuth de MCP.

Define la clave en el entorno donde se ejecuta el gateway. El ejemplo siguiente sirve si lo inicias desde esa terminal. Si usas un servicio o contenedor, configura FLASHDATA_API_KEY mediante sus secretos o variables de entorno y reinícialo. Exportar la clave en otra terminal no actualiza un servicio que ya está en ejecución.

Después de configurar el servidor, ejecuta el mensaje de comprobación gratuita en una nueva sesión del agente. Cuando ambas llamadas funcionen, usa el mensaje de la primera tarea. El acceso con clave API no requiere mcp login.

1. Define la clave sin mostrarla
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
2. Registra y comprueba el servidor en el perfil del gateway
openclaw mcp set flashdata '{
  "command": "npx",
  "args": [
    "--yes",
    "--package=@flashdata-dev/[email protected]",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe

Solución de problemas

ProblemaQué hacer
Lista vacíaEjecuta openclaw mcp doctor flashdata --probe. Revisa el perfil del gateway y los permisos de herramientas del agente. Después, abre una nueva conversación.
Falta la skillEjecuta openclaw skills list --eligible y openclaw skills check con el perfil activo. Revisa la carpeta skills/ del espacio de trabajo y la lista de skills permitidas.
invalid_client / callbackCompara la configuración con el paso 1. Completa la autorización en un navegador que pueda acceder a la URL de retorno del equipo que inició la conexión.
401Comprueba si la conexión o la clave ha caducado o está revocada. Para OAuth, vuelve a iniciar sesión con la aprobación del titular. Para la CLI, ejecuta flashdata auth status. Añadir créditos no corrige la autenticación.
403Comprueba el permiso de la fuente solicitada. OAuth de investigación no incluye YouTube Download; usa la configuración con clave API de ese producto. Corrige el permiso antes de volver a intentarlo.
402Consulta get_balance o flashdata account balance. Añade créditos en Billing o detén la tarea. Volver a iniciar sesión no añade créditos.
429Espera el tiempo indicado en Retry-After y reduce la concurrencia. Conserva el perfil y la prueba de registro actuales. No crees pruebas nuevas para sustituir la existente.
MCP no lee la claveDefine FLASHDATA_API_KEY en el entorno donde se inicia el proceso del cliente y reinícialo. Una clave guardada con flashdata auth login no se exporta automáticamente al MCP local.
El archivo ya existeLee ./openclaw-first-search.json. Para exportar de nuevo el resultado guardado, usa flashdata runs show openclaw-first-search-001 --result --output openclaw-first-search-copy.json con el perfil original. Usa un ID de ejecución nuevo solo si quieres hacer otra búsqueda.
Falla la tarea periódicaEjecuta la comprobación gratuita de reutilización dentro de ese entorno. Usa el mismo usuario del sistema, perfil del cliente, almacén de credenciales y permisos de herramientas.
Resultado inciertoSi se agota el tiempo de espera o desconoces el resultado, conserva el ID de la solicitud o del trabajo y consulta History antes de volver a enviarla. Usa get_result con los identificadores de continuación recibidos.

Verificación de OAuth

El inicio de sesión OAuth, la URL de retorno, las credenciales guardadas, una consulta gratuita de precios, la renovación y la revocación se verificaron en Windows con OpenClaw 2026.10.5 el 2026-10-21. Esa prueba no verificó consultas de pago ni ejecuciones programadas. Las instrucciones de configuración se contrastaron con la documentación del cliente el 2026-11-05.