Explorar documentação
Integrações
Dê ao seu agente OpenClaw Google busca e ferramentas YouTube para pesquisa e instruções recorrentes.
Nesta página
Antes de começar
Mande instalar e trabalhar o OpenClaw. Esta configuração MCP hospedada usa OAuth para Google Search, YouTube Search, Metadados e Transcritos. Você pode criar uma conta FlashData durante o login.
1. Adicione o servidor MCP
Passe isso na máquina e perfil OpenClaw que executa seu portal. Ele salva a configuração do servidor, o login e a chamada de ferramenta abaixo verificam que seu agente pode usá-la. Use o mesmo perfil para cada comando nesta página.
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. Entre na sua conta
Execute o comando de login. No navegador, entre ou crie e verifique uma conta, e então aprove o acesso. Espere o terminal confirmar o login. Consultas usam os créditos da conta.
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeVerifique a conexão de graça
Abra uma nova conversa na interface de controle ou no seu canal de chat conectado. Envie este alerta, ambas as chamadas devem ter sucesso. Uma sonda de registro de sucesso sozinha não prova que esta conversa pode usar as ferramentas.
Use os dados da conexão MCP.
Chame get_balance com {} e get_pricing com {"source":"google_search","request_count":1}.
Relate os créditos disponíveis e o preço estimado. Não faça uma busca.3. Execute sua primeira tarefa
Envie isso para seu agente conectado. Os verificações são grátis, a única busca usa créditos.
Use o servidor flashdata MCP. Verifique meu saldo e o preço de uma busca Google.
Se financiado, ligue para google_search uma vez com consulta "battery recycling research", num 5 e modo "realtime".
Dê-me uma breve reunião com os títulos de origem, URLs e trechos.
Cite fontes e relate créditos usados. Pare depois dessa tarefa.O que você deveria ver
Procure uma chamada completa da ferramenta google_search com status: done, links de fonte de results[].organic e uma resposta baseada nessas fontes. O uso vem do usage.credits, não é o número de resultados. Os resultados vazios devem ser relatados como vazios.
O que você pode pedir
Esta conexão OAuth cobre ferramentas de pesquisa. YouTube Download usa uma chave API proprietária e armazenamento de destino através do API ou CLI.
| Tarefa | MCP ferramenta |
|---|---|
| Encontre fontes para uma resposta ou implementação | google_search |
| Encontre vídeos relevantes de YouTube | youtube_search |
| Leia títulos de vídeo, canais e metadados | youtube_metadata |
| Recupere uma transcrição de vídeo para um resumo | youtube_transcript |
| Verifique os créditos disponíveis e o custo do pedido | get_balance · get_pricing |
Reutilize o acesso para tarefas recorrentes
Use o perfil OpenClaw e agente que passou na primeira tarefa. As saídas programadas do portal devem ter a mesma conexão MCP e permissões de ferramentas que seu bate-papo.
Verifique o acesso salvo
Faça esse verificação grátis em uma nova sessão no ambiente programado. Ambas as chamadas devem ter sucesso sem um novo login no navegador.
Reutilize a conexão existente com o MCP.
Chame get_balance com {} e get_pricing com {"source":"google_search","request_count":1}.
Relate se ambos conseguiram. Não procurem ou criem novos acessos.Crie a tarefa recorrente
Na agenda do seu anfitrião, escolha um fuso horário e horário, por exemplo, diariamente em 09:00 Asia/Shanghai. Use isso como o corpo de tarefas. Examine uma vez lá e verifique o relatório antes de permitir a recorrência.
Reutilize a conexão existente com o MCP. Verifique get_balance e get_pricing para uma busca Google.
Se for permitido e financiado, execute google_search uma vez para "battery recycling research" com 5 e modo "realtime".
Guarde um relatório datado com fonte URLs, trechos e créditos usados.
Pare com o acesso revogado ou créditos insuficientes, respeite Retry-After. Não crie um teste, peça nova autorização ou repita um pedido cujo resultado é desconhecido.Armazenamento e atualização de credenciais
Esta configuração usa o OpenClaw O operador é compartilhado. OAuth Conexão. Os participantes de bate-papo permitidos e as corridas programadas usam a conta FlashData e seu saldo. Não fornece uma conta separada para cada remetente.
O host atualiza fichas de acesso OAuth de uma hora usando fichas rotativas de atualização. Reconecte-se quando o subsídio de 90 expirar ou for revogado. Cada instalação possui sua loja de fichas, não compartilhe arquivos de atualização entre os anfitriões.
Revogar ou reconectar
- Pause as tarefas agendadas, então revogue a chamada conexão OAuth em FlashData Settings → Connected apps.
- Peça ao agente para ligar para get_balance uma vez com a conexão salva. Deve falhar na autenticação ou pedir para se reconectar. Não aprove um novo login durante este verificação.
- Remova as credenciais locais OAuth com o comando abaixo. Para se reconectar mais tarde, repita o passo 2 com aprovação do proprietário e execute a verificação de conexão livre.
openclaw mcp logout flashdataMais opções de configuração
Adicione habilidades de fluxo de trabalho à sua conexão MCP, ou escolha acesso CLI ou um servidor MCP local.
Adicione a habilidade MCP
A habilidade flashdata-mcp ensina seu agente a usar as ferramentas conectadas. Reutiliza a conexão acima.
Com Node.js 22.20+ e npm, execute isso no espaço de trabalho OpenClaw ativo. A habilidade completa é salva para skills/flashdata-mcp.. Comece uma nova conversa e peça para usar flashdata-mcp.
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligibleUse habilidades CLI ou comece um teste
Instale FlashData CLI v1.2.1 e corra de O OpenClaw ativo. Escolha uma guia de acesso. Exemplos usam o perfil padrão CLI, separado do MCP OAuth; mantenha seu --profile e --state-dir existentes se você usar os personalizados.
Instale as duas habilidades de fluxo de trabalho abaixo com Node.js 22.20+ e npm. Comece uma nova conversa OpenClaw depois. O comando de configuração CLI nativo não visa OpenClaw.
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligibleCola uma chave com permissão google_search no alerta oculto. Para importação sem supervisão, desvie do seu gerente secreto para 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
# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.Reutilize sua chave ou teste. Se FLASHDATA_API_KEY for definido, tem precedência sobre a chave salva; verifique a conta mostrada por 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
# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.Reutilize um teste ou registre-se uma vez. Se expirado, esgotado ou revogado, recupere ou reivindique. Antes das tarefas CLI recorrentes, reivindique a conta e confirme recurringAllowed: true em 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
# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.Corra MCP local com uma chave API
Requer Node.js 22.18+, npm e uma chave API com permissão google_search para a primeira tarefa. Isto roda @flashdata-dev/mcp 0.2.0; não lê as chaves salvas de FlashData CLI ou as fichas MCP OAuth.
Defina a chave no ambiente que realmente funciona no portal. O prompt abaixo é para um gateway lançado pelo terminal, para um serviço ou recipiente, injete FLASHDATA_API_KEY através de sua configuração secret/environment e reinicie-a. Exportar uma chave em outro terminal não atualizará um serviço em execução.
Depois da configuração, execute o prompt de conexão livre em uma nova sessão de agentes. Uma vez que os dois verificações passarem, use o primeiro alerta de tarefa. API-chave de acesso não requer 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 --probeSolução de problemas
| Problema | Tente isso |
|---|---|
| Sem ferramentas FlashData | Faça o Openclaw MCP Dr. Flashdata --probe. Verifique o perfil do portal e a política de ferramentas do agente, e então abra uma nova conversa. |
| Falta a habilidade | Execute a lista de habilidades de openclaw --eligible e habilidades de openclaw verificar no perfil ativo. Verifique as habilidades do espaço de trabalho e a lista de habilidades. |
| invalid_client / callback | Compare o passo 1 exatamente. Autorização completa em um navegador que pode chegar ao retorno do anfitrião iniciante. |
| 401 | Verifique se a conexão ou chave foi revogada ou expirada. Para OAuth, repita o sinal com aprovação do proprietário; para CLI, execute flashdata auth status. Adicionar créditos não vai reparar a autenticação. |
| 403 | Verifique a permissão de origem solicitada. Pesquisa OAuth não inclui YouTube Download; use sua configuração API-chave. Conserte a permissão antes de tentar novamente. |
| 402 | Verifique get_balance ou saldo de contas flashdata. Adicione créditos em Billing ou pare a tarefa; assinar novamente não adiciona créditos. |
| 429 | Espere pelo Retry-After e reduza a concorrência. Preservar o perfil atual e a prova de registro, não criar testes de substituição. |
| MCP local não pode ler a chave | Defina FLASHDATA_API_KEY onde o processo do host começa e reiniciá-lo. Uma chave salva por flashdata auth login não é automaticamente exportada para MCP local. |
| O arquivo de saída CLI já existe | Leia ./openclaw-first-search.json. Para exportar o sucesso salvo novamente, use flashdata runs show openclaw- primeira pesquisa...001 --result --output openclaw-first-search-copy.json com o perfil original. Use uma nova corrida ID apenas para uma nova busca pretendida. |
| A tarefa agendada falhou | Faça a verificação de reutilização gratuita dentro daquele ambiente. Combine com o usuário OS, perfil de host, a loja de credenciais e permissões de ferramentas. |
| Tempo limite ou resultado desconhecido | Mantenha o pedido ou trabalho ID e verifique History antes de reenviar. Use get_result para continuar IDs. |
Notas de validação do OAuth
OAuth login, callback, credenciais salvas, uma chamada de preços grátis, atualização e revogação foram verificadas no Windows com OpenClaw 2026.10.5 no 2026-10-21. Essa corrida não validou as consultas pagas ou a execução agendada. As instruções de configuração foram verificadas com a documentação do host no 2026-11-05.