Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

Jalankan tugas agen berulang

Gunakan kembali akses yang disetujui, jalankan satu pencarian setiap kejadian yang dijadwalkan, dan pulih tanpa sengaja mengirimkan pekerjaan yang sama lagi.

Di halaman ini

Pilih bagaimana tugas berjalan

Pengurus agenmu atau OS penjadwalan persediaan waktu. FlashData memasok data. Pilih satu path eksekusi dan uji di lingkungan yang akan berjalan tanpa pengawasan.

GunakanUntukNegara untuk melestarikan
CLISeorang agen dengan akses terminal, Cron, atau naskah yang dijadwalkan.Profil CLI, direktori negara dan asli dijalankan ID.
MCPHost agen dengan server FlashData yang terhubung.Kredensial host, rekaman kejadian, tugas IDs dan hasil.

Periksa akses dalam lingkungan yang dijadwalkan

Gunakan kembali koneksi pemilik yang ada dengan izin google_search. Klaim akses sementara sebelum penggunaan berulang. Uji dari proses atau sesi yang dijadwalkan baru, tidak hanya satu interaktif.

Gunakan Bash dan jq (Git Bash nyala Windows), di bawah OS pengguna yang menyimpan kunci. Set nama profil Anda yang ada dan direktori status absolut di bawah ini. Jalankan kedua blok di terminal yang sama; pelari memakai ulang pengaturan ini.

Pemeriksaan akses harus mencetak true. Bandingkan availableCredits dengan estimatedCredits sebelum pencarian pertama. Cek ini tidak mengirimkan permintaan.

Set sambungan tersimpan Anda
# 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
Cek akses, keseimbangan, dan harga gratis
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: menyimpan satu tugas per kejadian

Buat folder tugas di bawah ini, lalu simpan request.json dan run-research.sh di dalamnya. Jauhkan folder ini terpisah dari direktori negara kredensial yang ada. Satu tanggal merupakan satu Google query; num set jumlah hasil. Berikan aliran kerja yang berbeda sendiri-ID prefix sebelum eksekusi pertama.

Membuat folder tugas
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

Simpan run-research.sh

Buat run-research.sh di samping request.json dalam folder tugas. Salin skrip lengkap di bawah ini dan simpan sebelum berjalan atau penjadwalan tugas.

Skrip membekukan masukan untuk setiap tanggal dan menyimpan tanda terima, hasil, dan berkas kesalahan untuk setiap percobaan. Hanya upaya sukses menerbitkan result.json dan receipt.json pada tingkat atas folder tertanggal. --recurring cek akses pemilik; ini tidak membuat jadwal.

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"

Jalankan sekali, kemudian menguji segar proses coba lagi

Jalankan dari folder tugas. Perintah pertama memberikan pencarian. Yang kedua menggunakan akun yang sama, masukan, profil, dan negara untuk membaca hasil yang disimpan setelah memeriksa akses yang masih valid.

Satu kejadian proses dimulai
# 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

Konfirmasikan hasil yang digunakan kembali

Tanda terima kedua harus menunjukkan cached: true. Penggunaannya milik pencarian aslinya. Array organik yang kosong masih bisa menjadi hasil yang sukses.

Inspeksi hasil dan tanda terima yang tersimpan
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
Tanda terima kedua
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}

Menjaga berkas antar jalan

BerkasGunakan
runs/DATE/request.jsonMasukan yang tepat untuk kejadian itu; mengubahnya membuat pelari berhenti.
runs/DATE/result.json + receipt.jsonUsaha terakhir yang sukses. Hanya mengkonsumsi mereka setelah perintah saat ini berhasil keluar.
runs/DATE/attempt.*/Hasil, penerimaan dan kesalahan untuk setiap usaha, termasuk kegagalan.
FLASHDATA_STATE_DIRKredensial terproteksi dan CLI catatan lari. Pertahankan profil yang sama dan pengguna OS.

MCP: pertahankan kejadian dan pekerjaan ID

Gunakan tubuh tugas ini dengan host yang membuat keadaan tugas dapat dipertahankan dan memungkinkan satu eksekusi aktif per kejadian. Simpan pekerjaan yang dikembalikan ID segera; setelah restart, baca pekerjaan yang diterima daripada mencari lagi.

