技能介绍

要解决什么问题

Claw 通过微信执行用户指令时，一旦碰到 Permission denied、EACCES、EPERM 等系统级权限错误，常见后果是：同一操作反复重试、工具调用长时间无响应、任务上下文占满导致无法接受下一条微信指令。用户侧往往只看到「卡住」，而堆栈和系统路径也不适合直接发到微信。

本技能定义一套必须按顺序执行的恢复协议，让 Agent 在权限失败时主动止损，而不是继续绕权限或无限阻塞。

技能如何工作

识别阶段：系统级信号（如 Operation not permitted、涉及 sudo 无法执行）与行为信号（同一操作连续失败 ≥2 次、调用超过 30 秒无进展、重复同一失败步骤、等待输入但微信无交互通道）任一出现即进入恢复流程。

四步恢复（不可跳步、不可乱序重试）：

立即终止 — 停止当前操作，不换参数重试，不绕过权限检查，清空当前任务执行上下文。
记录错误（内部） — 记录失败操作一句话描述、错误类型、用户原始指令；不发给用户。
向用户简短反馈 — 经微信发送简洁中文说明；不暴露原始堆栈与完整系统路径。
恢复待命 — 清除中间状态，不保留失败任务上下文，准备接收下一条指令。

特殊场景：批量任务中单文件权限失败则跳过该文件并在汇总中列出；连续 3 条及以上指令均因权限失败时，说明环境可能缺权限并建议检查 Claw 运行权限后暂停等待确认；微信通道不可用时静默写本地日志 ~/claw_recovery.log 并停止操作。

执行前预检：文件操作用 test -r / test -w；特权命令先告知需手动授权；默认跳过 /System/、/usr/、/etc/、/var/ 等系统目录及其他用户 home。

适用边界与注意点

技能明确禁止：权限错误后不告知用户继续尝试；对同一操作超过 2 次重试；用 chmod 或提权绕过错误；因等授权无限阻塞；把堆栈与路径直接暴露给微信用户。它解决的是权限导致的卡死与通道占用，不替代用户侧为 Claw 配置正确运行权限。详细信号与反馈模板见技能内 references/error-signals.md、references/feedback-templates.md。