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

Руководства

Запуск повторяющихся задач агента

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

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

Выберите, как выполняется задача

Ваш хост-агент или планировщик OS предоставляет время. FlashData предоставляет данные. Выберите один путь выполнения и протестируйте его в среде, которая будет работать без присмотра.

ИспользоватьДляГосударство должно сохранить
CLIАгент с доступом к терминалу, cron или запланированным сценарием.Профиль CLI, каталог состояния и оригинальный запуск ID.
MCPХост-агент с подключенным сервером FlashData.Удостоверения хозяина, запись о нахождении, работа IDs и результаты.

Проверка доступа в запланированной среде

Повторное использование существующего соединения с разрешением google_search. Заявить временный доступ перед повторным использованием. Тестирование с помощью нового запланированного процесса или сессии, а не только интерактивного.

Используйте Bash и jq (Git Bash на Windows), под пользователем OS, который сохранил ключ. Установите свое существующее имя профиля и абсолютный каталог состояния ниже. Запустите оба блока в одном терминале; бегун повторно использует эти настройки.

Для проверки доступа необходимо распечатать true. Сравните availableCredits с estimatedCredits перед первым поиском. Эти чеки не представляют запрос.

Настройте сохраненное соединение
# Use the profile and state directory that already hold your owner key.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export FLASHDATA_BIN="$(command -v flashdata)"
unset FLASHDATA_API_KEY
Бесплатный доступ, баланс и контроль цен
set -euo pipefail
export FLASHDATA_BIN="${FLASHDATA_BIN:-$(command -v flashdata)}"
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
test -d "$FLASHDATA_STATE_DIR" || { echo 'Existing state directory not found.' >&2; exit 1; }
"$FLASHDATA_BIN" --version
jq --version
"$FLASHDATA_BIN" auth status --profile "$profile" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive |
  jq -e '.ok and .data.accessVerified
    and (.data.identity.identity.recurringAllowed == true)
    and (.data.identity.permittedSources | index("google_search") != null)'
"$FLASHDATA_BIN" account balance --profile "$profile" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
"$FLASHDATA_BIN" account pricing --source google_search --request-count 1 \
  --profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive

CLI: Сохранить одну задачу на случай

Создайте папку задач ниже, а затем сохраните request.json и run-research.sh внутри нее. Держите эту папку отдельно от существующего государственного каталога учетных данных. Одна дата представляет собой один запрос Google; число определяет количество результатов. Дайте другому рабочему процессу свой собственный префикс run-ID перед его первым исполнением.

Создайте папку задач
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

Скачать run-research.sh

Создайте run-research.sh рядом с request.json в папке задач. Скопируйте полный сценарий ниже в него и сохраните его перед запуском или планированием задачи.

Сценарий замораживает вход для каждой даты и сохраняет квитанцию, результат и файл ошибок для каждой попытки. Только успешные попытки публикации result.json и receipt.json на верхнем уровне датированной папки. --recurring проверяет доступ владельца; он не создает расписание.

