浏览文档
指南
使用已保存的运行、任务或结果 ID,恢复中断的 CLI 或 MCP 任务。
本页内容
从已保存的 ID 开始
暂停失败的任务或调度。在任务文件夹或智能体历史中找到回执,再选择对应的恢复方式。以下 ID 不能互换。
| 已保存的内容 | 恢复方式 |
|---|---|
| CLI runId | 按下方 CLI 步骤操作,使用原配置档及状态目录。 |
| MCP 任务 ID · job_… | 在原 MCP 连接中调用 get_job。 |
| MCP 结果 ID · result_… | 调用 get_result,继续读取大响应。 |
| OpenClaw 运行 ID | 查看 OpenClaw 运行历史,再找到该运行记录的 FlashData ID。 |
1. 检查 CLI 运行
以原系统用户在任务输出文件夹打开 Bash(Windows 使用 Git Bash)。将下方三个值替换为原任务使用的值,并保持此终端打开以完成第 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: "${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 和 data.errorCode。
| 记录状态 | 操作 |
|---|---|
| succeeded | 检查访问,然后在第 3 步导出已保存结果。 |
| accepted | 检查访问,然后在第 3 步恢复已接纳任务。 |
| uncertain / intent | 保持任务暂停。检查 remoteId、candidateRemoteIds 及历史记录,再决定是否重新提交。 |
| failed | 先处理 errorCode。失败记录会保留;替代执行属于新任务,可能消耗 Credits。 |
| partial | 保留可用输出,恢复已知任务。批量任务需逐行检查后再决定是否替换失败项。 |
| run_not_found | 检查配置档、系统用户及状态目录。日志丢失时查找已保存回执或历史记录。 |
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.accessVerified | true;否则先修复访问再读取结果。 |
| data.identity.identity.accountId | 提交该任务的账户。 |
| data.identity.permittedSources | 包含已保存任务使用的来源。 |
| data.identity.identity.recurringAllowed | 恢复定时任务前应为 true。 |
账户已更换,或刚完成试用认领
恢复中断的认领
已批准认领应在 24 小时交接窗口内于原配置档运行 auth finish。它保存并验证所有者密钥,然后确认安装。第二条命令在新进程检查保存的访问。
: "${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. 恢复 CLI 结果
按第 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轮询超时会停止本地等待。再次运行该恢复命令可继续等待同一任务。
: "${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-interactive确认恢复后再继续
- 确认退出码为 0 且 ok: true,然后打开 recovered.json。导出已保存结果时 cached: true;usage 对应原始执行。
- 重试同一时段时保留相同账户、配置档、状态及运行 ID。不要删除日志或更改运行 ID 来强制重试。
- 确认访问及结果后再恢复调度。每个新计划时段使用独立运行 ID。
恢复 MCP 任务
MCP 调用不会创建 CLI 运行记录。使用提交任务时所属账户的现有 MCP 连接。替换下方提示词中的任务 ID,然后发送给已连接的智能体。
恢复现有 FlashData 任务:job_REPLACE_WITH_SAVED_ID。
使用当前 MCP 连接,先调用 get_balance,参数为 {},检查访问,
再用此 job_id 调用 get_job。
若响应包含 result_id,调用 get_result 读取剩余片段,
先拼接全部片段,再解析 JSON。
若 job.status 为 pending 或 processing,每 5 秒查询同一任务,
最多等待 2 分钟;仍未结束时报告最新状态并停止。
若为 completed,将 output、来源 URL 和用量保存到当前任务。
遇到访问错误、任务失败或结果不可用时,停止并报告 ID。
不要调用来源工具、提交批量任务或创建新凭据。读取原任务
在自定义 MCP 客户端中,替换 job_id 后将此对象传入 callTool。它是工具调用,不是终端命令。get_job 会检查任务账户及来源权限;仅 get_balance 成功不能证明可访问此任务。
{
"name": "get_job",
"arguments": {
"job_id": "job_REPLACE_WITH_SAVED_ID"
}
}检查 MCP 任务状态
| 响应 | 下一步 |
|---|---|
| job.status: pending / processing | 等待后再次读取同一任务 ID。本地超时不会取消任务。 |
| job.status: completed | 保存 output。其用量属于原查询;get_job 不会提交或收取新查询费用。 |
| job.status: failed / isError: true | 先读取错误,再决定如何使用输出。不要自动重新调用来源。 |
| code: result_unavailable | 若为临时交付失败,可重试读取。保存的结果已过期时使用之前导出的文件。异步 JSON 结果保留 24 小时。 |
大 MCP 响应读取中断
使用同一 API 密钥及已保存的 result_id。从 offset 0 开始可重建整个响应;若已保留前面的片段,则使用其原样 next_offset 继续读取。调用前替换占位符。
- 按顺序拼接每个 chunk,持续使用 next_offset,直到它为 null。读取最后一个片段后再解析合并的 JSON。
- 缓存有效期为 10 分钟,每个密钥保留最新四个大响应。若缓存过期或被淘汰,但已保存任务 ID,可重新调用 get_job 并读取它的新片段。
- 实时响应不保证有可恢复的后台任务。若没有已保存任务 ID 或导出文件,先检查历史记录,重新执行付费查询前需确认。
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}没有运行或任务 ID
检查任务保存的文件、智能体工具历史及所有者的请求历史。request_id 是诊断 ID,不是 job_id。如果无法确认提交是否已接纳,保持任务暂停。重复原来源调用可能产生另一笔费用。
按错误码查找修复方法
| 信号 | 修复方法 |
|---|---|
| 400 / 422 | 按工具或端点结构检查参数。CLI 请求可在新任务前使用 query --dry-run 检查。 |
| 401 / 403 | CLI 执行第 2 步访问检查。MCP OAuth 由宿主刷新;已撤销授权需经所有者批准重新连接。使用 API 密钥时,检查宿主保存的密钥及来源权限。 |
| 402 | 暂停新任务,直到所有者处理额度问题。 |
| 406 | 使用 Accept: application/json。支持内容的端点可用 X-Respond-With: markdown 请求 Markdown。 |
| 429 | 遵守 Retry-After,再次提交前先恢复已知任务。等待不会清除失败的 CLI 运行记录。 |
| 超时 / 5xx / 响应丢失 | 恢复已知接纳任务。提交结果未知时保持暂停,并检查历史记录。 |
| run_id_input_conflict | 恢复原输入。新输入需明确创建新任务及运行 ID。 |
| run_account_mismatch | 使用第 2 步的账户变更检查项;新运行 ID 不是恢复捷径。 |
| output_exists | 选择新输出文件名,并保留已保存运行。 |
| result_unavailable | MCP 按上方任务或片段步骤处理;CLI 恢复已接纳的远程任务。结果过期时使用之前导出的文件或自己的存储。 |
向支持团队提供诊断信息
CLI 可对任务保存的 error.json 运行此 jq 过滤器。MCP 请复制工具响应中的 code、http_status 和 request_id,以及已保存的 job_id 或 result_id。附上客户端版本、端点、UTC 时间,并说明提交是已接纳还是结果未知。不要包含凭据、Cookie 或签名 URL。
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json