Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Запуск рецидивних задач агента

Запобігання затвердженого доступу, запускати один пошук за заплановане виникнення, і відновити без випадкового подання такої ж роботи знову.

На цій сторінці

Виберіть, як працює завдання

Ваш агент хост або OS графік подає термін дії. FlashData постачає дані. Виберіть один шлях виконання і перевірте його в середовищі, яка буде працювати ненавченою.

ЗареєструватисяДляДержавне консервування
CLIЗасіб з доступом терміналу, кроном або плановим скриптом.Профіль 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; num встановлює кількість результатів. Подаруйте різну робочу опалубку власного запуску 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. Persist 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-запуск-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 з змінними середовищами без моделі.

recurring-task.txt
Запустіть затверджене завдання дослідження FlashData під користувачем OS, який зберіг ключ.
Килим Лущув: <absolute path to run-research.sh>
Встановити ці змінні середовища для процесу бігуна:
FLASHDATA_BIN: <абсолютний шлях до флешки>
FLASHDATA_PROFILE: <existing name профілю>
FLASHDATA_STATE_DIR: <випробування абсолютних державних каталогів>
Зберігати FLASHDATA_API_KEY unset для повторного використання збереженого облікового запису.
Використовуйте початкову заплановану дату в Asia/Shanghai, як YYYY-MM-DDDD.
Для ручного виконання, збереження дати вступу перед виконанням.
Запуск: bash "<absolute path to run-research.sh>" YYYY-MM-DDDD
Зберігайте дату на речення, навіть після опівночі. Дозволити одну активне виконання.
Зберігати той самий профіль, 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

Перевірте час або невдалий тест

Час очікування, не завдання шлюзу. Читання недавнього історії, якщо отримання є порожнім. Встановіть 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 тільки видаляє локальні облікові дані; він не відкликає віддалений доступ.