# OpenClaw

Podaj swoje narzędzia OpenClaw agentowi Google Search i YouTube do badań i powtarzających się odpraw.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/integrations/openclaw
Przegląd: 2026-11-05 przez FlashData

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

## Zanim zaczniesz

Czy OpenClaw zainstalowane i działa. Ten hostowany konfiguracja MCP wykorzystuje OAuth dla Google Search, YouTube Search, Metadane i Transkrypty. Możesz utworzyć konto FlashData podczas sign- in.

- [Użyj umiejętności CLI lub rozpocznij proces](https://flashdata.dev/pl/docs/integrations/openclaw/reference.md#cli)
- [Zainstaluj OpenClaw](https://docs.openclaw.ai/start/getting-started)

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

## 1. Dodaj serwer MCP

Uruchom to na maszynie i profilu OpenClaw, który uruchamia bramę. Zapisuje konfigurację serwera; logowanie i wywołanie narzędzia poniżej weryfikuje, czy Twój agent może go używać. Użyj tego samego profilu dla każdego polecenia na tej stronie.

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

Uruchom polecenie logowania. W przeglądarce zaloguj się lub utwórz i weryfikuj konto, a następnie zatwierdzaj dostęp. Poczekaj, aż terminal potwierdzi logowanie. Zapytania wykorzystują kredyty tego konta.

### Zaloguj się

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


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

### Sprawdź połączenie za darmo

Otwórz nową rozmowę w Interfejsie sterowania lub podłączonym kanale czatu. Wyślij ten sygnał; oba połączenia powinny odnieść sukces. Udana sonda rejestracyjna sama w sobie nie dowodzi, że ta rozmowa może korzystać z narzędzi.

#### Wklej do swojego agenta

```text
Użyj połączenia flashdata MCP.
Zadzwoń do get_balance z {} i get_pricing z {"source":"google_search","request_count":1}.
Proszę podać dostępne kredyty i szacunkową cenę. Nie przeszukuj.
```


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

## 3. Uruchom swoje pierwsze zadanie

Wyślij to do swojego powiązanego agenta. Kontrole są darmowe; pojedyncze wyszukiwanie wykorzystuje kredyty.

### Pierwszy sygnał zadania

```text
Użyj serwera flashdata MCP. Sprawdź moją równowagę i cenę jednego wyszukiwania Google.
Jeśli sfinansowane, zadzwoń raz do google_search z zapytaniem "battery recycling research", num 5 i tryb "realtime".
Daj mi krótką odprawę z tytułami źródłowymi, URLs i fragmentami.
Zacytować źródła i zgłosić rzeczywiste kredyty wykorzystane. Przestań po tym zadaniu.
```


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

### Co powinieneś zobaczyć

Poszukaj zakończonego połączenia z narzędziami google_search z status: done, linków źródłowych z results[].organic i odpowiedzi opartej na tych źródłach. Zastosowanie pochodzi z usage.credits; nie jest to liczba wyników. Puste wyniki należy zgłaszać jako puste.

- [Sprawdź historię żądań](https://flashdata.dev/app/jobs)

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

## O co możesz prosić?

To połączenie OAuth obejmuje narzędzia badawcze. YouTube Download używa właściciela klucza API i pamięci docelowej za pośrednictwem API lub CLI.

| Zadanie | Narzędzie MCP |
| --- | --- |
| Znajdź źródła internetowe dla odpowiedzi lub realizacji | google_search |
| Znajdź odpowiednie filmy YouTube | youtube_search |
| Czytaj tytuły, kanały i metadane wideo | youtube_metadata |
| Pobierz zapis wideo do podsumowania | youtube_transcript |
| Sprawdź dostępne kredyty i koszty żądania | get_balance · get_pricing |

- [Narzędzia i schematy MCP](https://flashdata.dev/pl/docs/mcp/reference.md)
- [Konfiguracja YouTube Download](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)

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

## Ponowne wykorzystanie dostępu do powtarzających się zadań

Użyj profilu OpenClaw i agenta, który przeszedł pierwsze zadanie. Planowane operacje bramki muszą mieć takie samo połączenie MCP i uprawnienia narzędzia jak Twój czat.


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

### Weryfikacja zapisanego dostępu

Uruchom ten bezpłatny czek w świeżej sesji w planowanym środowisku. Oba połączenia powinny odnieść sukces bez nowego logowania przeglądarki.

#### Kontrola ponownego użycia

```text
Ponownie użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_balance z {} i get_pricing z {"source":"google_search","request_count":1}.
Zgłoście, czy obu się udało. Nie wyszukuj ani nie twórz nowego dostępu.
```


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

### Utwórz powtarzające się zadanie

W harmonogramie hosta wybierz strefę czasu i czasu, na przykład codziennie w 09:00 Asia/Shanghai. Użyj tego jako organu zadaniowego. Uruchom go raz tam i sprawdź zapisany raport przed włączeniem powtórzenia.

#### Organ zadaniowy

```text
Ponownie użyj istniejącego połączenia flashdata MCP. Sprawdź get_balance i get_pricing dla jednego wyszukiwania Google.
Jeśli jest to dozwolone i finansowane, uruchom google_search raz dla "battery recycling research" z num 5 i tryb "realtime".
Zapisz raport datowany ze źródłami URLs, fragmentami i rzeczywiście wykorzystanymi kredytami.
Zatrzymaj cofnięty dostęp lub niewystarczający kredyt; szanuj Retry-After. Nie tworzyć procesu, zażądać nowego autoryzacji lub powtórzyć wniosek, którego wynik jest nieznany.
```

- [Nawracający przewodnik zadaniowy](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)
- [Harmonogram i odzysk CLI](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#recurring)

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

### Przechowywanie i odświeżanie kred

Ta konfiguracja używa OpenClaw współdzielone przez operatora OAuth połączenie. Dozwolone uczestnikom czatu i zaplanowanym biegom używać tego konta FlashData i jego salda. Nie zapewnia oddzielnego rachunku dla każdego nadawcy.

Host odświeża jednogodzinne żetony dostępu OAuth za pomocą obrotowych żetonów odświeżających. Uzupełnić po wygaśnięciu lub cofnięciu grantu na dzień 90-. Każda instalacja jest właścicielem sklepu z żetonami; nie udostępniaj plików z symbolami odświeżania pomiędzy hostami.


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

### Odrodzenie lub ponowne połączenie

1. Wstrzymaj zaplanowane zadania, a następnie cofnij połączenie OAuth w FlashData Settings → Connected apps.
2. Poproś agenta, aby zadzwonił do get_balance raz z zapisanym połączeniem. Powinno nie być uwierzytelniania lub poprosić o ponowne połączenie. Nie zatwierdzaj nowego logowania podczas tej kontroli.
3. Usuń lokalne referencje OAuth z poniższym poleceniem. Aby ponownie połączyć się później, powtórz krok 2 z zatwierdzeniem właściciela i uruchom bezpłatne sprawdzenie połączenia.

#### Usuń zapisane referencje OAuth

```bash
openclaw mcp logout flashdata
```

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

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

## Więcej opcji konfiguracji

Dodaj umiejętności przepływu pracy do połączenia MCP lub wybierz dostęp CLI lub lokalny serwer MCP.


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

### Dodaj umiejętność MCP

Umiejętność flashdata- mcp uczy Twojego agenta jak używać podłączonych narzędzi. Ponownie wykorzystuje połączenie powyżej.

Z Node.js 22.20 + i npm, uruchom to w aktywnej przestrzeni roboczej OpenClaw. Pełna umiejętność jest zapisywana do skills/flashdata-mcp. Rozpocznij nową rozmowę i poproś o użycie flashdata- mcp.

#### W przestrzeni roboczej OpenClaw

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

- [Instalacja CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)
- [Przeczytaj umiejętność MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Uaktualnianie lub usuwanie umiejętności](https://flashdata.dev/pl/docs/guides/agent-skill-management/reference.md)

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

### Użyj umiejętności CLI lub rozpocznij proces

Zainstaluj FlashData CLI v1.2.1 i uruchom od aktywny obszar roboczy OpenClaw. Wybierz jedną kartę dostępu. Przykłady używają domyślnego profilu CLI, oddzielonego od MCP OAuth; zachowuj istniejący profil --profile i --state-dir, jeśli używasz własnych.

Zainstaluj dwie poniższe umiejętności za pomocą Node.js 22.20+ i npm. Następnie rozpocznij nową rozmowę w OpenClaw. Polecenie setup natywnego CLI nie konfiguruje OpenClaw.

#### Zainstaluj umiejętności przepływu pracy CLI

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

#### Istniejący klucz API

Wklej klawisz za zgodą google_search na ukryty sygnał. Dla importu bez nadzoru, prześlij go ze swojego tajnego menedżera do auth login --api-key-stdin --non-interactive.

##### 1. Importuj i weryfikuj klucz

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


#### Uratowano dostęp CLI

Ponownie użyj istniejącego klucza lub procesu. Jeśli jest ustawiony FLASHDATA_API_KEY, ma pierwszeństwo przed zapisanym kluczem; weryfikuje konto pokazane przez auth status.

##### 1. Ponowne wykorzystanie i weryfikacja zapisanego dostępu

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


#### Kwalifikowalne badanie

Ponowne użycie istniejącego procesu lub rejestracji raz. W przypadku wygaśnięcia, wyczerpania lub cofnięcia, odzyskania lub żądania. Przed powtarzającymi się zadaniami CLI, żądaj konta i potwierdź recurringAllowed: true w auth status.

##### 1. Ustaw i weryfikuj dostęp do procesu

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


- [Pobierz CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalacja CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)
- [Odzyskiwanie zapisanego wyniku](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#recover)
- [Zaskarżyć przed powtarzającymi się zadaniami CLI](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)

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

### Uruchom lokalne MCP za pomocą klawisza API

Wymaga Node.js 22.18 +, npm i klawisza API z pozwoleniem google_search na pierwsze zadanie. To działa @ flashdata-dev/mcp 0.2.0; nie odczytuje zapisanego klucza FlashData CLI lub żetonów MCP OAuth.

Ustaw klucz w środowisku, które faktycznie prowadzi bramę. Poniższy sygnał dotyczy bramki uruchomionej terminowo; w przypadku usługi lub kontenera należy wstrzyknąć FLASHDATA_API_KEY poprzez konfigurację secret/environment i ponownie uruchomić. Eksport klucza w innym terminalu nie będzie aktualizował usługi uruchomionej.

Po skonfigurowaniu, uruchom w nowej sesji agencyjnej darmowy podłączenie- sprawdź powyżej. Gdy obie kontrole przejdą, użyj pierwszego polecenia zadania. Dostęp do klucza API- nie wymaga logowania mcp.

#### Bash

##### 1. Ustaw klucz bez drukowania go

```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. Zarejestruj się i sonda w profilu bramy

```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. Ustaw klucz bez drukowania go

```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. Zarejestruj się i sonda w profilu bramy

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


- [Uruchom darmowe sprawdzenie połączenia](https://flashdata.dev/pl/docs/integrations/openclaw/reference.md#connection-check)
- [Utwórz klucz API](https://flashdata.dev/app/api-keys)
- [Lokalna dokumentacja MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Rozwiązywanie problemów

| Problem | Spróbuj tego |
| --- | --- |
| Brak narzędzi FlashData | Uruchom openclaw McP lekarz flashdata --probe. Sprawdź profil portalu i politykę agenta, a następnie otwórz nową rozmowę. |
| Brak umiejętności | Uruchom listę umiejętności openclaw --eligible i sprawdzaj umiejętności openclaw w profilu aktywnym. Sprawdź umiejętności / i listę umiejętności. |
| invalid_client / callback | Porównaj krok 1 dokładnie. Kompletna autoryzacja w przeglądarce, która może dotrzeć do wywołania hosta inicjującego. |
| 401 | Sprawdź, czy połączenie lub klucz zostały cofnięte lub wygasły. W przypadku OAuth, należy ponownie wpisać z zatwierdzeniem właściciela; w przypadku CLI należy uruchomić flashdata auth status. Dodawanie kredytów nie naprawi uwierzytelniania. |
| 403 | Sprawdź wymagane zezwolenie na korzystanie ze źródła. Badania OAuth nie zawiera YouTube Download; użyj jego ustawienia klucza API-. Napraw pozwolenie przed ponownym próbami. |
| 402 | Sprawdź stan konta get_balance lub flashdata. Dodawanie kredytów w Billing lub zatrzymanie zadania; ponowne wpisanie nie dodaje kredytów. |
| 429 | Poczekaj na Retry-After i zmniejszyć współwartość. Zachowaj obecny profil i dowód rejestracyjny; nie tworzyć prób zastępczych. |
| Lokalne MCP nie może odczytać klucza | Ustaw FLASHDATA_API_KEY gdzie rozpoczyna się proces hosta i uruchom go ponownie. Klucz zapisany przez flashdata auth login nie jest automatycznie eksportowany do lokalnego MCP. |
| Plik wyjściowy CLI już istnieje | Przeczytaj ./openclaw-first-search.json. Aby ponownie wyeksportować zapisany sukces, użyj flashdata runs show openclaw- first-search- 001 --result --output openclaw- first-search-copy.json z oryginalnym profilem. Używaj nowego uruchomienia ID tylko do zamierzonego nowego wyszukiwania. |
| Zaplanowane zadanie nie powiodło się | Wprowadź darmowe sprawdzenie ponownego użycia wewnątrz tego środowiska. Dopasuj użytkownika OS, profil hosta, sklep kredytowy i uprawnienia narzędzia. |
| Czas lub nieznany wynik | Przed ponownym uruchomieniem należy zachować polecenie lub zadanie ID i sprawdzić History. Należy użyć get_result, aby przywrócić kontynuację IDs. |

- [Przewodnik po odzyskiwaniu](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)
- [Dokumentacja OpenClaw MCP](https://docs.openclaw.ai/cli/mcp/transports)

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

## Uwagi do walidacji OAuth

OAuth login, callback, zapisane referencje, bezpłatne rozmowy cenowe, odświeżenie i cofnięcie zostały zweryfikowane na Windows z OpenClaw 2026.10.5 na 2026-10-21. Ta operacja nie potwierdzała płatnych zapytań ani zaplanowanej egzekucji. Instrukcje konfiguracji zostały sprawdzone w dokumentacji hosta 2026-11-05.

- [Oficjalne umiejętności](https://github.com/flashdatadev/flashdata-skills)
- [Pakiety MCP i źródło](https://github.com/flashdatadev/flashdata-mcp)