run-research.sh
#!/usr/bin/env bash
set -euo pipefail
umask 077
slot=${1:?Pass the scheduled date as YYYY-MM-DD}
[[ "$slot" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || exit 2
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
cd -- "$(dirname -- "$0")"
dir="runs/$slot"
mkdir -p "$dir"
if [[ -e "$dir/request.json" ]]; then
  cmp -s request.json "$dir/request.json" || {
    echo 'Input changed for this slot. Inspect its saved run.' >&2; exit 1;
  }
else
  (set -C; cat request.json > "$dir/request.json")
fi
attempt=$(mktemp -d "$dir/attempt.XXXXXX")
if ! "$FLASHDATA_BIN" query --input "$dir/request.json" --recurring \
  --run-id "scheduled-research:$slot:Asia-Shanghai" \
  --profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" \
  --output "$attempt/result.json" --timeout 2m --json --non-interactive \
  > "$attempt/receipt.json" 2> "$attempt/error.json"; then
  cat "$attempt/error.json" >&2
  exit 1
fi
jq -e '.ok == true' "$attempt/receipt.json" >/dev/null
jq -e '.source == "google_search" and .status == "done"
  and (.results[0].organic | type == "array")' "$attempt/result.json" >/dev/null
# Publish a stable path only after the query and its receipt both succeed.
cp "$attempt/result.json" "$dir/result.next.json"
mv "$dir/result.next.json" "$dir/result.json"
cp "$attempt/receipt.json" "$dir/receipt.next.json"
mv "$dir/receipt.next.json" "$dir/receipt.json"
jq '{runId, cached, usage}' "$attempt/receipt.json"
printf 'Saved result: %s\n' "$dir/result.json"

Запустите один раз, а затем протестируйте повторный процесс

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

Одно событие – два процесса начинаются
# Use the date of the intended occurrence, including on retries.
bash run-research.sh 2026-11-04

# Same account, input, profile and state: reuse the completed run.
bash run-research.sh 2026-11-04

Подтвердить, что результат был повторно использован

На втором чеке должен быть указан cached: true. Его использование относится к оригинальному поиску. Пустая органическая матрица может быть успешным результатом.

Проверить сохраненный результат и получение
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
Вторая квитанция · выдержка
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}

Держите файлы между запусками

ФайлИспользовать
runs/DATE/request.jsonТочный вход для этого события; изменение его делает бегуна остановленным.
runs/DATE/result.json + receipt.jsonПоследняя успешная попытка. Потребляйте их только после того, как текущая команда успешно выйдет.
runs/DATE/attempt.*/Результат, квитанция и ошибка для каждой попытки, включая сбои.
FLASHDATA_STATE_DIRЗащищенные учетные данные и CLI запускают записи. Поддерживайте тот же профиль и пользователя OS.

MCP: сохраняйте нахождение и работу ID

Используйте этот целевой орган с хостом, который поддерживает устойчивое состояние задачи и позволяет выполнять одну активную работу за событие. Сохраните возвращенную работу ID немедленно; после перезапуска прочитайте принятую работу вместо повторного поиска.

Повторяющаяся задача MCP · сохранение как recurring-task.txt
Используйте оригинальное появление планировщика ID и запланированное время.
Повторно используйте существующее соединение FlashData MCP и сохраните запись возникновения.
1. Если это событие завершено, верните его сохраненный результат без поиска.
2. Если у него есть работа ID, позвоните get_job с этим job_id, чтобы прочитать существующую работу.
3. Если заявка началась, но не имеет результата или работы ID, остановитесь для рассмотрения.
4. Для нового случая проверьте get_balance и get_pricing для одного google_search.
   Продолжить только в рамках утвержденного бюджета на одну задачу и имеющегося остатка средств.
5. Нажмите submission_started, прежде чем звонить google_search один раз:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Немедленно сохраните возвращенную работу ID. Прочитайте его с помощью get_job до терминала; остановитесь на отказе.
   Держите ID в тайм-ауте и перестаньте ждать в крайний срок хоста.
7. Сохраните результат, источник URLs и использование, затем отметьте это событие полным.
На 401, 403, 402, 429 или неизвестном исходе остановитесь и сообщите о сохраненной записи.
Честь Retry-After. Не создавайте доступ к замене или другой платный запрос.
Держите отчет локальным; используйте пункт назначения доставки только в том случае, если он настроен отдельно.

Что должен сохранять хозяин

Одно только подсказка не может предотвратить дубликаты. Звонки MCP не наследуют защиту CLI run-ID. Ваш хост должен сохранять исходное состояние, состояние представления и работу ID. Если это невозможно, используйте бегун CLI для шага данных. Этот пример принадлежит вашему хосту; это не запрос MCP.

Host Record - иллюстративный
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}

Расписание тестируемой задачи

В приведенном ниже примере используется OpenClaw в 09:00 Asia/Shanghai. Создайте работу с ограниченными возможностями, запустите ее вручную, проверьте ее выход, а затем включите ее. Для другого планировщика следуйте той же последовательности с его контрольными элементами.

настройкаИспользовать
параллелизмОдно активное исполнение для этого рабочего процесса, с прочным состоянием.
Время выполненияИспользуйте тот же пользователь OS и абсолютные пути для CLI, папки задач и состояния учетных данных. Экспорт терминалов не наследуется автоматически работающим шлюзом.
петлиСохраняйте первоначальную дату, в том числе после полуночи. В ручном тесте используется дата вызова в Asia/Shanghai.
Пропущенные происшествияВыберите, пропустить или догнать. Поисковый запрос сегодня возвращает текущие данные, даже если они помечены вчерашней датой.
ДоставкаЭкономьте сначала локально. Настройка политики назначения и уведомления перед отправкой отчетов.

CLI - целевой орган для хоста-агента

Замените заполнители профиля и пути, а затем сохраните recurring-task.txt в папке задач. Используйте это тело для выполнения CLI или тело MCP выше для выполнения MCP. Планировщик прямого OS может запускать скрипт Bash с этими переменными среды без модели.

recurring-task.txt
Запустите одобренную исследовательскую задачу FlashData под пользователем OS, который сохранил ключ.
Бегущий: <абсолютный путь к run-research.sh>
Установите эти переменные среды для процесса бегуна:
FLASHDATA_BIN: <абсолютный путь к флешдантам>
FLASHDATA_PROFILE: <существующее имя профиля>
FLASHDATA_STATE_DIR: <существующий абсолютный каталог состояния>
Держите FLASHDATA_API_KEY отключенным для повторного использования сохраненных учетных данных.
Используйте оригинальную дату в Asia/Shanghai, как YYYY-MM-DD.
Для ручного запуска сохраните дату его вызова перед выполнением.
Бег: bash "<absolute path to run-research.sh>" YYYY-MM-DD
Держите эту дату на повторных записях, даже после полуночи. Допустим одно активное исполнение.
Сохраняйте тот же профиль, request.json и государственный каталог.
Только прочитайте датированный result.json после успешного выхода команды.
Ссылки на источники отчетов, запуск ID и использование. Держите выходы локальными.
Ошибка: остановитесь и сообщите об ошибке. Не начинайте работу по замене или созданию нового доступа.

