Обзор документации
Интеграции
Предоставьте вашему агенту OpenClaw инструменты Google Search и YouTube для исследований и периодических брифингов.
На этой странице
Прежде чем начать
OpenClaw установлен и работает. Эта размещенная настройка MCP использует OAuth для Google Search, YouTube Search, метаданных и транскриптов. Вы можете создать учетную запись FlashData во время входа.
1. Добавить сервер MCP
Запустите это на машине и в профиле OpenClaw, который запускает шлюз. Он сохраняет конфигурацию сервера; вход в систему и вызов инструмента ниже подтверждают, что ваш агент действительно может использовать его. Используйте тот же профиль для каждой команды на этой странице.
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. Войти
Запустите команду входа. В браузере войдите или создайте и проверьте учетную запись, а затем одобрите доступ. Подождите, пока терминал подтвердит логин. Запросы используют кредиты этого счета.
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeПроверьте соединение бесплатно
Откройте новый разговор в интерфейсе управления или подключенном к нему канале чата. Отправьте запрос, оба вызова должны быть успешными. Успешное исследование реестра само по себе не доказывает, что этот разговор может использовать инструменты.
Используйте соединение флешдата MCP.
Звоните get_balance с {} и get_pricing с {"source":"google_search","request_count":1}.
Отчет о доступных кредитах и предполагаемой цене. Не запускайте поиск.3. Выполните свою первую задачу
Отправьте это своему агенту. Проверки бесплатны; в единственном поиске используются кредиты.
Используйте флеш-сервер MCP. Проверьте мой баланс и цену одного поиска Google.
При финансировании звоните google_search один раз с запросом "battery recycling research", num 5 и режимом "realtime".
Дайте мне краткий брифинг с заголовками источников, URLs и выдержками.
Приведите источники и сообщите об используемых фактических кредитах. Остановитесь после этой задачи.Что вы должны увидеть
Ищите заполненный вызов инструмента google_search с помощью status: done, ссылки на источник из results[].organic и ответ на основе этих источников. Использование исходит от usage.credits; это не количество результатов. Пустые результаты следует сообщать как пустые.
Что вы можете попросить
Это соединение OAuth охватывает инструменты исследования. YouTube Download использует ключ владельца API и хранилище назначения через API или CLI.
| Задание | Инструмент MCP |
|---|---|
| Найти веб-источники для ответа или реализации | google_search |
| Найти подходящие видео YouTube | youtube_search |
| Читайте названия видео, каналы и метаданные | youtube_metadata |
| Восстановление стенограммы видео для резюме | youtube_transcript |
| Проверьте доступные кредиты и стоимость запроса | get_balance · get_pricing |
Повторное использование доступа для повторяющихся задач
Используйте профиль и агент OpenClaw, прошедший первую задачу. Запланированные запуски шлюза должны иметь такое же соединение MCP и разрешения на использование инструментов, как и ваш чат.
Проверьте сохраненный доступ
Запустите эту бесплатную проверку в новой сессии в запланированной среде. Оба вызова должны быть успешными без входа в новый браузер.
Повторное использование существующих флеш-данных MCP.
Звоните get_balance с {} и get_pricing с {"source":"google_search","request_count":1}.
Сообщите, удалось ли обоим. Не ищите и не создавайте новый доступ.Создайте повторяющуюся задачу
В планировщике вашего хоста выберите время и часовой пояс, например, ежедневно в 09:00 Asia/Shanghai.. Используйте это в качестве органа. Запустите его один раз и проверьте сохраненный отчет, прежде чем разрешить повторение.
Повторное использование существующих флеш-данных MCP. Проверьте get_balance и get_pricing для одного поиска Google.
Если разрешено и профинансировано, запустите google_search один раз для "battery recycling research" с номером 5 и режимом "realtime".
Сохраните датированный отчет с использованием источника URLs, выдержек и фактических кредитов.
Остановитесь на отозванном доступе или недостаточном количестве кредитов; уважайте Retry-After. Не создавайте пробную версию, не запрашивайте новое разрешение и не повторяйте запрос, результат которого неизвестен.Полное хранение и обновление
Эта конфигурация использует совместно используемое соединение OAuth оператора OpenClaw. Разрешенные участники чата и запланированные запуски используют учетную запись FlashData и ее баланс. Он не предоставляет отдельного счета для каждого отправителя.
Хост обновляет одночасовые токены доступа OAuth с помощью вращающихся токенов обновления. Повторное подключение, когда срок действия гранта 90 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами.
Отменить или восстановить
- Приостановите выполнение запланированных задач, а затем отмените подключение OAuth в FlashData Settings → Connected apps.
- Попросите агента позвонить get_balance один раз с сохраненным соединением. Он должен потерпеть неудачу в аутентификации или попросить восстановить соединение. Не одобряйте новый логин во время этой проверки.
- Удалите локальные учетные данные OAuth с помощью команды ниже. Чтобы позже восстановить соединение, повторите шаг 2 с одобрением владельца и запустите бесплатную проверку соединения.
openclaw mcp logout flashdataБольше вариантов настройки
Добавьте навыки рабочего процесса в соединение MCP или выберите доступ к CLI или локальный сервер MCP.
Добавить навык MCP
Навык flashdata-mcp учит вашего агента, как использовать подключенные инструменты. Он повторно использует соединение выше.
С Node.js 22.20+ и npm запустите это в активном рабочем пространстве OpenClaw. Полное мастерство сохраняется в skills/flashdata-mcp. Начните новый разговор и попросите использовать flashdata-mcp.
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligibleИспользуйте навыки CLI или начните пробную версию
Установите FlashData CLI v1.2.1 и запустите Активное рабочее пространство OpenClaw. Выберите одну вкладку доступа. Примеры используют профиль CLI по умолчанию, отдельно от MCP OAuth; сохраняйте существующие --profile и --state-dir, если вы используете пользовательские.
Установите два навыка рабочего процесса ниже с Node.js 22.20+ и npm. Начните новый разговор OpenClaw после этого. Команда настройки CLI не нацелена на OpenClaw.
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligibleВставьте ключ с разрешением google_search в скрытую подсказку. Для необслуживаемого импорта переведите его от вашего секретного менеджера к 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
# Продолжить только в том случае, если accessVerified и estimateAvailable являются true,
# google_search разрешен, а availableCredits покрывает estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Прочитайте сохраненный файл: status, results[].organic, usage.credits.
# Терминал JSON сообщает о выходном пути; сохраняйте пробег ID для восстановления.Повторно используйте существующий ключ или пробную версию. Если FLASHDATA_API_KEY установлен, он имеет приоритет над сохраненным ключом; проверьте учетную запись, показанную 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
# Продолжить только в том случае, если accessVerified и estimateAvailable являются true,
# google_search разрешен, а availableCredits покрывает estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Прочитайте сохраненный файл: status, results[].organic, usage.credits.
# Терминал JSON сообщает о выходном пути; сохраняйте пробег ID для восстановления.Повторно использовать существующий процесс или зарегистрироваться один раз. Если срок истек, исчерпан или отменен, взыскать или потребовать его. Перед выполнением повторяющихся задач CLI заявляйте на учетную запись и подтвердите recurringAllowed: true в 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
# Продолжить только в том случае, если accessVerified и estimateAvailable являются true,
# google_search разрешен, а availableCredits покрывает estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Прочитайте сохраненный файл: status, results[].organic, usage.credits.
# Терминал JSON сообщает о выходном пути; сохраняйте пробег ID для восстановления.Запустите локальный MCP с помощью ключа API
Требуется Node.js 22.18+, npm и ключ API с разрешением google_search для первой задачи. Он работает под управлением @flashdata-dev/mcp 0.2.0; он не читает сохраненный ключ FlashData CLI или токены MCP OAuth.
Установите ключ в окружающей среде, который фактически управляет шлюзом. Ниже приведена подсказка для шлюза с терминалом; для службы или контейнера введите FLASHDATA_API_KEY через конфигурацию secret/environment и перезапустите его. Экспорт ключа в другой терминал не будет обновлять запущенную услугу.
После настройки запустите бесплатную подсказку проверки соединения выше в новой сессии агента. Как только обе проверки пройдут, используйте подсказку первой задачи. Для доступа к ключу API не требуется вход в систему 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 --probeустранение неполадок
| Проблема | Попробуйте |
|---|---|
| Нет инструментов FlashData | Запустите openclaw mcp Doctor flashdata --probe. Проверьте профиль шлюза и политику агента по инструментам, а затем откройте новый разговор. |
| Недостающие навыки | Запустите список навыков openclaw --eligible и проверьте навыки openclaw в активном профиле. Проверьте навыки рабочего пространства / и список навыков. |
| invalid_client / callback | Сравните шаг 1 точно. Полная авторизация в браузере, который может достичь обратного вызова инициирующего хоста. |
| 401 | Проверьте, было ли соединение или ключ отменены или истекли. Для OAuth повторите вход с одобрением владельца; для CLI запустите флеш-данные auth status. Добавление кредитов не восстановит аутентификацию. |
| 403 | Проверьте запрашиваемое разрешение источника. Исследование OAuth не включает YouTube Download; используйте его API-ключевую настройку. Установите разрешение перед повторным использованием. |
| 402 | Проверьте баланс учетной записи get_balance или флеш-данных. Добавьте кредиты в Billing или остановите задачу; вход снова не добавляет кредитов. |
| 429 | Подождите Retry-After и уменьшите параллелизм. Сохраняйте текущий профиль и регистрационное доказательство; не создавайте заменяющие испытания. |
| Местный MCP не может прочитать ключ | Установите FLASHDATA_API_KEY, где начинается процесс хоста, и перезапустите его. Ключ, сохраненный флэш-данными auth login, не экспортируется автоматически в локальный MCP. |
| Файл вывода CLI уже существует | Читать далее ./openclaw-first-search.json. Чтобы снова экспортировать сохраненный успех, используйте флешданные runs show openclaw-first-search-001 --result --output openclaw-first-search-copy.json с исходным профилем. Используйте новый запуск ID только для нового поиска. |
| Запланированное задание провалилось | Запустите бесплатную проверку повторного использования в этой среде. Сопоставьте пользователя OS, профиль хоста, хранилище учетных данных и разрешения на использование инструментов. |
| Тайм-аут или неизвестный результат | Сохраните запрос или работу ID и проверьте History перед повторной отправкой. Используйте get_result для возвратного продолжения IDs. |
Примечания к валидации OAuth
Логин OAuth, обратный вызов, сохраненные учетные данные, бесплатный вызов ценообразования, обновление и отзыв были проверены на Windows с OpenClaw 2026.10.5 на 2026-10-21. Этот запуск не подтвердил платные запросы или запланированное исполнение. Инструкции по настройке были проверены на соответствие документации хоста 2026-11-05.