تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

الأدلة

Recover an agent integration

Recover an interrupted CLI or MCP task using its save run, job or result ID.

في هذه الصفحة

ابدأوا ID لقد أنقذتك

اوقف المهمة أو الجدول الزمني الفاشلين اعثر على إيصاله في ملفك أو تاريخ العميل، ثم اتبع مسار المطابقة. هذه هي IDs ليس قابلاً للتغيير

لديكالاستخدام
CLI runIdخطوات CLI أدناه، مع الملف الشخصي ودليل الحالة الأصليين.
MCP العمل ID عملget_job on the existing MCP connection.
نتيجة MCP ID ; نتيجة.get_result to finish reading a large response.
OpenClaw run IDسجل تشغيل OpenClaw، ثم معرّف FlashData الذي سجّله ذلك التشغيل.

1. Inspect the CLI run

افتح الباب Bash (Git Bash on Windowsكالأصلية OS مستعمل، في ملفك الخاص بالمهمة. يستعاض عن القيم الثلاثة الواردة أدناه بالقيم الواردة في المهمة الأصلية. أبقوا هذه المحطة مفتوحة لخطوات 2 و 3. غير مبال FLASHDATA_API_KEY لندع CLI استخدم المفتاح الذي تم توفيره في هذا الملف

اختيار المهمة القائمة؛ هذه المحطة النهائية
# 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
التفتيش المحلي: لا توجد مكالمات من طراز API
: "${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-interactive

اختيار إجراءات الاسترداد

اقرأ data.status, data.remoteId and data.errorCode in the run record.

الحالة المسجلةالإجراء المطلوب
succeededتحقق من الوصول ثم تصدير النتيجة المنقذة في الخطوة 3.
acceptedتحقق من الدخول، ثم استعادة الوظيفة المقبولة في الخطوة 3.
uncertain / intentحافظي على المهمة متوقفة تحقق من remoteId, candidateRemoteIds and History قبل أن تقرر ما إذا كان ينبغي تقديم أي شيء مرة أخرى.
failedFix errorCode أولاً ويُحتفظ بسجل فاشل؛ والاستبدال هو مهمة جديدة ويمكن أن يستخدم الائتمانات.
partialالحفاظ على النواتج المتاحة. استرداد الوظائف المعروفة؛ وبالنسبة للعمل بالجملة، يفتش كل صف قبل استبدال البنود الفاشلة.
run_not_foundتحقق من الملف OS مستعمل ودليل الولاية ابحث عن إيصالات منقذة أو History إذا فقدت المذكرة.

2. تحقق من وصول حساب CLI

وتحتاج هذه الضوابط المجانية إلى الوصول إلى الحساب الأصلي ومصدر API. حل أي خطأ في التوثيق قبل استرداد النتائج.

التحقق من الوصول وقراءة الرصيد
: "${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-interactive

تحقق من هذه الحقول

والتوازن الصفري هو مسألة تمويل للعمل الجديد. لا يعني في حد ذاته أن المفتاح غير صحيح

auth statusالمتوقع
data.accessVerifiedtrue؛ وإلا فأصلح الوصول قبل قراءة النتائج.
data.identity.identity.accountIdالحساب الذي قدم المهمة.
data.identity.permittedSourcesيشمل المصدر الذي تستخدمه المهمة الموفورة.
data.identity.identity.recurringAllowedtrue قبل استئناف مهمة متكررة.

لقد تغير الحساب، أو أنا فقط طالبت بتجربة

run_account_mismatch means the save run belong to a different account or API origin. إعادة استخدام اسم الملف لا ينقل ذلك الركض.

الحالةالإجراء
الحساب الخاطئتحقق من تجاوزات البيئة، وشخصيات مختارة، ومصدر management/data. أعد الحساب المقصود قبل التعافي
المفتاح المتناوب(ب) استخدام مفتاح بديل للحساب نفسه مع الحصول على إذن المصدر المطلوب. حافظ على الملف الأصلي، دليل الولاية، واهرب ID.
التجربة المطالَب بهاويختلف حساب المالك عن الحساب المؤقت. إقرأْ نواتجَ التجربةَ التي صدّرتَها بالفعل. إستعملْ a تشغيل جديد ID فقط لمهمة المالك الجديدة المعتزمة، إنها تستخدم رصيد المالك

Resume an interrupted claim

لربط حساب تمت الموافقة عليه، شغّل auth finish في ملفه الشخصي الأصلي خلال مهلة التسليم البالغة 24 ساعة. يحفظ مفتاح المالك ويتحقق منه ثم يؤكد تثبيته. يفحص الأمر الثاني الوصول المحفوظ في عملية جديدة.

الانتهاء من عملية التسليم الحالية
: "${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-interactive

3. Recover the CLI result

اختر الوضع المنقذ من الخطوة 1. استخدم اسم ملف النواتج الذي لا وجود له. ويتحقق كل من الأمرين من إمكانية الوصول ويحافظ على الركض الأصلي؛ ولا يقدم أي منهما استفساراً بديلاً.

تصدير النتيجة المحفوظة
: "${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-interactive

استرداد تأكيدات قبل استئناف العمل

  1. تحقق من شفرة الخروج 0 و ok: true، ثم فتح recovered.json. أما الصادرات المحفوظة - الرجعية فتحتوي على cached: true؛ ويشير الاستخدام إلى التنفيذ الأصلي.
  2. حافظ على نفس الحساب، والوصف، والولاية، وإدارة ID عند إعادة فحص هذا الحدث. لا تحذف دفترها أو تُعيد تسمية الركض لإرغامها على العودة.
  3. ولا يُستبق الجدول الزمني إلا بعد الوصول إلى الجدول، ويتم التحقق من النتيجة. أعطِ كُلّ حدث جديد مُقرّر له تشغيل ID.

Recover an MCP task

MCP المكالمات لا تخلق CLI سجلاّت التشغيل. (ج) استخدام الصلة القائمة بين شركة MCP للحساب الذي قدم الوظيفة. يستعاض عن الوظيفة ID في هذه السرعة وإرسالها إلى عميلك المتصل

عروس في عميلك المُتصل
إسترجعي قائمتي FlashData الوظيفة: job_REPLACE_WITH_SAVED_ID.
استخدام الحالي MCP الإتصال. اتصل get_balance مع {} لتفقد الدخول
ثمّ get_job مع هذا job_id.
If the reply contains result_id, finish reading its get_result chunks
و تجمعهم قبل أن يقطعوا JSON.
For job.status قيد النظر أو التجهيز، يقترن بنفس الوظيفة 5 ثواني
حتى 2 دقائق، ثمّ يُبلغُ آخر حالة ويَتوقّفُ.
وللإكمال، وفر الناتج ومصدره URLs واستعماله في هذه المهمة.
On an access mistake, failed job or unavailable result, stop and report the ID.
لا تُديروا أداة مصدر، أو تقدّموا دفعة، أو تُنشئوا وثائق تفويض جديدة.

اقرأ الوظيفه الأصليه

بالنسبة لزبون من طراز MCP، نقل هذا الجسم إلى callTool بعد استبدال job_id. هذا نداء أداة، وليس قيادة قذيفة، وتتحقق شركة get_job من حساب العمل ومن إذن المصدر؛ ولا يثبت تحقق شركة get_balance وحدها إمكانية الحصول على هذه الوظيفة.

get_job
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}

