ClawHub

claw-graceful-recovery

Claw 微信指令权限错误恢复。当 AI 通过微信接收用户指令后，执行操作遭遇 权限拒绝、系统限制或访问被拒，导致任务卡住、循环重试或无法继续接受新指令时触发。 触发词：权限不足、没有权限、Permission denied、EACCES、Operation not permitted、 拒绝访问、卡住了、无响应、Claw卡死、指令卡住、微信指令卡住、执行失败权限、 恢复就绪状态、跳过权限错误、清除当前任务、强制恢复、恢复待命。

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install claw-graceful-recovery

Claw Graceful Recovery

当 Claw 通过微信执行用户指令时，若遭遇权限错误导致卡死或无法接受新指令，按以下流程处理。

第一步：识别错误信号

以下任意情况出现，立即进入恢复流程：

系统级信号：Permission denied、EACCES、Operation not permitted、EPERM、Access is denied、涉及 sudo 的操作无法执行。

行为信号：同一操作连续失败 ≥ 2 次；工具调用 > 30 秒无进展；陷入重复尝试同一失败步骤的循环；等待用户输入但微信端无交互通道。

详细信号列表见 references/error-signals.md。

第二步：执行恢复流程（四步，必须按顺序执行）

1. 立即终止

  • 停止当前操作，不重试
  • 不尝试用不同参数再次执行
  • 不尝试绕过权限检查
  • 清空当前任务的执行上下文

2. 记录错误（内部，不发给用户）

记录三项内容：失败的操作描述（一句话）、错误类型、用户的原始指令。

3. 向用户发送简短反馈

通过微信通道发送简短消息，模板见 references/feedback-templates.md。

核心原则：不暴露原始错误堆栈，不暴露完整系统路径，用中文简洁描述。

4. 恢复待命

  • 清除当前任务的所有中间状态
  • 不保留失败任务的上下文
  • 准备接受微信下一条指令

第三步：特殊场景处理

批量任务中单个文件失败

  • 跳过该文件，继续处理其余文件
  • 最终汇总时列出被跳过的文件及原因
  • 不因单个文件权限错误中止整个批量任务

连续 3 条及以上指令均因权限失败

  • 主动向用户说明当前环境可能缺少必要权限
  • 建议用户检查 Claw 的运行权限设置
  • 暂停执行，等待用户确认后再继续

微信通道本身不可用（极端情况）

  • 静默写入本地日志：echo "[$(date)] <操作> | <错误类型>" >> ~/claw_recovery.log
  • 停止所有操作，等待下次微信连接恢复

绝对禁止事项

  1. 权限错误后不告知用户就继续尝试
  2. 对同一操作超过 2 次重试
  3. 尝试修改文件权限（chmod）或提升进程权限来绕过错误
  4. 因等待权限授权而无限阻塞，不接受新指令
  5. 把原始错误堆栈、系统路径等技术细节直接暴露给微信用户

预防策略（执行前预检）

  • 文件操作前用 test -r <file> / test -w <dir> 预检权限
  • 涉及 sudo、chown、chmod 等特权命令，先告知用户需要手动授权，不自动执行
  • 涉及系统目录（/System/、/usr/、/etc/、/var/）的操作，默认跳过
  • 涉及其他用户 home 目录的，不尝试访问