Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Poradniki

Uruchom powtarzające się zadania agenta

Ponowne użycie zatwierdzonego dostępu, uruchomienie jednego wyszukiwania na zaplanowane zdarzenie i odzyskanie bez przypadkowego złożenia tej samej pracy ponownie.

Na tej stronie

Wybierz sposób działania zadania

Twój agent host lub OS terminarz dostarcza czas. FlashData dostarcza dane. Wybierz jedną ścieżkę wykonania i przetestuj ją w środowisku, które będzie działać bez nadzoru.

StosowanieDlaPaństwo do zachowania
CLIAgent z dostępem do terminala, cron, lub zaplanowany skrypt.Profil CLI, katalog stanu i oryginalny przebieg ID.
MCPAgent host z podłączonym serwerem FlashData.Kwalifikacje gospodarza, zapis zdarzeń, praca IDs i wyniki.

Sprawdź dostęp w planowanym środowisku

Ponownie użyj istniejącego połączenia właściciela za zgodą google_search. Uzyskanie tymczasowego dostępu przed ponownym użyciem. Test z nowego zaplanowanego procesu lub sesji, nie tylko interaktywnego.

Używaj Bash i jq (Git Bash na Windows) pod użytkownikiem OS, który zapisał klucz. Ustaw swoją istniejącą nazwę profilu i katalog stanu absolutnego poniżej. Uruchom oba bloki w tym samym terminalu; biegacz ponownie używa tych ustawień.

Kontrola dostępu musi wydrukować true. Porównaj availableCredits z estimatedCredits przed pierwszym wyszukiwaniem. Kontrole te nie składają zapytania.

Ustaw zapisane połączenie
# 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
Bezpłatny dostęp, równowaga i kontrola cen
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: zapisać jedno zadanie na zdarzenie

Utwórz folder zadań poniżej, a następnie zapisać request.json i run-research.sh wewnątrz niego. Przechowywać ten folder oddzielnie od istniejącego katalogu stanu kredytowego. Jedna data reprezentuje jedno zapytanie Google; num ustawia liczbę wyników. Dać inny przepływ pracy swój własny run- ID prefiks przed jego pierwszym wykonaniem.

Utwórz folder zadań
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

Zapisz run-research.sh

Utwórz run-research.sh obok request.json w folderze zadań. Skopiuj do niego cały skrypt poniżej i zapisz go przed uruchomieniem lub zaplanowaniem zadania.

Skrypt zamraża dane wejściowe dla każdej daty i zachowuje paragon, wynik i błąd dla każdej próby. Tylko udane próby publikują result.json i receipt.json na najwyższym poziomie datowanego folderu. --recurring sprawdza dostęp właściciela; nie tworzy harmonogramu.

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"

Uruchom raz, a następnie przetestować świeży proces ponownie

Uruchom z folderu zadań. Pierwsze polecenie przedstawia poszukiwania. Drugi używa tego samego konta, wejścia, profilu i stanu, aby odczytać zapisany wynik po sprawdzeniu, czy dostęp jest nadal ważny.

Jedno zdarzenie · dwa proces rozpoczyna
# 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

Potwierdzenie ponownego wykorzystania wyniku

Drugi paragon powinien pokazywać cached: true. Jego użycie należy do oryginalnego wyszukiwania. Pusta tablica organiczna może nadal być sukcesem.

Sprawdź zapisany wynik i odbiór
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
Drugi paragon · wyciąg
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}

Zachowaj pliki pomiędzy uruchomieniami

PlikStosowanie
runs/DATE/request.jsonDokładne dane wejściowe dla tego zdarzenia; zmiana powoduje zatrzymanie biegacza.
runs/DATE/result.json + receipt.jsonOstatnia udana próba. Pożera je tylko po tym, jak bieżące komendy wyjdą pomyślnie.
runs/DATE/attempt.*/Wynik, odbiór i błąd dla każdej próby, w tym niepowodzenia.
FLASHDATA_STATE_DIRChronione referencje i CLI uruchamiają rekordy. Zachowaj ten sam profil i użytkownika OS.

MCP: kontynuuj wystąpienie i zadanie ID

Użyj tego organu zadaniowego z hostem, który utrzymuje trwały stan zadania i pozwala na jedną aktywną egzekucję na każde zdarzenie. Zapisz zwrócone zadanie ID natychmiast; po ponownym uruchomieniu, przeczytaj przyjęte zadanie zamiast ponownie szukać.

