Semak dokumentasi
Panduan
Kemulih kembali tugas CLI atau MCP yang terganggu menggunakan menjalankan, pekerjaan atau hasil ID.
Pada halaman ini
Mulailah dengan ID yang kau simpan
Dia tidak pernah gagal dalam tugas atau jadwal. Pengecakan menemukan penerimaannya dalam folder tugas atau riwayat agen Anda, kemudian ikutilah jalan yang cocok. IDs ini tidak dapat diubah.
| Anda telah | Guna |
|---|---|
| CLI runId | ¡CLI langkah di bawah, dengan profil dan direktori keadaan asli. |
| Pekerjaan MCP ID · job_. | get_job pada sambungan MCP yang sudah ada. |
| Hasil MCP hasil ID · hasil_. | get_result ke finish membaca respon yang besar. |
| ID pelaksanaan OpenClaw | OpenClaw sejarah sejarah, kemudian FlashData ID Direkam oleh pelarian itu. |
1. Periksalah CLI
Open Bash (Git Bash Pada Windows) sebagai yang asli OS Pengguna, dalam folder keluaran tugas Anda. Gantikan semua tiga nilai di bawah ini dengan yang dari tugas asal. Tetap buka terminal ini untuk langkah 2 dan 3. Tak Beraturan FLASHDATA_API_KEY Biar saja CLI Menggunakan kunci yang disimpan di profil ini.
# Replace these with the values used by the original task.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export RUN_ID='scheduled-research:2026-11-04:Asia-Shanghai'
unset FLASHDATA_API_KEY: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata doctor --offline --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata runs show "$RUN_ID" --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactiveMemilih tindakan pemulihan
Í Read data.status, data.remoteId dan data.errorCode dalam rekor lari.
| Status recording recorded | Tindakan |
|---|---|
| succeeded | Periksa akses, kemudian ekspor hasil yang disimpan dalam langkah 3. |
| accepted | Periksa akses, kemudian mendapatkan kembali pekerjaan yang diterima dalam langkah 3. |
| uncertain / intent | Jangan sampai tugas ini dihentikan. Periksa remoteId, candidateRemoteIds dan History sebelum memutuskan apakah akan menyerahkan sesuatu lagi. |
| failed | Fix errorCode pertama. Catatan gagal dari IOZA tetap dipertahankan; pengganti adalah tugas baru dan dapat menggunakan kredit. |
| partial | Simpan output yang tersedia. Memulih kembali pekerjaan yang diketahui; untuk pekerjaan pukal, memeriksa setiap baris sebelum mengganti item yang gagal. |
| run_not_found | Periksa profil, pengguna dan direktori negara OS. Lihat penerimaan yang telah disimpan atau History jika jurnal ini hilang. |
2. Periksa akses akun CLI
Cek gratis ini memerlukan akses ke akun asli dan asal API. Selesaikan semua kesalahan otentikasi sebelum hasil pemulihan.
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata account balance --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactivePeriksa bidang ini
Keseimbangan nol adalah masalah pendanaan untuk pekerjaan baru. Ini tidak dengan sendirinya berarti bahwa kunci tidak sah.
| lapangan auth status | Diharapkan |
|---|---|
| data.accessVerified | true; jika tidak perbaiki akses sebelum hasil pembacaan. |
| data.identity.identity.accountId | Akun yang menyerahkan tugas itu. |
| data.identity.permittedSources | Termasuk sumber yang digunakan oleh tugas yang disimpan. |
| data.identity.identity.recurringAllowed | true sebelum melanjutkan tugas yang berulang. |
Catatan itu berubah, atau aku hanya mengklaim pengadilan
run_account_mismatch berarti yang disimpan adalah milik akun yang berbeda atau asal API. Melucuti nama profil tidak mentransfer yang berjalan.
| Situasi Orang Asing | Aksi |
|---|---|
| Akun yang salah | Anda harus memeriksa kunci lingkungan, profil terpilih dan management/data asal-usul. Pulihkan rekening yang dituju sebelum pemulihan. |
| Kualapan Kunci | Gunakan kunci gantian untuk akaun yang sama dengan kebenaran sumber yang diperlukan. Kekalkan profil asal, direktori keadaan dan ID pelaksanaan. |
| Tuntutan pengadilan | Akun pemilik berbeda dengan akun sementara. Uji coba Baca uji coba Anda sudah dieksport. Unakel menggunakan lari baru ID hanya untuk tugas pemilik baru yang dimaksudkan; ia menggunakan saldo pemilik. |
Melanjutkan klaim terganggu
Untuk klaim yang disetujui, jalankan auth finish dalam profil aslinya di dalam 24-hour handoff window. Ia menyimpan dan mengesahkan kunci pemilik, kemudian mengakui pemasangan. Perintah kedua memeriksa akses tersimpan dalam proses baru.
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
# Resume an already approved claim in its original profile.
flashdata auth finish --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
# A second process checks the saved owner access.
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive3. Memulihkan hasil CLI
Tak ada yang memilih status tersimpan dari langkah 1. Unado menggunakan nama berkas keluaran yang tidak ada. Kedua-duanya memerintahkan untuk memverifikasi akses dan tetap menjalankan yang asli; juga tidak mengajukan pertanyaan penggantian.
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs show "$RUN_ID" --result --output recovered.json \
--profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactiveTUBUH TPS menghentikan penantian lokal. Lakukan lagi perintah pemulihan ini untuk terus menunggu pekerjaan yang sama.
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs recover "$RUN_ID" --output recovered.json --timeout 10m \
--profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactiveKonfirmasi pemulihan sebelum melanjutkan kembali
- Periksa kode keluar 0 dan ok: true, kemudian buka recovered.json. Ekspor tersimpan-result memiliki cached: true; penggunaan mengacu pada eksekusi asli.
- Dia juga menyimpan akun, profil, keadaan dan menjalankan ID ketika mencoba kembali kejadian ini. Jangan hapus jurnalnya atau ubah nama lari untuk memaksa coba lagi.
- Penjadwalan kembali dilakukan hanya setelah akses dan hasilnya diverifikasi. Berikan setiap kejadian baru yang dijadwalkan sendiri ID.
Memulihkan tugas MCP
Panggilan MCP tidak membuat catatan lari CLI. Guna koneksi MCP yang sudah ada untuk akun yang menyerahkan pekerjaan. Menyampaikan pekerjaan ID dalam prompt ini dan mengirimkannya ke agen terhubung Anda.
Pulihkan kembali pekerjaan FlashDataku yang sudah ada: job_REPLACE_WITH_SAVED_ID.
Use the now MCP koneksi. Panggilan get_balance dengan {} untuk memeriksa akses,
Kemudian get_job dengan job_id ini.
Jika balasan berisi result_id, finish membaca potongan get_result
Dan menggabungkan mereka sebelum meng-hurai JSON.
* Untuk * job.status Bertangguh atau diproses, polling pekerjaan yang sama setiap 5 detik
Untuk sampai ke 2 menit, kemudian melaporkan status terbaru dan berhenti.
Untuk selesai, simpan keluaran dan sumbernya URLs dan penggunaan dalam tugas ini.
Pada kesalahan akses, pekerjaan gagal atau hasil tidak tersedia, berhenti dan melaporkan ID.
Jangan jalankan sebuah alat sumber, kirim sebuah kelompok, atau buat kredensial baru.Bacalah pekerjaan aslinya
Untuk klien ustom MCP, luluskan objek ini ke callTool setelah menggantikan job_id. Ini adalah panggilan alat, bukan perintah shell. get_job memeriksa akun pekerjaan dan izin sumber; pemeriksaan get_balance yang sukses saja tidak membuktikan akses ke pekerjaan ini.
{
"name": "get_job",
"arguments": {
"job_id": "job_REPLACE_WITH_SAVED_ID"
}
}Periksa status pekerjaan MCP
| Respons | Tindakan berikutnya |
|---|---|
| job.status: pending / processing | Tunggu, kemudian membaca pekerjaan yang sama ID. Sebuah tenggat waktu lokal tidak membatalkannya. |
| job.status: completed | Simpan keluaran. Penggunaannya dimiliki oleh pertanyaan asli; get_job tidak mengajukan atau mengisi untuk pertanyaan baru. |
| job.status: failed / isError: true | Í Baca kesalahan sebelum menggunakan output apapun. Jangan jalankan ulang sumber secara otomatis. |
| code: result_unavailable | Anda coba baca ulang untuk kegagalan pengiriman sementara. Jika hasil yang disimpan habis, gunakan ekspor lebih awal. Hasil Async JSON dipelihara untuk jam 24. |
Respon MCP yang besar disampuk
Gunakan result_id yang disimpan dengan kunci API yang sama. Mulai di offset 0 untuk membangun kembali seluruh respon; jika Anda menyimpan potongan sebelumnya, gunakan next_offset yang tepat mereka sebagai gantinya. Gantikan pemegang tempat sebelum memanggil alat ini.
- Tambahkan setiap potongan secara berurutan, menggunakan next_offset sampai null. Dia akan memparse gabungan JSON hanya setelah potongan terakhir.
- cache berlangsung 10 menit dan menyimpan empat respon besar terbaru per kunci. Jika sudah kadaluarsa atau diusir dan kau menyimpan pekerjaan ID, hubungi get_job lagi dan baca bagian barunya.
- Respon realtime tidak memiliki pekerjaan latar belakang yang dapat dipulihkan. Tanpa pekerjaan yang disimpan ID atau ekspor, periksa History dan tanyakan sebelum menjalankan pertanyaan berbayar baru.
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}Aku tidak punya pekerjaan atau pekerjaan ID
Periksa berkas tersimpannya tugas, sejarah alat agen dan permintaan pemilik History. A request_id adalah diagnostik ID, bukan job_id. Jika Anda tidak dapat mengkonfirmasi apakah penyerahan diterima, tetap hentikan tugas. Mengulangi panggilan sumber yang asli dapat membuat muatan lain.
Cari sebuah perbaikan dengan kode kesalahan
| Petunjuk | Fix |
|---|---|
| 400 / 422 | Periksa argumen terhadap alat atau skema titik akhir. Untuk permintaan CLI, gunakan pertanyaan --dry-run sebelum tugas baru apapun. |
| 401 / 403 | Untuk CLI, periksa akses di langkah 2. * Untuk * MCP OAuth, Biarkan tuan rumah segar kembali; hibah yang dicabut perlu rekoneksi yang disetujui oleh pemilik. Dengan kunci API, periksa rahasia dan hak sumber tuan rumah. |
| 402 | Hentikan pekerjaan baru sampai pemilik menyelesaikan pendanaan. |
| 406 | Guna Accept: application/json. Untuk titik akhir konten yang didukung, permintaan Markdown dengan X-Respond-With: markdown. |
| 429 | Kehormati Retry-After dan pulihkan pekerjaan apapun yang diketahui sebelum menyerahkan lagi. Penantian zinif tidak membersihkan rekor lari CLI yang gagal. |
| Masa Kehabisan Masa Tamat / 5xx / respon hilang | Pemulihan diketahui pekerjaan diterima. Pastikan hasil pengiriman tidak diketahui dijedakan dan periksa History. |
| run_id_input_conflict | Pulihkan input asli. Input baru membutuhkan tugas baru yang disengaja dan menjalankan ID. |
| run_account_mismatch | Use the account-change checklist in step 2; a new run ID bukanlah jalan pintas pemulihan. |
| output_exists | Pilih nama berkas keluaran baru. Tetap selamatkan dia. |
| result_unavailable | Untuk MCP, periksa pekerjaan atau potongan langkah di atas. Untuk CLI, dapatkan kembali pekerjaan yang diterima. Hasil kadaluwarsa membutuhkan ekspor atau penyimpanan Anda sendiri sebelumnya. |
Diagnostik untuk mendukung
Untuk CLI, jalankan filter jq ini pada error.json yang disimpan oleh tugas anda. Untuk MCP, kode salin, http_status dan request_id dari respon alat, ditambah job_id yang disimpan atau result_id. Jalur ini termasuk versi klien, titik akhir, waktu UTC dan apakah penerimaan dikonfirmasi atau tidak. Kekecualian kelayakan, cookies dan ditandatangani URLs.
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json