# OpenClaw

Donnez à votre agent OpenClaw des outils Google Search et YouTube pour ses recherches et ses synthèses récurrentes.

Référence canonique : https://flashdata.dev/fr/docs/integrations/openclaw
Vérifié le 2026-11-05 par FlashData

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

## Avant de commencer

Installez OpenClaw et vérifiez son fonctionnement. Cette configuration MCP hébergée utilise OAuth pour Google Search, YouTube Search, les métadonnées et les transcriptions. Vous pouvez créer un compte FlashData lors de la connexion.

- [Utiliser les skills CLI ou démarrer un essai](https://flashdata.dev/fr/docs/integrations/openclaw/reference.md#cli)
- [Installer OpenClaw](https://docs.openclaw.ai/start/getting-started)

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

## 1. Ajouter le serveur MCP

Exécutez cette commande sur la machine et dans le profil OpenClaw de votre passerelle. Elle enregistre la configuration du serveur ; la connexion et l’appel d’outil ci-dessous vérifient que votre agent peut l’utiliser. Gardez le même profil pour toutes les commandes de cette page.

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

Exécutez la commande de connexion. Dans le navigateur, connectez-vous ou créez un compte et vérifiez son adresse e-mail, puis approuvez l’accès. Attendez la confirmation de connexion dans le terminal. Les requêtes utilisent les crédits de ce compte.

### Se connecter

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


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

### Vérifier la connexion gratuitement

Ouvrez une nouvelle conversation dans Control UI ou votre canal de discussion connecté. Envoyez cette consigne ; les deux appels doivent réussir. La seule réussite du test du registre ne prouve pas que cette conversation peut utiliser les outils.

#### À coller dans votre agent

```text
Utilisez la connexion MCP flashdata.
Appelez get_balance avec {} et get_pricing avec {"source":"google_search","request_count":1}.
Indiquez les crédits disponibles et le coût estimé. Ne lancez aucune recherche.
```


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

## 3. Exécuter votre première tâche

Envoyez cette consigne à votre agent connecté. Les vérifications sont gratuites ; la recherche unique consomme des crédits.

### Consigne pour la première tâche

```text
Utilisez le serveur MCP flashdata. Vérifiez mon solde et le coût d’une recherche Google.
Si le solde est suffisant, appelez google_search une seule fois avec query "battery recycling research", num 5 et mode "realtime".
Fournissez une courte synthèse avec les titres, les URL et les extraits des sources.
Citez les sources et indiquez les crédits réellement utilisés. Arrêtez après cette tâche.
```


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

### Résultat attendu

Vérifiez que l’appel à google_search est terminé avec status: done, des liens sources dans results[].organic et une réponse fondée sur ces sources. La consommation figure dans usage.credits ; ce n’est pas le nombre de résultats. Signalez explicitement les résultats vides.

- [Consulter l’historique des requêtes](https://flashdata.dev/app/jobs)

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

## Ce que vous pouvez demander

Cette connexion OAuth donne accès aux outils de recherche. YouTube Download utilise une clé API propriétaire et un stockage de destination via l’API ou la CLI.

| Tâche | Outil MCP |
| --- | --- |
| Trouver des sources web pour une réponse ou une implémentation | google_search |
| Trouver des vidéos YouTube pertinentes | youtube_search |
| Lire les titres, les chaînes et les métadonnées des vidéos | youtube_metadata |
| Récupérer la transcription d’une vidéo pour la résumer | youtube_transcript |
| Vérifier les crédits disponibles et le coût d’une requête | get_balance · get_pricing |

- [Outils et schémas MCP](https://flashdata.dev/fr/docs/mcp/reference.md)
- [Configurer YouTube Download](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md)

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

## Réutiliser l’accès pour les tâches récurrentes

Utilisez le profil et l’agent OpenClaw avec lesquels la première tâche a réussi. Les exécutions planifiées de la passerelle doivent disposer de la même connexion MCP et des mêmes autorisations d’outils que votre conversation.


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

### Vérifier l’accès enregistré

Exécutez cette vérification gratuite dans une nouvelle session, dans l’environnement qui exécutera les tâches planifiées. Les deux appels doivent réussir sans nouvelle connexion dans le navigateur.

#### Vérifier la réutilisation

```text
Réutilisez la connexion MCP flashdata existante.
Appelez get_balance avec {} et get_pricing avec {"source":"google_search","request_count":1}.
Indiquez si les deux appels ont réussi. Ne lancez aucune recherche et ne créez pas de nouvel accès.
```


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

### Créer la tâche récurrente

Dans le planificateur de votre hôte, choisissez une heure et un fuseau horaire, par exemple tous les jours à 09:00 Asia/Shanghai. Utilisez la consigne ci-dessous pour la tâche. Exécutez-la une fois dans cet environnement et vérifiez le rapport enregistré avant d’activer la récurrence.

#### Consigne de la tâche

```text
Réutilisez la connexion MCP flashdata existante. Vérifiez get_balance et get_pricing pour une recherche Google.
Si l’accès est autorisé et le solde suffisant, appelez google_search une seule fois pour "battery recycling research" avec num 5 et mode "realtime".
Enregistrez un rapport daté avec les URL sources, les extraits et les crédits réellement utilisés.
Arrêtez si l’accès est révoqué ou les crédits insuffisants ; respectez Retry-After. Ne créez pas d’essai, ne demandez pas de nouvelle autorisation et ne répétez pas une requête dont le résultat est inconnu.
```

- [Guide des tâches récurrentes](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md)
- [Planification et reprise avec la CLI](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#recurring)

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

### Stockage et renouvellement des identifiants

Cette configuration utilise la connexion OAuth partagée de l’opérateur OpenClaw. Les participants autorisés aux conversations et les exécutions planifiées utilisent ce compte FlashData et son solde. Aucun compte distinct n’est créé pour chaque expéditeur.

L’hôte renouvelle les jetons d’accès OAuth valables une heure à l’aide de jetons de renouvellement rotatifs. Reconnectez-vous lorsque l’autorisation de 90 jours expire ou est révoquée. Chaque installation possède son propre stockage de jetons ; ne partagez pas les fichiers de jetons de renouvellement entre hôtes.


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

### Révoquer l’accès ou se reconnecter

1. Mettez les tâches planifiées en pause, puis révoquez la connexion OAuth concernée dans FlashData : Settings → Connected apps.
2. Demandez à l’agent d’appeler get_balance une fois avec la connexion enregistrée. L’authentification doit échouer ou une reconnexion doit être demandée. N’approuvez pas de nouvelle connexion pendant cette vérification.
3. Supprimez les identifiants OAuth locaux avec la commande ci-dessous. Pour vous reconnecter plus tard, répétez l’étape 2 avec l’approbation du propriétaire, puis lancez la vérification gratuite de la connexion.

#### Supprimer les identifiants OAuth enregistrés

```bash
openclaw mcp logout flashdata
```

- [Applications connectées](https://flashdata.dev/app/settings/connections)

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

## Autres options de configuration

Ajoutez des skills à votre connexion MCP, ou choisissez l’accès par CLI ou un serveur MCP local.


<a id="skills"></a>

### Ajouter le skill MCP

Le skill flashdata-mcp explique à votre agent comment utiliser les outils connectés. Il réutilise la connexion configurée ci-dessus.

Avec Node.js 22.20+ et npm, exécutez cette commande dans l’espace de travail OpenClaw actif. Le skill complet est enregistré dans skills/flashdata-mcp. Démarrez une nouvelle conversation et demandez à utiliser flashdata-mcp.

#### Dans votre espace de travail OpenClaw

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

- [Installer la CLI](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#install)
- [Consulter le skill MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Mettre à jour ou supprimer les skills](https://flashdata.dev/fr/docs/guides/agent-skill-management/reference.md)

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

### Utiliser les skills CLI ou démarrer un essai

Installez la CLI FlashData v1.2.1 et exécutez les commandes depuis l’espace de travail OpenClaw actif. Choisissez un onglet d’accès. Les exemples utilisent le profil CLI par défaut, distinct de la connexion MCP OAuth ; conservez vos options --profile et --state-dir si vous les avez personnalisées.

Installez les deux skills ci-dessous avec Node.js 22.20+ et npm, puis démarrez une nouvelle conversation OpenClaw. La commande setup de la CLI native ne cible pas OpenClaw.

#### Installer les skills CLI

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

#### Clé API existante

Collez une clé disposant de la permission google_search à l’invite de saisie masquée. Pour un import sans interaction, transmettez-la depuis votre gestionnaire de secrets à auth login --api-key-stdin --non-interactive via l’entrée standard.

##### 1. Importer et vérifier la clé

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

##### 2. Vérifier le solde et le coût — sans recherche

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# Continue only if accessVerified and estimateAvailable are true,
# google_search is permitted, and availableCredits covers estimatedCredits.
```

##### 3. Exécuter une fois → ./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

# Read the saved file: status, results[].organic, usage.credits.
# Terminal JSON reports the output path; keep the run ID for recovery.
```


#### Accès CLI enregistré

Réutilisez votre clé ou votre essai existant. Si FLASHDATA_API_KEY est définie, elle est prioritaire sur la clé enregistrée ; vérifiez le compte affiché par auth status.

##### 1. Réutiliser et vérifier l’accès enregistré

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

##### 2. Vérifier le solde et le coût — sans recherche

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# Continue only if accessVerified and estimateAvailable are true,
# google_search is permitted, and availableCredits covers estimatedCredits.
```

##### 3. Exécuter une fois → ./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

# Read the saved file: status, results[].organic, usage.credits.
# Terminal JSON reports the output path; keep the run ID for recovery.
```


#### Essai éligible

Réutilisez un essai existant ou inscrivez-vous une seule fois. Si l’essai a expiré, est épuisé ou a été révoqué, reprenez l’accès ou rattachez l’essai à votre compte. Avant toute tâche CLI récurrente, terminez le rattachement et vérifiez recurringAllowed: true dans auth status.

##### 1. Configurer et vérifier l’accès d’essai

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

##### 2. Vérifier le solde et le coût — sans recherche

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# Continue only if accessVerified and estimateAvailable are true,
# google_search is permitted, and availableCredits covers estimatedCredits.
```

##### 3. Exécuter une fois → ./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

# Read the saved file: status, results[].organic, usage.credits.
# Terminal JSON reports the output path; keep the run ID for recovery.
```


- [Télécharger la CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Installer la CLI](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#install)
- [Récupérer un résultat enregistré](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#recover)
- [Rattacher l’essai avant les tâches CLI récurrentes](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)

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

### Exécuter MCP localement avec une clé API

Nécessite Node.js 22.18+, npm et une clé API disposant de la permission google_search pour la première tâche. Cette configuration exécute @flashdata-dev/mcp 0.2.0 ; elle ne lit ni la clé enregistrée par la CLI FlashData ni les jetons MCP OAuth.

Définissez la clé dans l’environnement qui exécute la passerelle. La saisie ci-dessous convient à une passerelle lancée depuis un terminal ; pour un service ou un conteneur, injectez FLASHDATA_API_KEY dans sa configuration de secrets ou d’environnement, puis redémarrez-le. Exporter une clé dans un autre terminal ne modifie pas un service déjà démarré.

Après la configuration, envoyez la consigne de vérification gratuite ci-dessus dans une nouvelle session de l’agent. Lorsque les deux vérifications réussissent, envoyez la consigne de première tâche. L’accès par clé API ne nécessite pas mcp login.

#### Bash

##### 1. Définir la clé sans l’afficher

```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. Enregistrer et tester le serveur dans le profil de la passerelle

```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. Définir la clé sans l’afficher

```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. Enregistrer et tester le serveur dans le profil de la passerelle

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


- [Vérifier la connexion gratuitement](https://flashdata.dev/fr/docs/integrations/openclaw/reference.md#connection-check)
- [Créer une clé API](https://flashdata.dev/app/api-keys)
- [Documentation du serveur MCP local](https://github.com/flashdatadev/flashdata-mcp)

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

## Dépannage

| Problème | Solution |
| --- | --- |
| Aucun outil FlashData | Exécutez openclaw mcp doctor flashdata --probe. Vérifiez le profil de la passerelle et les règles d’accès aux outils de l’agent, puis ouvrez une nouvelle conversation. |
| Skill absent | Exécutez openclaw skills list --eligible et openclaw skills check dans le profil actif. Vérifiez le dossier skills/ de l’espace de travail et la liste des skills autorisés. |
| invalid_client / callback | Comparez votre configuration avec l’étape 1. Terminez l’autorisation dans un navigateur capable d’atteindre l’URL de rappel de l’hôte ayant lancé la connexion. |
| 401 | Vérifiez si la connexion ou la clé a été révoquée ou a expiré. Pour OAuth, reconnectez-vous avec l’approbation du propriétaire ; pour la CLI, exécutez flashdata auth status. L’ajout de crédits ne corrige pas l’authentification. |
| 403 | Vérifiez la permission de la source demandée. La connexion OAuth de recherche ne couvre pas YouTube Download ; utilisez sa configuration par clé API. Corrigez la permission avant de réessayer. |
| 402 | Vérifiez get_balance ou flashdata account balance. Ajoutez des crédits dans Billing ou arrêtez la tâche ; une nouvelle connexion n’ajoute pas de crédits. |
| 429 | Respectez le délai Retry-After et réduisez le nombre de requêtes simultanées. Conservez le profil et la preuve d’inscription existants ; ne créez pas d’autres essais. |
| Le serveur MCP local ne peut pas lire la clé | Définissez FLASHDATA_API_KEY dans l’environnement de lancement de l’hôte, puis redémarrez-le. Une clé enregistrée par flashdata auth login n’est pas automatiquement exportée vers le serveur MCP local. |
| Le fichier de sortie CLI existe déjà | Lisez ./openclaw-first-search.json. Pour exporter à nouveau le résultat réussi enregistré, utilisez flashdata runs show openclaw-first-search-001 --result --output openclaw-first-search-copy.json avec le profil d’origine. Utilisez un nouvel identifiant d’exécution uniquement pour lancer volontairement une nouvelle recherche. |
| Échec de la tâche planifiée | Exécutez la vérification gratuite de réutilisation dans cet environnement. Utilisez le même utilisateur du système, le même profil d’hôte, le même stockage d’identifiants et les mêmes autorisations d’outils. |
| Délai dépassé ou résultat inconnu | Conservez l’identifiant de requête ou de tâche et consultez History avant de soumettre à nouveau. Utilisez get_result pour les identifiants de continuation reçus. |

- [Guide de reprise](https://flashdata.dev/fr/docs/guides/agent-recovery/reference.md)
- [Documentation MCP · OpenClaw](https://docs.openclaw.ai/cli/mcp/transports)

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

## Notes de validation OAuth

La connexion OAuth, l’URL de rappel, l’enregistrement des identifiants, un appel gratuit de tarification, le renouvellement et la révocation ont été vérifiés sous Windows avec OpenClaw 2026.10.5 le 2026-10-21. Ce test ne couvrait ni les requêtes payantes ni l’exécution planifiée. Les instructions de configuration ont été vérifiées dans la documentation de l’hôte le 2026-11-05.

- [Skills officiels](https://github.com/flashdatadev/flashdata-skills)
- [Package MCP et code source](https://github.com/flashdatadev/flashdata-mcp)
