Sfoglia la documentazione
Integrazioni
Dare il vostro agente OpenClaw Google Search e YouTube strumenti per la ricerca e le briefing ricorrenti.
In questa pagina
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.
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.
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. 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.
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeControllare 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.
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.3. Esegui il tuo primo compito
Invia questo al tuo agente collegato. I controlli sono gratuiti; la singola ricerca utilizza crediti.
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.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.
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 |
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.
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 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.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.
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.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.
Rivocare o riconnettere
- Pausa compiti programmati, quindi revocare la connessione OAuth in FlashData Settings → Connected apps.
- 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.
- 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.
openclaw mcp logout flashdataAltre opzioni di configurazione
Aggiungi le competenze del flusso di lavoro alla connessione MCP, o scegli l'accesso CLI o un server MCP locale.
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.
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligibleUtilizzare 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.
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligibleIncollare 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.
flashdata auth login
flashdata auth status --json --non-interactiveflashdata 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.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.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.
flashdata auth status --json --non-interactiveflashdata 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.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.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.
flashdata init --name "OpenClaw research" --client openclaw --audience personal --scopes google_search --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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.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: 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_KEYopenclaw 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# 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 flashdataSecureKeyopenclaw mcp set flashdata '{
"command": "npx.cmd",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
}
}'
openclaw mcp doctor flashdata --probeRisoluzione 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. |
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.