تحقق من حالة وظيفة MCP

استجابةالإجراء التالي:
job.status: pending / processingانتظر، ثم قرأت نفس العمل ID. الوقت المحلي لا يلغيه
job.status: completedإنقاذ الناتج. ويعود استخدامه إلى الاستفسار الأصلي؛ ولا تقدم شركة get_job أي استفسارات جديدة أو توجه إليها.
job.status: failed / isError: trueاقرأ الخطأ قبل استخدام أي ناتج. لا تعيدي تشغيل المصدر تلقائياً
code: result_unavailableأعد القراءة لفشل في التسليم وإذا انتهت صلاحية النتيجة الموفرة، استخدم الصادرات السابقة. ويحتفظ بنتائج Async JSON لساعات 24.

تم تعطيل رد كبير من MCP

إستخدموا المحفوظات result_id مع نفس API المفتاح بدء التعويض 0 لإعادة بناء كل الاستجابة، إذا كنت احتفظت بالقطعة السابقة، استخدام دقيق لهم next_offset بدلاً من ذلك يستعاض عن صاحب المسكن قبل تسمية هذه الأداة.

  1. أقدّم كلّ فصّل في النظام، باستخدام next_offset إلى أن يكون null. اخفضوا المركب JSON فقط بعد أخر قطعة
  2. المخبأ يدوم 10 دقائق وحافظ على أربعة ردود أكبر على كل مفتاح إذا انقضت أو تم طردك و أنقذت عملاً IDاتصلوا get_job مرة أخرى وقراءة أشيائها الجديدة.
  3. ولا يوجد في الاستجابة في الوقت الحقيقي أي وظيفة أساسية مضمونة يمكن استردادها. وبدون وظيفة منقذة من طراز ID أو تصديرها، تحقق من History، وتسأل قبل إجراء استفسار جديد مدفوع الأجر.
