# OpenClaw

Dare il vostro agente OpenClaw Google Search e YouTube strumenti per la ricerca e le briefing ricorrenti.

Riferimento canonico: https://flashdata.dev/it/docs/integrations/openclaw
Recensito: 2026-11-05 da FlashData

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

## Prima di iniziare

Fai installare e lavorare OpenClaw. Questa configurazione MCP ospitata utilizza OAuth per Google Search, YouTube Search, Metadata e Transcripts. È possibile creare un account FlashData durante il login.

- [Utilizzare le competenze CLI o avviare una prova](https://flashdata.dev/it/docs/integrations/openclaw/reference.md#cli)
- [Installare OpenClaw](https://docs.openclaw.ai/start/getting-started)

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

## 1. Aggiungi il server MCP

Eseguire questo sul profilo della macchina e OpenClaw che gestisce il gateway. Salva la configurazione del server; il login e la chiamata di strumento di seguito verificano che il vostro agente può effettivamente utilizzarlo. Usa lo stesso profilo per ogni comando in questa pagina.

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

Eseguire il comando di login. Nel browser, accedi o crea e verifica un account, quindi approva l'accesso. Attendere che il terminale confermi il login. Le query usano i crediti di quell'account.

### Accedi

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


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

### Controllare la connessione gratuitamente

Aprire una nuova conversazione nell'interfaccia utente di controllo o il vostro canale di chat collegato. Invia questo prompt; entrambe le chiamate dovrebbero avere successo. Una sonda di registro di successo da sola non dimostra che questa conversazione può usare gli strumenti.

#### Incolla il tuo agente

```text
Utilizzare la connessione flashdata MCP.
Chiama get_balance con {} e get_pricing con {"source":"google_search","request_count":1}.
Rapporto di crediti disponibili e il prezzo stimato. Non eseguire una ricerca.
```


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

## 3. Esegui il tuo primo compito

Invia questo al tuo agente collegato. I controlli sono gratuiti; la singola ricerca utilizza crediti.

### Primo prompt delle attività

```text
Utilizzare il server flashdata MCP. Controlla il mio saldo e il prezzo di una ricerca Google.
Se finanziato, chiamare google_search una volta con query "battery recycling research", num 5 e modalità "realtime".
Datemi un breve briefing con i titoli di origine, URLs ed estratti.
Cite fonti e segnalare i crediti effettivi utilizzati. Smettetela dopo questo compito.
```


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

### Che cosa dovresti vedere

Cercare una chiamata completa google_search con status: done, collegamenti sorgente da results[].organic e una risposta in base a tali fonti. L'uso proviene da usage.credits; non è il numero di risultati. I risultati vuoti dovrebbero essere segnalati come vuoti.

- [Ispezionare la cronologia delle richieste](https://flashdata.dev/app/jobs)

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

## Cosa puoi chiedere

Questa connessione OAuth copre gli strumenti di ricerca. YouTube Download utilizza una chiave API e una memoria di destinazione tramite API o CLI.

| Compiti | Strumento MCP |
| --- | --- |
| Trova le fonti web per una risposta o un'implementazione | google_search |
| Trova i video YouTube | youtube_search |
| Leggi i titoli video, i canali e i metadati | youtube_metadata |
| Recuperare la trascrizione di un video per un riassunto | youtube_transcript |
| Controllare i crediti disponibili e il costo della richiesta | get_balance · get_pricing |

- [Strumenti e schemi MCP](https://flashdata.dev/it/docs/mcp/reference.md)
- [Impostare YouTube Scarica](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)

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

## Riutilizzare l'accesso per le attività ricorrenti

Utilizzare il profilo e l'agente OpenClaw che ha superato il primo compito. Le operazioni programmate del gateway devono avere la stessa connessione MCP e le autorizzazioni degli strumenti come la vostra chat.


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

### Verificare l'accesso salvato

Eseguire questo controllo gratuito in una sessione fresca nell'ambiente pianificato. Entrambe le chiamate dovrebbero avere successo senza un nuovo login del browser.

#### Riutilizzare il controllo

```text
Riutilizzare la connessione flashdata esistente MCP.
Chiama get_balance con {} e get_pricing con {"source":"google_search","request_count":1}.
Segnala se sono riusciti entrambi. Non cercare o creare nuovi accessi.
```


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

### Creare l'attività ricorrente

Nel programmatore del tuo host, scegli un fuso orario e un fuso orario, ad esempio ogni giorno a 09:00 Asia/Shanghai. Utilizzare questo come il corpo dell'attività. Eseguire una volta lì e controllare il rapporto salvato prima di abilitare la ricorrenza.

#### Corpo di lavoro

```text
Riutilizzare la connessione flashdata esistente MCP. Controlla get_balance e get_pricing per una ricerca Google.
Se consentito e finanziato, eseguire google_search una volta per "battery recycling research" con num 5 e modalità "realtime".
Salvare un rapporto datato con fonte URLs, estratti e crediti reali utilizzati.
Stop all'accesso revocato o crediti insufficienti; rispettare Retry-After. Non creare una prova, richiedere una nuova autorizzazione o ripetere una richiesta il cui risultato è sconosciuto.
```

- [Guida alle attività ricorrenti](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md)
- [CLI scheduling e recupero](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#recurring)

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

### Deposito centrata e aggiornamento

Questa configurazione utilizza la connessione OpenClaw condivisa dell'operatore OAuth. I partecipanti alla chat e le piste programmate utilizzano l'account FlashData e il suo equilibrio. Non fornisce un conto separato per ogni mittente.

L'host aggiorna i token di accesso OAuth di un'ora utilizzando token di aggiornamento rotanti. Ricollegare quando la sovvenzione 90-day scade o viene revocata. Ogni installazione possiede il suo negozio di token; non condividere i file di aggiornamento-token tra gli host.


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

### Rivocare o riconnettere

1. Pausa compiti programmati, quindi revocare la connessione OAuth in FlashData Settings → Connected apps.
2. Chiedi all'agente di chiamare get_balance una volta con la connessione salvata. Dovrebbe fallire l'autenticazione o chiedere di riconnettersi. Non approvare un nuovo login durante questo assegno.
3. Rimuovere le credenziali OAuth locali con il comando sottostante. Per riconnettersi in seguito, ripetere il passaggio 2 con l'approvazione del proprietario ed eseguire il controllo di connessione gratuito.

#### Rimuovere le credenziali OAuth salvate

```bash
openclaw mcp logout flashdata
```

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

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

## Altre opzioni di configurazione

Aggiungi le competenze del flusso di lavoro alla connessione MCP, o scegli l'accesso CLI o un server MCP locale.


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

### Aggiungere l'abilità MCP

L'abilità flashdata-mcp insegna al tuo agente come utilizzare gli strumenti collegati. Riutilizza la connessione sopra.

Con Node.js 22.20+ e npm, eseguirlo nello spazio di lavoro attivo OpenClaw. L'abilità completa viene salvata a skills/flashdata-mcp. Avviare una nuova conversazione e chiedere di usare flashdata-mcp.

#### Nel tuo spazio di lavoro OpenClaw

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

- [Installazione CLI](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#install)
- [Leggi l'abilità MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Aggiornare o rimuovere le competenze](https://flashdata.dev/it/docs/guides/agent-skill-management/reference.md)

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

### Utilizzare le competenze CLI o avviare una prova

Installare FlashData CLI v1.2.1 ed eseguire da lo spazio di lavoro attivo OpenClaw. Scegli una scheda di accesso. Gli esempi utilizzano il profilo predefinito CLI, separato da MCP OAuth; mantieni il tuo --profile e --state-dir se utilizzi quelli personalizzati.

Installare le due abilità di flusso di lavoro qui sotto con Node.js 22.20+ e npm. Avviare una nuova conversazione OpenClaw in seguito. Il comando di configurazione di CLI nativo non si rivolge a OpenClaw.

#### Installare le competenze del flusso di lavoro CLI

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

#### Cintura API esistente

Incollare una chiave con il permesso google_search al prompt nascosto. Per l'importazione incustodita, passalo dal tuo manager segreto a auth login --api-key-stdin --non-interactive.

##### 1. Importa e verifica la chiave

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


#### Accesso salvato CLI

Riutilizzare la chiave o il prova esistenti. Se viene impostato FLASHDATA_API_KEY, è necessario prevalere sulla chiave salvata; verificare l'account mostrato da auth status.

##### 1. Riutilizzare e verificare l'accesso salvato

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


#### Prova idonea

Riutilizzare una prova esistente o registrarsi una volta. Se scaduto, esaurito o revocato, recupera o reclama. Prima di riattivare le attività CLI, rivendicare l'account e confermare recurringAllowed: true in auth status.

##### 1. Impostare e verificare l'accesso alla prova

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


- [Scarica CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Installazione CLI](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#install)
- [Recuperare un risultato salvato](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#recover)
- [Rivendicare prima di eseguire le attività CLI](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

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

### Eseguire MCP locale con una chiave API

Richiede Node.js 22.18+, npm e una chiave API con il permesso google_search per la prima attività. Questo viene eseguito @flashdata-dev/mcp 0.2.0; non legge il tasto salvato di FlashData CLI o i token MCP OAuth.

Impostare la chiave nell'ambiente che gestisce effettivamente il gateway. Il prompt qui sotto è per un gateway di avvio terminale; per un servizio o un contenitore, iniettare FLASHDATA_API_KEY attraverso la sua configurazione secret/environment e riavviarlo. L'esportazione di una chiave in un altro terminale non aggiornerà un servizio in esecuzione.

Dopo l'installazione, eseguire il prompt di connessione-check gratuito sopra in una nuova sessione di agente. Una volta che entrambi i controlli passano, utilizzare il prompt del primo-task. L'accesso API-chiave non richiede il login mcp.

#### Bash

##### 1. Impostare la chiave senza stamparlo

```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 e sonda nel profilo 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. Impostare la chiave senza stamparlo

```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 e sonda nel profilo 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
```


- [Eseguire il controllo della connessione gratuita](https://flashdata.dev/it/docs/integrations/openclaw/reference.md#connection-check)
- [Creare una chiave API](https://flashdata.dev/app/api-keys)
- [Documentazione locale MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Risoluzione dei problemi

| Problematiche | Prova questo |
| --- | --- |
| Strumenti FlashData | Eseguire Openclaw mcp medico flashdata --probe. Controlla il profilo gateway e la politica degli strumenti dell'agente, quindi apri una conversazione fresca. |
| Abilità mancante | Eseguire la lista delle competenze openclaw --eligible e le competenze openclaw controllare nel profilo attivo. Controllare le competenze dello spazio di lavoro/ e la lista delle abilità consentite. |
| invalid_client / callback | Confronta il passo 1 esattamente. Autorizzazione completa in un browser in grado di raggiungere il callback dell'ospite iniziante. |
| 401 | Controllare se la connessione o la chiave è stata revocata o scaduta. Per OAuth, ripeti il login con l'approvazione del proprietario; per CLI, eseguire flashdata auth status. L'aggiunta di crediti non ripara l'autenticazione. |
| 403 | Controllare il permesso della fonte richiesta. Ricerca OAuth non include YouTube Download; utilizza la sua configurazione API-chiave. Fissare il permesso prima di riprovare. |
| 402 | Controllare il saldo dell'account get_balance o flashdata. Aggiungi crediti in Billing o interrompere l'attività; la firma di nuovo non aggiunge crediti. |
| 429 | Attendere Retry-After e ridurre la convalutazione. Conservare il profilo attuale e la prova di registrazione; non creare prove di sostituzione. |
| MCP locale non può leggere la chiave | Impostare FLASHDATA_API_KEY in cui il processo host inizia e riavviarlo. Una chiave salvata da flashdata auth login non viene esportata automaticamente in MCP locale. |
| Il file di output CLI esiste già | Leggi ./openclaw-first-search.json. Per esportare di nuovo il successo salvato, utilizzare flashdata runs show openclaw- Prima ricerca.001 --result --output openclaw-first-search-copy.json con il profilo originale. Utilizzare una nuova esecuzione ID solo per una nuova ricerca prevista. |
| L'attività pianificata fallisce | Esegui il controllo di riutilizzo gratuito all'interno di quell'ambiente. Abbina l'utente OS, il profilo host, le autorizzazioni di archiviazione e strumento credenziali. |
| Esito di timeout o sconosciuto | Mantenere la richiesta o il lavoro ID e controllare History prima di resubmitting. Utilizzare get_result per la continuazione restituita IDs. |

- [Guida di recupero](https://flashdata.dev/it/docs/guides/agent-recovery/reference.md)
- [Documentazione OpenClaw MCP](https://docs.openclaw.ai/cli/mcp/transports)

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

## Note di convalida OAuth

OAuth login, callback, credenziali salvate, una chiamata gratuita per i prezzi, aggiornamento e revoca sono stati verificati su Windows con OpenClaw 2026.10.5 su 2026-10-21. Quell'esecuzione non ha convalidato le domande pagate o l'esecuzione programmata. Le istruzioni di configurazione sono state controllate contro la documentazione dell'host su 2026-11-05.

- [Capacità ufficiali](https://github.com/flashdatadev/flashdata-skills)
- [Pacchetto e fonte MCP](https://github.com/flashdatadev/flashdata-mcp)