1. Создайте работу OpenClaw с ограниченными возможностями

Используйте работающий шлюз и существующий агент, прошедший проверку доступа. В приведенных ниже командах используется OpenClaw 2026.10.10; обновление старых клиентов, если --wait недоступен. В папке, содержащей recurring-task.txt, установите OPENCLAW_AGENT_ID на ID этого агента.

Команда сохраняет openclaw-job.json без перезаписи существующего файла. Прочитайте его и установите OPENCLAW_JOB_ID на возвращаемую работу ID. Если творение теряет свой отклик, проверьте список автоматизации --all --json перед созданием другой работы. --no-deliver отключает автоматическое объявление; орган по задачам также ведет локальные отчеты.

Bash – создание инвалидной работы
: "${OPENCLAW_AGENT_ID:?Set the existing OpenClaw agent ID}"
test -s recurring-task.txt || exit 1
# Keep the receipt. An existing file blocks accidental recreation.
(
  set -o noclobber
  openclaw automations add --name flashdata-daily-research \
    --agent "$OPENCLAW_AGENT_ID" \
    --cron "0 9 * * *" --tz Asia/Shanghai --exact \
    --session isolated --disabled --no-deliver \
    --message "$(cat recurring-task.txt)" --json > openclaw-job.json
)

2. Проверьте сохраненную работу, прежде чем разрешить ее

Выполните сохраненную работу один раз, пока ее график остается отключенным. Бюджет на один тестовый поиск и стоимость модели; совпадение завершенного события CLI может повторно использовать его результат. Эта команда дожидается до 10 минут.

Ожидайте, что completionStatus: преуспел, а затем проверьте сохраненный результат, исходные ссылки и использование. Для CLI читайте runs/DATE/result.json и receipt.json; для MCP читайте сохраненное появление хоста и результат работы. enqueued: true сам по себе означает принятый, а не завершенный.

Бег один раз · Сохранить тестовую квитанцию
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
# Run the saved job once; its schedule stays disabled.
(
  set -o noclobber
  openclaw automations run "$OPENCLAW_JOB_ID" \
    --wait --wait-timeout 10m --json > openclaw-test-run.json
)
Прочитайте квитанцию об испытании
cat openclaw-test-run.json

Проверить тайм-аут или неудачный тест

Тайм-аут перестает ждать, а не задача Gateway. Прочитайте историю, если квитанция пуста. Установите OPENCLAW_RUN_ID в OpenClaw runId из квитанции или истории, а затем проверьте это исполнение. Не повторяйте команду запуска, чтобы проверить прогресс.

Это исполнение планировщика ID, а не повторяющийся запуск FlashData ID или работа с данными MCP ID. Если агент не смог войти в систему или выполнить задачу с данными, отключите расписание и исправьте этот шаг.

Проверяйте то же самое исполнение
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
cat openclaw-test-run.json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json

# Set this from the receipt or history; this is OpenClaw's run ID.
: "${OPENCLAW_RUN_ID:?Set the OpenClaw test run ID}"
openclaw automations runs "$OPENCLAW_JOB_ID" \
  --run-id "$OPENCLAW_RUN_ID" --json

3. Включить после проверки выход

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

Просмотреть сохраненную работу и проверить историю
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json
Включите ежедневное расписание
openclaw automations enable "$OPENCLAW_JOB_ID"
Пауза в будущем, когда это необходимо
openclaw automations disable "$OPENCLAW_JOB_ID"

Установить правила затрат и отказов

ПоложениеМеры
Планирование расходовЦена за запрос × запланированные события. Добавьте модель и стоимость хоста отдельно; подсчет результатов не является подсчетом запросов.
Баланс по общему счетуУстановите свой бюджет в планировщике или хосте. Эти примеры не накладывают отдельного ключевого ограничения расходов.
401 / 403 / 402Приостановите будущие рассылки. Исправьте учетные данные, разрешение или баланс; возобновите с исходным событием и сохраненным состоянием.
429Уважайте Retry-After. Проверяйте запуск CLI или появление MCP, прежде чем решить, является ли новая заявка безопасной.
Неизвестный результат подачиСохрани спасенное государство и остановись. Восстановите известную работу ID; не создавайте новый запуск ID, чтобы обойти неопределенность.

Остановить расписание и отозвать доступ отдельно

  1. Приостановите планировщик, чтобы остановить будущие призывы.
  2. Отмените соединение с агентом, приложение OAuth или ключ API на консоли. Отзыв блокирует новое аутентифицированное использование; он не стирает экспортированные файлы.
  3. Повторите бесплатную проверку доступа из нового процесса. Он должен провалиться после отзыва. CLI auth logout удаляет только локальные учетные данные; он не отменяет удаленный доступ.