# OpenClaw

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

Referencia canónica: https://flashdata.dev/es/docs/integrations/openclaw
Revisado: 2026-11-05 por FlashData

<a id="choose"></a>

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

- [Usar skills de la CLI o iniciar una prueba](https://flashdata.dev/es/docs/integrations/openclaw/reference.md#cli)
- [Instalar OpenClaw](https://docs.openclaw.ai/start/getting-started)

<a id="setup"></a>

## 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

```bash
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"
  }
}'
```


<a id="oauth"></a>

## 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

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


<a id="connection-check"></a>

### 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

```text
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.
```


<a id="first-task"></a>

## 3. Ejecuta tu primera tarea

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

### Primera tarea

```text
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.
```


<a id="result"></a>

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

- [Ver el historial de solicitudes](https://flashdata.dev/app/jobs)

<a id="tools"></a>

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

| Tarea | Herramienta MCP |
| --- | --- |
| Buscar fuentes para responder o implementar una función | google_search |
| Buscar vídeos relevantes en YouTube | youtube_search |
| Leer títulos de vídeo, canales y metadatos | youtube_metadata |
| Obtener la transcripción de un vídeo para resumirlo | youtube_transcript |
| Consultar el saldo y el coste de una solicitud | get_balance · get_pricing |

- [Herramientas y esquemas MCP](https://flashdata.dev/es/docs/mcp/reference.md)
- [Configurar YouTube Download](https://flashdata.dev/es/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

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


<a id="reuse-check"></a>

### 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

```text
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.
```


<a id="schedule"></a>

### 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

```text
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.
```

- [Guía de tareas recurrentes](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md)
- [Programación y recuperación con la CLI](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

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


<a id="revoke"></a>

### 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

```bash
openclaw mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

## 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 id="skills"></a>

### 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

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible
```

- [Instalar la CLI](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#install)
- [Leer la skill MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Actualizar o eliminar skills](https://flashdata.dev/es/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

### 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

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible
```

#### Clave API existente

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

```bash
flashdata auth login
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


#### Acceso guardado

Reutiliza tu clave o prueba existente. Si FLASHDATA_API_KEY está definida, tiene prioridad sobre la clave guardada. Comprueba la cuenta que muestra flashdata auth status.

##### 1. Verifica el acceso guardado

```bash
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


#### Solicitar una prueba

Reutiliza una prueba existente o regístrala una sola vez si cumples los requisitos. Si ha caducado, se ha agotado o está revocada, recupérala o vincúlala a tu cuenta. Antes de programar tareas con la CLI, vincula la prueba y confirma recurringAllowed: true en flashdata auth status.

##### 1. Configura y verifica la prueba

```bash
flashdata init --name "OpenClaw research" --client openclaw --audience personal --scopes google_search --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


- [Descargar la CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalar la CLI](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#install)
- [Recuperar un resultado guardado](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#recover)
- [Vincular la prueba antes de programar tareas](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

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

#### Bash

##### 1. Define la clave sin mostrarla

```bash
# 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

```bash
openclaw mcp set flashdata '{
  "command": "npx",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


#### PowerShell 7 (Windows)

##### 1. Define la clave sin mostrarla

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

##### 2. Registra y comprueba el servidor en el perfil del gateway

```powershell
openclaw mcp set flashdata '{
  "command": "npx.cmd",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


- [Comprobar la conexión gratis](https://flashdata.dev/es/docs/integrations/openclaw/reference.md#connection-check)
- [Crear una clave API](https://flashdata.dev/app/api-keys)
- [Documentación del MCP local](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

## Solución de problemas

| Problema | Qué hacer |
| --- | --- |
| Lista vacía | Ejecuta 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 skill | Ejecuta 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 / callback | Compara 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. |
| 401 | Comprueba 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. |
| 403 | Comprueba 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. |
| 402 | Consulta 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. |
| 429 | Espera 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 clave | Define 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 existe | Lee ./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ódica | Ejecuta 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 incierto | Si 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. |

- [Guía de recuperación](https://flashdata.dev/es/docs/guides/agent-recovery/reference.md)
- [Documentación de MCP en OpenClaw](https://docs.openclaw.ai/cli/mcp/transports)

<a id="compatibility"></a>

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

- [Skills oficiales](https://github.com/flashdatadev/flashdata-skills)
- [Paquete y código fuente de MCP](https://github.com/flashdatadev/flashdata-mcp)