MCP powtarzające się zadanie · zapisz jako recurring-task.txt
Użyj oryginalnego wystąpienia grafika ID i zaplanowanego czasu.
Ponownie użyj istniejącego połączenia FlashData MCP i zapisanego rekordu zdarzeń.
1. Jeśli to zdarzenie jest zakończone, zwróć jego zapisany wynik bez wyszukiwania.
2. Jeśli ma zadanie ID, zadzwoń do get_job z tym job_id, aby przeczytać istniejące prace.
3. Jeśli zgłoszenie rozpoczęło się, ale nie ma rezultatu lub zadania ID, zatrzymaj się do przeglądu.
4. Aby uzyskać nowe wystąpienie, sprawdź get_balance i get_pricing dla jednego google_search.
   Kontynuuj tylko w zatwierdzonym budżecie na przełożenie zadań i dostępnej równowadze.
5. Persist submission_started przed wywołaniem google_search jeden raz z:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Zapisz zwróconą pracę ID natychmiast. Przeczytaj go za pomocą get_job aż do terminala; zatrzymać się na awarii.
   Utrzymuj ID w czasie i przestań czekać na czas oczekiwania gospodarza.
7. Zapisz wynik, źródło URLs i wykorzystanie, a następnie oznacz to zdarzenie kompletne.
Na 401, 403, 402, 429 lub nieznany wynik, zatrzymać i zgłosić zapisany rekord.
Honor Retry-After. Nie tworzyć zastępczego dostępu ani innego płatnego zapytania.
Zachowaj raport na miejscu; użyj celu dostawy tylko wtedy, gdy jest skonfigurowany oddzielnie.

Co gospodarz musi przetrwać

Sam sygnał nie może zapobiec powielaniu. Rozmowy MCP nie dziedziczą ochrony CLI run- ID. Twój gospodarz musi utrzymywać pierwotne wystąpienie, stan składania i zadanie ID. Jeśli nie może, do etapu danych należy użyć biegacza CLI. Ten przykład rekordu należy do hosta; nie jest to żądanie MCP.

Rekord hosta · ilustracyjny
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}

Harmonogram testowanego zadania

Poniższy przykład wykorzystuje OpenClaw w 09:00 Asia/Shanghai. Utwórz zadanie wyłączone, uruchom to zapisane zadanie ręcznie, sprawdź jego wyjście, a następnie włączyć go. Dla innego terminarza, postępuj zgodnie z tą samą sekwencją z jego testem-run kontroli.

UstawienieStosowanie
KonkursoweJedna aktywna realizacja dla tego przepływu pracy, z trwałym stanem.
Czas działaniaUżyj tego samego użytkownika OS i ścieżek bezwzględnych dla CLI, folderu zadań i stanu zaufania. Eksport terminali nie jest automatycznie dziedziczony przez uruchomioną bramę.
RetriesZachować pierwotne zdarzenie i planowaną datę, w tym po północy. Ręczny test używa daty infokacji w Asia/Shanghai.
Nieuwzględnione zdarzeniaWybierz, czy pominąć lub nadrobić zaległości. Przebieg wyszukiwania dzisiaj zwraca aktualne dane, nawet jeśli oznaczono je datą wczorajszą.
DostawaZapisz lokalnie najpierw. Przed wysłaniem raportów należy skonfigurować politykę dotyczącą miejsca przeznaczenia i powiadamiania.

Organ zadaniowy CLI dla agenta hosta

Zamień profil i miejsce ścieżki, a następnie zapisz recurring-task.txt w folderze zadań. Użyj tego ciała do wykonania CLI, lub ciała MCP powyżej do wykonania MCP. Bezpośredni terminarz OS może uruchomić skrypt Bash z tymi zmiennymi środowiskowymi bez modelu.

recurring-task.txt
Uruchom zatwierdzone zadanie badawcze FlashData pod użytkownikiem OS, który zapisał klucz.
Runner: < ścieżka bezwzględna do run-research.sh >
Ustaw te zmienne środowiskowe dla procesu runner:
FLASHDATA_BIN: < bezwzględna ścieżka do flashdata >
FLASHDATA_PROFILE: < istniejąca nazwa profilu >
FLASHDATA_STATE_DIR: < istniejący katalog stanu absolutnego >
Utrzymuj nieustawiony FLASHDATA_API_KEY, aby ponownie wykorzystać zapisany element kredytowy.
Użyj oryginalnej planowanej daty w Asia/Shanghai, jako RRRR- MM- DD.
Dla ręcznego uruchomienia, zapisać datę jego wywołania przed wykonaniem.
Uruchom: bash "<absolute path to run-research.sh>" RRRR-MM- DD
Utrzymuj tę datę na powtórkach, nawet po północy. Pozwól na jedną aktywną egzekucję.
Zachowaj ten sam profil, request.json i katalog stanu.
Tylko przeczytaj datowany result.json po pomyślnym zakończeniu komendy.
Zgłoś linki źródłowe, uruchom ID i wykorzystanie. Utrzymuj wyjścia lokalne.
Po błędzie zatrzymaj i zgłoś zapisany błąd. Nie należy rozpoczynać prac zastępczych ani tworzyć nowego dostępu.

