{"skill":{"slug":"claw-graceful-recovery","displayName":"claw-graceful-recovery","summary":"Claw 微信指令权限错误恢复。当 AI 通过微信接收用户指令后，执行操作遭遇 权限拒绝、系统限制或访问被拒，导致任务卡住、循环重试或无法继续接受新指令时触发。 触发词：权限不足、没有权限、Permission denied、EACCES、Operation not permitted、 拒绝访问、卡住了、无响应...","description":"---\nname: claw-graceful-recovery\ndescription: |\n  Claw 微信指令权限错误恢复。当 AI 通过微信接收用户指令后，执行操作遭遇\n  权限拒绝、系统限制或访问被拒，导致任务卡住、循环重试或无法继续接受新指令时触发。\n  触发词：权限不足、没有权限、Permission denied、EACCES、Operation not permitted、\n  拒绝访问、卡住了、无响应、Claw卡死、指令卡住、微信指令卡住、执行失败权限、\n  恢复就绪状态、跳过权限错误、清除当前任务、强制恢复、恢复待命。\nversion: 1.1.0\n---\n\n# Claw Graceful Recovery\n\n当 Claw 通过微信执行用户指令时，若遭遇权限错误导致卡死或无法接受新指令，按以下流程处理。\n\n---\n\n## 第一步：识别错误信号\n\n以下任意情况出现，立即进入恢复流程：\n\n**系统级信号**：`Permission denied`、`EACCES`、`Operation not permitted`、`EPERM`、`Access is denied`、涉及 `sudo` 的操作无法执行。\n\n**行为信号**：同一操作连续失败 ≥ 2 次；工具调用 > 30 秒无进展；陷入重复尝试同一失败步骤的循环；等待用户输入但微信端无交互通道。\n\n详细信号列表见 `references/error-signals.md`。\n\n---\n\n## 第二步：执行恢复流程（四步，必须按顺序执行）\n\n### 1. 立即终止\n\n- 停止当前操作，不重试\n- 不尝试用不同参数再次执行\n- 不尝试绕过权限检查\n- 清空当前任务的执行上下文\n\n### 2. 记录错误（内部，不发给用户）\n\n记录三项内容：失败的操作描述（一句话）、错误类型、用户的原始指令。\n\n### 3. 向用户发送简短反馈\n\n通过微信通道发送简短消息，模板见 `references/feedback-templates.md`。\n\n核心原则：不暴露原始错误堆栈，不暴露完整系统路径，用中文简洁描述。\n\n### 4. 恢复待命\n\n- 清除当前任务的所有中间状态\n- 不保留失败任务的上下文\n- 准备接受微信下一条指令\n\n---\n\n## 第三步：特殊场景处理\n\n### 批量任务中单个文件失败\n\n- 跳过该文件，继续处理其余文件\n- 最终汇总时列出被跳过的文件及原因\n- 不因单个文件权限错误中止整个批量任务\n\n### 连续 3 条及以上指令均因权限失败\n\n- 主动向用户说明当前环境可能缺少必要权限\n- 建议用户检查 Claw 的运行权限设置\n- 暂停执行，等待用户确认后再继续\n\n### 微信通道本身不可用（极端情况）\n\n- 静默写入本地日志：`echo \"[$(date)] <操作> | <错误类型>\" >> ~/claw_recovery.log`\n- 停止所有操作，等待下次微信连接恢复\n\n---\n\n## 绝对禁止事项\n\n1. 权限错误后不告知用户就继续尝试\n2. 对同一操作超过 2 次重试\n3. 尝试修改文件权限（`chmod`）或提升进程权限来绕过错误\n4. 因等待权限授权而无限阻塞，不接受新指令\n5. 把原始错误堆栈、系统路径等技术细节直接暴露给微信用户\n\n---\n\n## 预防策略（执行前预检）\n\n- 文件操作前用 `test -r <file>` / `test -w <dir>` 预检权限\n- 涉及 `sudo`、`chown`、`chmod` 等特权命令，先告知用户需要手动授权，不自动执行\n- 涉及系统目录（`/System/`、`/usr/`、`/etc/`、`/var/`）的操作，默认跳过\n- 涉及其他用户 home 目录的，不尝试访问\n","tags":{"latest":"1.1.0"},"stats":{"comments":0,"downloads":361,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1777995123815,"updatedAt":1778492850251},"latestVersion":{"version":"1.1.0","createdAt":1777997497457,"changelog":"Version 1.1.0\n\n- 新增 i18n 多语言支持相关文件：i18n-en-references/error-signals.md, i18n-en-references/feedback-templates.md, i18n/en.md\n- 文档结构未变，主流程保持不变\n- 信号列表与反馈模板分离为独立可国际化文件\n- 为后续多语言扩展打下基础","license":"MIT-0"},"metadata":null,"owner":{"handle":"brandon114","userId":"s176p07sp583e38r4dgs0jqdqs83jtar","displayName":"Brandon114","image":"https://avatars.githubusercontent.com/u/53056581?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090750011}}