前言¶
用微信当指令入口的 Agent,最常见的事故不是模型不会做,而是做到一半被权限拦住。用户发来「帮我把某个文件发出去」,Agent 拿到文件后写不进去、调不通系统命令,于是开始原地重试;重试若干轮后整个会话不再接受新指令,看起来就「卡死」了。人工去翻日志,往往只看到一串 Permission denied,不知道当时执行到哪一步、卡在哪个权限上,也没有人能触发恢复。
下面介绍的 claw-graceful-recovery 是 SkillHub 上一个社区维护的 Skill,专门处理这类中断。它不负责让权限变宽,只负责在权限问题导致任务停滞、重试循环或无法接收新指令时,把执行状态拉回可继续工作的状态。
这是什么¶
一句话定位:Claw 微信指令的权限错误恢复 Skill,用于在任务因权限拒绝、系统限制或访问被拒而卡住时,跳过错误、清理当前任务并恢复到待命状态。
基本信息如下:
名称: claw-graceful-recovery
坐标: @user_2ee93f2d/claw-graceful-recovery
版本: 1.1.0
来源: community
分类: ai-agent
发布者: user_2ee93f2d
评分: 100000,下载 998
标签: requires_api_key=false
也就是说,它不需要额外的 API Key,属于社区(community)来源而非官方维护,使用前需要自己评估来源可靠性。当前公开评分很高但安装量为 0,实际口碑数据还不充分,建议先在测试会话里跑一遍再进生产。
# 解决什么问题
这个 Skill 覆盖的状态分三类,都是在微信指令链路里真实会碰上的:
1、权限拒绝。例如执行系统命令或写文件时拿到 EACCES、Operation not permitted、拒绝访问。这类报错本身不会自动消失,重试只会再撞同一次。
2、系统限制。不是被拒,而是当时的运行环境不允许这个操作继续下去,任务停在半中间。
3、状态卡死。Agent 不再接受新指令、进入循环重试、或者完全没有响应,用户侧表现为「卡住了」「无响应」「Claw卡死」。
它的价值不在修权限,而在恢复流程:跳过这次权限错误、把当前这个任务清掉、让 Agent 回到能接新指令的待命状态,避免一条坏指令拖死整个会话。
# 核心功能
已核实的能力是下列触发词对应的恢复动作。触发词覆盖中英文报错和用户口语两种来源:
权限不足、没有权限、Permission denied、EACCES、Operation not permitted、
拒绝访问、卡住了、无响应、Claw卡死、指令卡住、微信指令卡住、
执行失败权限、恢复就绪状态、跳过权限错误、清除当前任务、
强制恢复、恢复待命
工作方式可以拆成两步理解:先识别当前失败是不是权限类错误,再执行恢复动作——跳过该权限错误,清除被卡住的任务,使 Agent 回到「恢复就绪状态」或「恢复待命」。对于希望跳过错误而不是排查根源的场景,它还提供强制恢复这条直接路径。
需要注意的是,这些触发词来自官方简介,具体的匹配规则(是否做字符串前缀匹配、是否区分大小写、是否会把非权限类报错也判成权限问题)在现有资料里没有说明。上线前建议自己构造几组正例和反例验证。
# 安装与启用
公开页面没有给出命令行安装命令、Skill 目录路径或配置文件字段,本次尝试直接打开官方页面也未能取回正文,因此本文不提供未经核实的安装步骤。
目前能用的确认方式是手工访问官方地址:
https://www.skillhub.cn/skills/user_2ee93f2d/claw-graceful-recovery
```
在页面上确认版本号(当前为 1.1.0)、来源(community)与评分(100000)之后,按站点上的安装入口操作即可。启用前有一点可以确认的是标签 requires_api_key=false,说明不需要准备额外的 Key。
如果使用环境是 Cursor、Codex CLI 或 Claude Code,各自的 Skill 读取目录和加载机制不同,但现有资料里没有针对这三家的分别说明,请以实际安装后的加载结果为准。
典型用法¶
公开资料给出的是触发条件,而不是可复现的命令行示例,所以下面列出的是期望命中的场景,用于验收时对照:
1、微信里发一条会触发权限拒绝的指令,让 Agent 拿到 EACCES 或 Operation not permitted。预期不再原地重试,而是识别为权限类错误并跳过。
2、在 Agent 已经进入循环重试、不再响应新指令时,发送「强制恢复」或「恢复待命」。预期当前任务被清除,Agent 回到可接新指令的状态。
3、任务卡住但没有明确报错时,发送「卡住了」「微信指令卡住」「清除当前任务」。预期执行恢复就绪。
验收时建议盯两处:出错的那一轮之后,Agent 是否还能正常接受下一条微信指令;被跳过的权限错误有没有被记录下来。后者决定了你事后还能不能复盘这次为什么被拒。
适用场景与注意¶
适合的场景:以微信作为用户指令入口、任务链中包含文件读写或系统命令调用、并且希望单条坏指令不要拖垮整个会话的 Agent。这类系统里,恢复速度比根因排查的完整度更影响体验,跳过并待命通常比卡片等待更实用。
需要注意的几点:
1、它是恢复状态,不是提权工具。权限没给足的问题不会因为这个 Skill 而消失,只是这次被跳过了。如果不在权限侧做修正,下一条同类指令还会撞上同一个错误。
2、来源是 community,发布者为 user_2ee93f2d,不是官方仓库。用在生产之前请先读一遍 Skill 内容,确认它对任务的清除范围符合你的预期。
3、「清除当前任务」这一步有副作用:如果被清除的任务包含正在进行的外部操作(例如已经发出去的调用),Skill 是否能回滚这些操作,资料里没有说明。
4、触发词里有「权限不足」「没有权限」这类常见短语,存在误触发的可能。正式接入前建议先限定触发范围或做确认式交互。
5、安装量为 0,说明目前缺少足够的公开部署反馈,行为稳定性需要自己压测。
结尾¶
claw-graceful-recovery 的价值在于把「卡死」变成「待命」:权限被拒、系统限制或访问被拒导致的停滞、循环重试和无响应,都可以用它跳过这一次错误、清掉当前任务并继续接受新指令。它不解决根因,只保证会话不死于一条坏指令。
官方地址:https://api.skillhub.cn/user_2ee93f2d/claw-graceful-recovery