1. Utwórz nieaktywne zadanie OpenClaw

Użyj uruchomionej bramy i istniejącego agenta, który przeszedł kontrolę dostępu. Poniższe komendy używają OpenClaw 2026.10.10; aktualizują starszych klientów, jeśli --wait jest niedostępny. W folderze zawierającym recurring-task.txt, ustaw OPENCLAW_AGENT_ID na ID tego agenta.

Polecenie zapisuje openclaw-job.json bez nadpisywania istniejącego pliku. Przeczytaj go i ustaw OPENCLAW_JOB_ID do zadania zwracanego ID. Jeśli tworzenie traci swoją odpowiedź, sprawdź listę automatyzacji --all --json przed utworzeniem innego zadania. --no-deliver wyłącza automatyczne ogłoszenie; jednostka zadaniowa również przechowuje raporty lokalne.

Bash · tworzy pracę dla niepełnosprawnych
: "${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. Sprawdzanie zapisanego zadania przed jego uruchomieniem

Uruchom zapisane zadanie raz, gdy jego harmonogram pozostaje wyłączony. Budżet na jedną wyszukiwanie testowe i koszty modelu; dopasowanie ukończone zdarzenie CLI może ponownie wykorzystać swój wynik. Polecenie to czeka do 10 minut.

Oczekuj completionStatus: udało się, a następnie sprawdzić zapisany wynik, linki źródłowe i wykorzystanie. Dla CLI, przeczytaj runs/DATE/result.json i receipt.json; dla MCP, przeczytaj zapisany przez hosta przypadek i wynik zadania. enqueued: true sam oznacza akceptowane, nie zakończone.

Uruchom raz · zapisać paragon testu
: "${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
)
Odczyt paragonu testu
cat openclaw-test-run.json

Sprawdzić, czy test jest wygięty, czy nie

Przerwa przestaje czekać, a nie zadanie Gateway. Przeczytaj najnowszą historię, jeśli paragon jest pusty. Ustaw OPENCLAW_RUN_ID na OpenClaw runId z paragonu lub historii, a następnie sprawdź to wykonanie. Nie powtarzaj komendy run, aby sprawdzić postęp.

To jest wykonanie terminarza ID- FlashData powtarzalny bieg ID lub MCP zadanie danych ID. Jeśli agent nie mógł zalogować się lub wykonać zadania z danymi, należy wyłączyć harmonogram i najpierw naprawić ten krok.

Sprawdź tę samą realizację
: "${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. Włącz po sprawdzeniu wyjścia

Przegląd zapisanego agenta, harmonogram, strefa czasowa i zakończone badanie. Włącz tylko wtedy, gdy wynik jest poprawny i koszt powtarzający się jest zatwierdzany. Wyłączenie późniejszego zatrzymania przyszłych zaproszeń; nie anuluje już przesłanego zapytania.

Przegląd zapisanej pracy i historii testów
: "${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
Włącz dzienny schemat
openclaw automations enable "$OPENCLAW_JOB_ID"
Pauza przyszłość działa w razie potrzeby
openclaw automations disable "$OPENCLAW_JOB_ID"

Ustawienie zasad dotyczących kosztów i błędów

SytuacjaDziałanie
Planowanie kosztówCena za zapytanie × planowane zdarzenia. Dodawanie modelu i kosztów hosta osobno; liczba wyników nie jest liczbą zapytań.
Saldo wspólnego rachunkuWymuszanie budżetu w scheduler lub host. Przykłady te nie nakładają odrębnego kluczowego limitu wydatków.
401 / 403 / 402Wstrzymać przyszłe wysyłki. Poprawiaj referencje, pozwolenie lub równowagę; wznawiaj z pierwotnym wystąpieniem i zapisanym stanem.
429Szacunek dla Retry-After. Przed podjęciem decyzji, czy nowe zgłoszenie jest bezpieczne, należy sprawdzić przebieg CLI lub wystąpienie MCP.
Nieznany wynik składaniaZachowaj stan zapisany i przestań. Odzyskiwanie znanego zadania ID; nie tworzyć świeżej wersji ID, aby obejść niepewność.

Zatrzymać harmonogram i cofnąć dostęp oddzielnie

  1. Wstrzymaj terminarz, aby zatrzymać przyszłe inwokacje.
  2. Przywróć połączenie agenta, aplikację OAuth lub klucz API w konsoli. Odwołanie blokuje nowe uwierzytelnione użycie; nie usuwa eksportowanych plików.
  3. Powtórzyć kontrolę dostępu ze świeżego procesu. Powinno się nie udać po odwołaniu. CLI auth logout usuwa tylko lokalne referencje; nie cofa zdalnego dostępu.