安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install hold
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 hold。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

暂停是 AI Agent 工作流中的停止与恢复关卡。只有当故障或偏差未被列入预检的剩余风险清单时，它才会启动，从而防止 Agent 擅自修复或盲目重试系统性问题。这种有针对性的方法有助于提高 Openclaw Skills 的可靠性，同时避免因常规或可预见的错误而中断工作。
触发后，暂停会将问题归类为新的故障类别、已显现的剩余风险或已失效的计划。随后，它会提供基于证据的报告，以及恰好三个恢复选项——修复并重新启动、谨慎继续或中止——并等待用户决定。

应用场景

Agent 在执行计划工作流时遇到意外错误。
某个步骤以预检未标记的方式偏离计划。
计划所依据的假设不再成立，导致剩余步骤不可靠。
故障似乎具有系统性，重试或临时拼凑变通方案可能造成进一步的副作用。
用户需要清楚了解已完成的工作、正在进行的操作和已发生的更改，然后才能选择恢复方式。

工作原理

检查触发条件： 确认发生了故障或偏差，且该问题不在预检的剩余风险清单中。常规的可预见错误和预检测试失败不属于暂停的处理范围；升级处理前，应先对瞬时错误重试一次。
立即停止： 不要重试、应用变通方案或继续执行下一步。
对故障分类： 将其识别为新的故障类别、已显现的剩余风险或已失效的计划。
报告证据和状态： 提供确切的错误消息、受影响的计划步骤、问题未被预见的原因、已完成的工作、正在进行的工作以及副作用。
提供恰好三个选项： 提供修复并重新启动、谨慎继续和中止，并说明相关风险、重新启动点、预计额外成本和清理详情。
等待用户： 在用户回复“1”、“2”或“3”之前，不要选择或执行任何选项。如果用户选择选项 1，修复后、重新启动前，应在修复后的路径上再次运行预检。

配置指南

暂停是一项行为技能：其 SKILL.md 定义了何时停止、如何对故障分类，以及确切的报告和决策流程。提供的文件未指定安装命令、依赖项或配置变量。将此技能添加到 Openclaw Skills 环境支持的位置，然后让 Agent 能够获取其触发条件和用户确认要求。

提供的 SKILL.md 中未指定安装命令。

将技能文件放入环境支持的 skills 目录。

使用前，请确保工作流包含一个用于记录剩余风险的预检步骤。没有这份清单，Agent 就无法判断故障是否确实未被预见。

数据架构

暂停未定义持久化存储、生成文件或机器可读元数据；技能的 frontmatter 和所需的事件报告除外。
元素 格式或内容
技能元数据 YAML frontmatter：name、description 和 license（MIT）
触发情境 根据预检的剩余风险清单检查故障或计划偏差
分类 new class、materialised risk 或 invalidated plan
事件报告 Markdown 代码块，包含受影响的步骤、确切错误、说明、当前状态和恢复选项
当前状态 已完成的工作、正在进行的工作，以及已写入、发送或更改的副作用
用户决定 三个编号选项之一：修复并重新启动、谨慎继续或中止
持久化数据 技能未作说明

高级特性

了解预检的关卡控制：
区分意外故障与预检期间已记录的风险。
三类故障分类法：
区分新的故障类别、已显现的剩余风险和已失效的计划，以明确恢复决策。
基于证据的事件报告：
要求提供确切的错误消息，以及对执行状态和副作用的具体说明。
由用户掌控恢复：
始终提供恰好三个选项，并暂停等待用户选择。
安全重启规范：
修复后重新启动前，要求在修复后的路径上重新执行预检。
不自主修复：
禁止盲目重试、临时拼凑变通方案，以及未经用户批准恢复执行。

name: hold description: Stop-and-recover gate that triggers ONLY on failures not anticipated in preflight's residual risk list. When triggered, stops all agent action, classifies the failure (new class, materialised risk, or invalidated plan), produces a structured report with evidence, offers exactly three options (fix-and-restart, continue-with-caution, abort), and waits for user selection. Explicitly NOT for routine errors or transient errors. Prevents blind retry loops on systemic issues while enabling graceful recovery. license: MIT

Hold

Stop when the plan is wrong. Don't improvise. This skill activates when something fails or deviates from the plan in a way that wasn't already flagged as a residual risk during preflight. Its job is to stop the agent, classify what happened, and present clear recovery options — never to auto-correct.

When this runs

Precise trigger conditions:

Something failed OR deviated from plan, AND
The failure is NOT in preflight's residual risk list

Explicitly NOT for:

Routine errors the plan already anticipated

Transient errors (retry once, then escalate)
The cheap test failing during preflight (that's preflight's job)

State why this distinction matters: a skill that stops on every error trains the user to ignore it.

Procedure

1. Stop immediately

Do not retry. Do not try a workaround. Do not continue to the next step.

2. Classify the failure

Determine which of these three:

New failure class: a type of error the plan did not consider
Materialised residual risk: something preflight listed, now happening
Invalidated plan: an assumption the plan rested on is false 3. Produce the report

Output exactly this template wrapped in a markdown code block. Make absolutely sure the closing fence is on its own line:

Hold - Unhandled Failure

What happened

• Step: [where in the plan]
• Error: [exact message, no paraphrase]
• Classification: [new class / materialised risk / invalidated plan]

Why this wasn't anticipated

[one sentence - honest, not defensive]

Current state

• Completed: [what finished]
• In progress: [what was mid-flight]
• Side effects: [what was written, sent, or changed]

Options

1. Fix and restart

• Fix: [specific change]
• Restart from: [step name]
• Estimated additional cost: [range]

2. Continue with caution

• Proceed despite the failure
• Risk: [what could go wrong]
• Only sensible if: [condition]

3. Abort

• Stop the task
• Cleanup needed: [list, or "none"]
• What remains done: [list]

Awaiting decision

Reply "1", "2", or "3".

4. Wait

Do not take any of the three options until the user chooses.

Rules for this skill

Only trigger on unhandled failures. Routine errors are not this skill's job.
Always give three options, even if one is clearly wrong. The user decides.
Never improvise a fix. Never retry "just once". The stop is the value.

If the user picks option 1, run preflight again on the fixed path before restarting.

Common mistakes

Stopping on every error. This skill is for unhandled failures only - if preflight anticipated it, do not trigger hold.
Skipping the classification step. "New class" vs "materialised risk" vs "invalidated plan" changes the recovery path.
Improvising a workaround instead of stopping. The stop is the point.
Triggering on the cheap test failing during preflight. That is preflight's domain, not hold's.
Resuming without the user picking an option. The user decides.
范围
SAP Concur Expense Access (fpx)