# OpenClaw

Dê ao seu agente OpenClaw Google busca e ferramentas YouTube para pesquisa e instruções recorrentes.

Referência canônica: https://flashdata.dev/pt/docs/integrations/openclaw
2026-11-05 por FlashData

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

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

- [Use habilidades CLI ou comece um teste](https://flashdata.dev/pt/docs/integrations/openclaw/reference.md#cli)
- [Instale OpenClaw](https://docs.openclaw.ai/start/getting-started)

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

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

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

### Entrar

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


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

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

#### Colar em seu agente

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


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

## 3. Execute sua primeira tarefa

Envie isso para seu agente conectado. Os verificações são grátis, a única busca usa créditos.

### Primeiro pedido de tarefa

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


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

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

- [Inspecione o histórico de pedidos](https://flashdata.dev/app/jobs)

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

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

- [Ferramentas e esquemas MCP](https://flashdata.dev/pt/docs/mcp/reference.md)
- [Prepare YouTube Download](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md)

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

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


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

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

#### Reutilizar verificação

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


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

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

#### Corpo de Tarefas

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

- [Guia de tarefas recorrente](https://flashdata.dev/pt/docs/guides/recurring-tasks/reference.md)
- [CLI agendamento e recuperação](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#recurring)

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

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


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

### Revogar ou reconectar

1. Pause as tarefas agendadas, então revogue a chamada conexão OAuth em FlashData Settings → Connected apps.
2. 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.
3. 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.

#### Remova credenciais salvas de OAuth

```bash
openclaw mcp logout flashdata
```

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

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

## Mais opções de configuração

Adicione habilidades de fluxo de trabalho à sua conexão MCP, ou escolha acesso CLI ou um servidor MCP local.


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

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

#### Em seu espaço de trabalho OpenClaw

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

- [Instalação CLI](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#install)
- [Leia a habilidade MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Atualize ou remova habilidades](https://flashdata.dev/pt/docs/guides/agent-skill-management/reference.md)

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

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

#### Instale habilidades de fluxo de trabalho CLI

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

#### Chave API existente

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

##### 1. Importar e verificar a chave

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

##### 2. Verifique o saldo e o custo, sem buscas

```bash
flashdata 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.
```

##### 3. Corra uma vez, ./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

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


#### Acesso salvo para CLI

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.

##### 1. Reutilize e verifique o acesso salvo

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

##### 2. Verifique o saldo e o custo, sem buscas

```bash
flashdata 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.
```

##### 3. Corra uma vez, ./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

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


#### teste elegível

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.

##### 1. Prepare e verifique o acesso ao teste

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

##### 2. Verifique o saldo e o custo, sem buscas

```bash
flashdata 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.
```

##### 3. Corra uma vez, ./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

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


- [Baixar CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalação CLI](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#install)
- [Recupere um resultado salvo](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#recover)
- [vinculação antes de tarefas CLI recorrentes](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md)

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

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

##### 1. Defina a chave sem imprimi-la

```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. Registre-se e examine o perfil do portal

```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. Defina a chave sem imprimi-la

```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. Registre-se e examine o perfil do portal

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


- [Faça a verificação de conexão livre](https://flashdata.dev/pt/docs/integrations/openclaw/reference.md#connection-check)
- [Crie uma chave API](https://flashdata.dev/app/api-keys)
- [Documentação local do MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Soluçã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. |

- [Guia de recuperação](https://flashdata.dev/pt/docs/guides/agent-recovery/reference.md)
- [OpenClaw MCP documentação](https://docs.openclaw.ai/cli/mcp/transports)

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

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

- [Habilidades oficiais](https://github.com/flashdatadev/flashdata-skills)
- [Pacote MCP e fonte](https://github.com/flashdatadev/flashdata-mcp)
