Перейти к содержимому
RU
Ключ API
Обзор документации

Интеграции

OpenClaw

Предоставьте вашему агенту OpenClaw инструменты Google Search и YouTube для исследований и периодических брифингов.

На этой странице

Прежде чем начать

OpenClaw установлен и работает. Эта размещенная настройка MCP использует OAuth для Google Search, YouTube Search, метаданных и транскриптов. Вы можете создать учетную запись FlashData во время входа.

1. Добавить сервер MCP

Запустите это на машине и в профиле OpenClaw, который запускает шлюз. Он сохраняет конфигурацию сервера; вход в систему и вызов инструмента ниже подтверждают, что ваш агент действительно может использовать его. Используйте тот же профиль для каждой команды на этой странице.

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. Войти

Запустите команду входа. В браузере войдите или создайте и проверьте учетную запись, а затем одобрите доступ. Подождите, пока терминал подтвердит логин. Запросы используют кредиты этого счета.

Войти
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
Найти подходящие видео YouTubeyoutube_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 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами.

Отменить или восстановить

  1. Приостановите выполнение запланированных задач, а затем отмените подключение OAuth в FlashData Settings → Connected apps.
  2. Попросите агента позвонить get_balance один раз с сохраненным соединением. Он должен потерпеть неудачу в аутентификации или попросить восстановить соединение. Не одобряйте новый логин во время этой проверки.
  3. Удалите локальные учетные данные OAuth с помощью команды ниже. Чтобы позже восстановить соединение, повторите шаг 2 с одобрением владельца и запустите бесплатную проверку соединения.
Удалить сохраненные учетные данные OAuth
openclaw mcp logout flashdata

Больше вариантов настройки

Добавьте навыки рабочего процесса в соединение MCP или выберите доступ к CLI или локальный сервер MCP.

Добавить навык MCP

Навык flashdata-mcp учит вашего агента, как использовать подключенные инструменты. Он повторно использует соединение выше.

С Node.js 22.20+ и npm запустите это в активном рабочем пространстве OpenClaw. Полное мастерство сохраняется в skills/flashdata-mcp. Начните новый разговор и попросите использовать flashdata-mcp.

В вашем рабочем пространстве OpenClaw
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.

Установите навыки работы CLI
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.

1. Импорт и проверка ключа
flashdata auth login
flashdata auth status --json --non-interactive
2. Проверить баланс и стоимость — без поиска
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# Продолжить только в том случае, если accessVerified и estimateAvailable являются true,
# google_search разрешен, а availableCredits покрывает estimatedCredits.
3. Скачать ./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

# Прочитайте сохраненный файл: 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.

1. Установите ключ, не печатая его
# 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. Регистрация и зондирование в профиле шлюза
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

устранение неполадок

ПроблемаПопробуйте
Нет инструментов 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.