MCP diulang tugas recurring-task.txt
Gunakan penjadwalan kejadian asli ID dan waktu yang dijadwalkan.
Gunakan ulang yang ada FlashData MCP catatan sambungan dan kejadian tersimpan.
1. Jika kejadian ini selesai, kembalikan hasilnya tanpa mencari.
2. Jika ini memiliki pekerjaan ID, panggil get_job dengan job_id tersebut untuk membaca hasil kerja yang telah ada.
3. Jika sebuah pengajuan dimulai tetapi tidak memiliki hasil atau pekerjaan ID, berhenti untuk tinjauan.
4. Untuk kejadian baru, periksa get_balance dan get_pricing untuk satu google_search.
   Lanjutkan hanya dengan anggaran yang disetujui dan keseimbangan yang tersedia.
5. Persist submission_started sebelum memanggil google_search sekali dengan:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Simpan pekerjaan yang kembali ID segera. Baca dengan get_job sampai terminal; berhenti pada kegagalan.
   Jaga ID di seluruh waktu dan berhenti menunggu di tenggat waktu tuan rumah.
7. Simpan hasilnya, sumber URLs dan penggunaan, kemudian tandai kejadian ini selesai.
Pada 401, 403, 402, 429 atau hasil yang tidak diketahui, berhenti dan laporkan catatan yang disimpan.
Kehormatan Retry-After. Jangan buat akses pengganti atau permintaan bayaran lain.
Pertahankan laporan lokal; gunakan tujuan pengiriman hanya jika dikonfigurasi secara terpisah.

Apa yang tuan rumah harus bertahan

Sebuah prompt saja tidak dapat mencegah duplikat. MCP panggilan tidak mewarisi CLI run- ID perlindungan. Host Anda harus bertahan pada kejadian asli, pengajuan keadaan dan pekerjaan ID. Jika tidak bisa, gunakan pelari CLI untuk langkah data. Rekaman ini milik host Anda; ini bukan permintaan MCP.

Catatan host
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}

Jadwalkan tugas yang telah diuji

Contoh di bawah ini menggunakan OpenClaw di 09:00 Asia/Shanghai. Buat tugas dinonaktifkan, jalankan tugas yang disimpan secara manual, periksa hasilnya, lalu aktifkan. Untuk penjadwalan lain, ikuti urutan yang sama dengan test- run kontrol.

TatananGunakan
konkuenCity in Texas, United StatesSatu eksekusi aktif untuk alur kerja ini, dengan keadaan tahan lama.
RuntimeGunakan pengguna OS yang sama dan path absolut untuk CLI, folder tugas dan keadaan kredensial. ekspor terminal tidak secara otomatis diwariskan oleh Gateway yang sedang berjalan.
UlangiPertahankan kejadian aslinya dan tanggal yang dijadwalkan, termasuk setelah tengah malam. Sebuah tes manual menggunakan tanggal pengdoa di Asia/Shanghai.
Kejadian yang tidak terjawabPilih apakah akan melewatkan atau mengejar ketinggalan. Sebuah pencarian hari ini kembali data saat ini, bahkan jika berlabel dengan tanggal kemarin.
PengirimanSimpan lokal pertama. Atur kebijakan tujuan dan pemberitahuan sebelum mengirim laporan.

CLI tugas tubuh untuk host agen

Ganti profil dan placeholder path, lalu simpan recurring-task.txt dalam folder tugas. Gunakan tubuh ini untuk eksekusi CLI, atau MCP tubuh di atas untuk eksekusi MCP. Sebuah penjadwalan OS langsung dapat menjalankan skrip Bash dengan variabel lingkungan ini tanpa sebuah model.

recurring-task.txt
Jalankan tugas penelitian FlashData yang disetujui di bawah pengguna OS yang menyimpan kuncinya.
Runner: < path absolut ke run-research.sh >
Set variabel lingkungan ini untuk proses runner:
FLASHDATA_BIN: < path absolut ke flashdata >
FLASHDATA_PROFILE: < nama profil yang ada >
FLASHDATA_STATE_DIR: < direktori keadaan absolut yang ada >
Pertahankan FLASHDATA_API_KEY unset untuk menggunakan kembali kredensial yang disimpan.
Gunakan tanggal aslinya di Asia/Shanghai, seperti YYYY-MM- DD.
Untuk menjalankan manual, menyimpan tanggal doa sebelum eksekusi.
Jalankan: bash "<absolute path to run-research.sh>" YYYYY-MM- DD
Tetap ingat tanggal itu, bahkan setelah tengah malam. Ijinkan satu eksekusi aktif.
Pertahankan profil yang sama, request.json dan direktori negara.
Hanya membaca tanggal result.json setelah perintah keluar dengan sukses.
Laporkan link sumber, jalankan ID dan penggunaan. Tetap keluar dari tempat ini.
Pada galat, berhenti dan laporkan galat yang disimpan. Jangan mulai pekerjaan pengganti atau membuat akses baru.

