Обзор документации
Руководства
Повторное использование одобренного доступа, выполнение одного поиска в запланированном случае и восстановление без случайной отправки одной и той же работы.
На этой странице
Выберите, как выполняется задача
Ваш хост-агент или планировщик 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_KEYset -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Запускайте это в новом запланированном сеансе. Пусть хост повторно использует и обновляет свои утвержденные учетные данные OAuth. Он должен быть в состоянии достичь FlashData без интерактивного входа в систему при каждом запуске.
Повторное использование существующего соединения FlashData MCP в этой запланированной среде.
Звоните get_balance с {}.
Звоните get_pricing с {"source":"google_search","request_count":1}.
Сообщите о балансе и предполагаемой цене. Не ищите и не создавайте новый доступ.CLI: Сохранить одну задачу на случай
Создайте папку задач ниже, а затем сохраните request.json и run-research.sh внутри нее. Держите эту папку отдельно от существующего государственного каталога учетных данных. Одна дата представляет собой один запрос Google; число определяет количество результатов. Дайте другому рабочему процессу свой собственный префикс run-ID перед его первым исполнением.
mkdir -p flashdata-research
cd flashdata-research{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}Скачать run-research.sh
Создайте run-research.sh рядом с request.json в папке задач. Скопируйте полный сценарий ниже в него и сохраните его перед запуском или планированием задачи.
Сценарий замораживает вход для каждой даты и сохраняет квитанцию, результат и файл ошибок для каждой попытки. Только успешные попытки публикации result.json и receipt.json на верхнем уровне датированной папки. --recurring проверяет доступ владельца; он не создает расписание.
#!/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 немедленно; после перезапуска прочитайте принятую работу вместо повторного поиска.
Используйте оригинальное появление планировщика 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.
{
"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 с этими переменными среды без модели.
Запустите одобренную исследовательскую задачу 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 отключает автоматическое объявление; орган по задачам также ведет локальные отчеты.
: "${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" --json3. Включить после проверки выход
Просмотрите сохраненный агент, расписание, часовую зону и завершенный тест. Включается только после того, как выпуск будет правильным и повторные затраты будут утверждены. Отключение позже останавливает будущие вызовы; это не отменяет уже представленный запрос.
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --jsonopenclaw automations enable "$OPENCLAW_JOB_ID"openclaw automations disable "$OPENCLAW_JOB_ID"Установить правила затрат и отказов
| Положение | Меры |
|---|---|
| Планирование расходов | Цена за запрос × запланированные события. Добавьте модель и стоимость хоста отдельно; подсчет результатов не является подсчетом запросов. |
| Баланс по общему счету | Установите свой бюджет в планировщике или хосте. Эти примеры не накладывают отдельного ключевого ограничения расходов. |
| 401 / 403 / 402 | Приостановите будущие рассылки. Исправьте учетные данные, разрешение или баланс; возобновите с исходным событием и сохраненным состоянием. |
| 429 | Уважайте Retry-After. Проверяйте запуск CLI или появление MCP, прежде чем решить, является ли новая заявка безопасной. |
| Неизвестный результат подачи | Сохрани спасенное государство и остановись. Восстановите известную работу ID; не создавайте новый запуск ID, чтобы обойти неопределенность. |
Остановить расписание и отозвать доступ отдельно
- Приостановите планировщик, чтобы остановить будущие призывы.
- Отмените соединение с агентом, приложение OAuth или ключ API на консоли. Отзыв блокирует новое аутентифицированное использование; он не стирает экспортированные файлы.
- Повторите бесплатную проверку доступа из нового процесса. Он должен провалиться после отзыва. CLI auth logout удаляет только локальные учетные данные; он не отменяет удаленный доступ.