get_result
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}

ليس لدي أي وظيفة أو وظيفة ID

افحص ملفات المهمة المحفوظة وسجل أدوات الوكيل وسجل طلبات المالك في History. request_id معرّف تشخيصي، وليس job_id. إذا لم تستطع تأكيد قبول الإرسال، فأبقِ المهمة متوقفة. قد يؤدي تكرار استدعاء المصدر الأصلي إلى رسم آخر.

اعثر على اصلاح برمز الخطأ

الإشارةFix
400 / 422تحقق من الحجج ضد الأداة أو الشيمة النهائية وفيما يتعلق بطلبات شركة CLI، يرجى استخدام الاستفسار --dry-run قبل أي مهمة جديدة.
401 / 403بالنسبة لـ CLI، تحقق من الدخول في الخطوة 2. وفيما يتعلق بشركة MCP OAuth، دعي البلد المضيف يستأنف عمله؛ وتحتاج المنحة التي ألغيت إلى إعادة وصل معتمدة من المالك. مع API مفتاح، تحقق من سر المضيف وأذن المصدر
402توقف عن العمل الجديد حتى يحل المالك التمويل
406Use Accept: application/json. وللحصول على نقاط نهائية مدعومة بالمحتوى، يرجى من شركة Markdown أن تطلب إلى شركة X-Respond-With: نقطة انطلاق.
429الشرف Retry-After وإستعادة أي عمل معروف قبل أن يقدم مرة أخرى الإنتظار لا يُوضّحُ a فشل سجلّ CLI.
الوقت/الساعة الخامسة/الرد المفقودإستعادة الوظائف المقبولة المعروفة. إبقاء نتائج التقديم غير معروفة متوقفة ومتحققة History.
run_id_input_conflictأعيدي المُدخل الأصلي. والمدخلات الجديدة تحتاج إلى مهمة جديدة متعمدة وتدير ID.
run_account_mismatchاستخدم قائمة التحقق عند تغيير الحساب في الخطوة 2؛ معرّف التشغيل الجديد ليس اختصارًا لاستعادة العمل.
output_existsاختر اسم ملف جديد للناتج أبقوا المنقذين يهربون
result_unavailableFor MCPتحقق من العمل أو خطوات الاختناق بالنسبة لـ CLI، استرجعوا الوظيفة النائية المقبولة. النتائج المفاجئة تحتاج لتصدير سابق أو تخزين الخاص بك.

أرسل تشخيصاً للدعم

For CLIأديري هذا jq تصفية على error.json انقذت بمهمتك وبالنسبة إلى MCP, copy code, http_status and request_id from the tool response, plus the Save job_id or result_id. إدراج نسخة العملاء، نقطة النهاية، وقت النقل إلى الخارج، وما إذا كان القبول مؤكداً أو غير معروف. باستثناء وثائق التفويض والكوكيز والتوقيع على URLs.

مجالات التشخيص المختارة؛ المحلية فقط
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json