Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Integrazioni

OpenClaw

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.

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. 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
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe

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

Primo prompt delle attività
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.

CompitiStrumento MCP
Trova le fonti web per una risposta o un'implementazionegoogle_search
Trova i video YouTubeyoutube_search
Leggi i titoli video, i canali e i metadatiyoutube_metadata
Recuperare la trascrizione di un video per un riassuntoyoutube_transcript
Controllare i crediti disponibili e il costo della richiestaget_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 il controllo
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.

Corpo di lavoro
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

  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
openclaw mcp logout flashdata

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

Nel tuo spazio di lavoro OpenClaw
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible

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
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible

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
flashdata auth login
flashdata auth status --json --non-interactive
2. Bilancio di controllo e costo — nessuna ricerca
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
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.

1. Impostare la chiave senza stamparlo
# 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
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

Risoluzione dei problemi

ProblematicheProva questo
Strumenti FlashDataEseguire Openclaw mcp medico flashdata --probe. Controlla il profilo gateway e la politica degli strumenti dell'agente, quindi apri una conversazione fresca.
Abilità mancanteEseguire 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 / callbackConfronta il passo 1 esattamente. Autorizzazione completa in un browser in grado di raggiungere il callback dell'ospite iniziante.
401Controllare 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.
403Controllare il permesso della fonte richiesta. Ricerca OAuth non include YouTube Download; utilizza la sua configurazione API-chiave. Fissare il permesso prima di riprovare.
402Controllare il saldo dell'account get_balance o flashdata. Aggiungi crediti in Billing o interrompere l'attività; la firma di nuovo non aggiunge crediti.
429Attendere 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 chiaveImpostare 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 fallisceEsegui 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 sconosciutoMantenere 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.