claw-graceful-recovery:把卡死的微信指令拉回待命狀態

前言

用微信當指令入口的 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