1. Buat tugas OpenClaw yang dinonaktifkan

Gunakan Gateway yang sedang berjalan dan agen yang ada yang melewati pemeriksaan akses. Perintah di bawah ini digunakan OpenClaw 2026.10.10; perbarui klien yang lebih tua bila --wait tidak tersedia. Dalam folder yang berisi recurring-task.txt, set OPENCLAW_AGENT_ID untuk agen yang ID.

Perintah menyimpan openclaw-job.json tanpa menimpa berkas yang telah ada. Baca dan atur OPENCLAW_JOB_ID ke pekerjaan yang kembali ID. Jika penciptaan kehilangan respons, periksa daftar otomatisasi --all --json sebelum menciptakan pekerjaan lain. --no-deliver menonaktifkan pengumuman otomatis; badan tugas juga menyimpan laporan lokal.

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. Uji tugas yang disimpan sebelum mengaktifkan

Jalankan pekerjaan yang disimpan sekali sementara jadwalnya tetap dinonaktifkan. Anggaran untuk satu biaya pencarian dan model; kecocokan yang selesai CLI dapat menggunakan kembali hasilnya. Perintah ini menunggu sampai 10 menit.

Mengharapkan completionStatus: berhasil, kemudian memeriksa hasil yang disimpan, sumber link dan penggunaan. Untuk CLI, baca runs/DATE/result.json dan receipt.json; untuk MCP, baca kejadian dan hasil kerja yang disimpan host. enqueued: true saja berarti diterima, belum selesai.

Jalankan sekali
: "${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
)
Baca tanda terima tes
cat openclaw-test-run.json

Inspeksi sebuah timed- out atau tes gagal

Waktu berhenti menunggu, bukan tugas Gateway. Baca sejarah baru-baru ini jika tanda terima kosong. Set OPENCLAW_RUN_ID ke OpenClaw runId dari tanda terima atau sejarah, kemudian periksa eksekusi itu. Jangan ulangi perintah jalankan untuk memeriksa kemajuan.

Ini adalah eksekusi penjadwalan ID, bukan FlashData dijalankan berulang ID atau MCP tugas data ID. Jika agen tidak dapat masuk atau menjalankan tugas data, pastikan jadwal dinonaktifkan dan perbaiki langkah itu terlebih dahulu.

Inspeksi eksekusi yang sama
: "${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. Aktifkan setelah memeriksa keluaran

Tinjau agen yang disimpan, jadwal, zona waktu dan tes selesai. Aktifkan hanya setelah keluaran benar dan biaya yang berulang disetujui. Menonaktifkan penghentian pemanggilan ke depan; ini tidak membatalkan permintaan yang telah dimasukkan.

Ulas tugas yang disimpan dan riwayat uji
: "${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
Aktifkan jadwal harian
openclaw automations enable "$OPENCLAW_JOB_ID"
Jeda masa depan berjalan ketika dibutuhkan
openclaw automations disable "$OPENCLAW_JOB_ID"

Set aturan biaya dan kegagalan

SituasiAksi
Perencanaan biayaHarga per query × telah direncanakan. Tambahkan biaya model dan host secara terpisah; jumlah hasil tidak dihitung.
Saldo akun bersamaMemaksakan anggaran Anda dalam penjadwalan atau host. Contoh-contoh ini tidak memberikan kunci yang terpisah untuk pembelanjaan.
401 / 403 / 402Jeda pengiriman masa depan. Perbaiki kredensial, izin atau keseimbangan; lanjutkan dengan kejadian asli dan keadaan disimpan.
429Menghormati Retry-After. Inspeksi CLI atau kejadian MCP sebelum memutuskan apakah pengiriman baru aman.
Hasil pengiriman tidak diketahuiJaga negara yang selamat dan berhenti. Cari kembali pekerjaan yang dikenal ID; jangan membuat run segar ID untuk melewati ketidakpastian.

Hentikan jadwal dan batalkan akses secara terpisah

  1. Jeda penjadwalan untuk menghentikan doa di masa depan.
  2. Kembalikan koneksi agen, aplikasi OAuth atau kunci API di konsol. Pemindahan memblokir penggunaan terotentikasi baru; ini tidak menghapus berkas yang diekspor.
  3. Ulangi pemeriksaan akses gratis dari proses yang baru. Ini harus gagal setelah pembatalan. CLI auth hanya menghapus kredensial lokal; ini tidak mencabut akses jarak jauh.