安全性分類處理 是做什麼的?
在審查 OpenClaw 安全性公告、草案或 GHSA 報告時使用。
目標:以高可信度協助維護者進行分類,避免過度關閉實際問題或導入不必要的回歸錯誤。
關閉條件
僅在滿足以下任一條件時關閉:
- 與現有公告或已修復問題重複
- 對已發布行為無效
- 超出
SECURITY.md定義的範圍 - 在受影響的發布版或標籤之前已修復
不要僅因為 main 分支已修復就關閉。如果最新的發布標籤或 npm 版本仍受影響,請保持開放,直到正確狀態發布或公開。
必讀項目
回答前:
- 閱讀
SECURITY.md。 - 使用
gh api /repos/openclaw/openclaw/security-advisories/<GHSA>讀取 GHSA 內容。 - 檢查確切的受影響程式碼路徑。
- 驗證發布狀態:
git tag --sort=-creatordate | headnpm view openclaw version --userconfig "$(mktemp)"git tag --contains <fix-commit>- 若需要:
git show <tag>:path/to/file
- 搜尋規範性重疊:
- 已發布的現有 GHSA
- 較早修復的錯誤
SECURITY.md中已涵蓋的相同信任模型類別
審查方法
針對每個公告,決定:
關閉保持開放保持開放但縮小範圍
當涉及評論或關閉時,預設一次只處理一個公告:
- 審查恰好一個 GHSA。
- 先輸出該 GHSA 的 URL。
- 摘要決策與證據以供討論。
- 草擬一則維護者可立即使用的評論。
- 僅將該則評論複製到剪貼簿。
- 停止並等待 Peter 發布/討論後,再處理下一個 GHSA。
除非 Peter 明確要求批次處理,否則不要批次發布多個關閉評論。
按以下順序檢查:
- 信任模型
- 觸發前提是否已在受信任的主機/本地/外掛/運算子狀態中?
SECURITY.md是否明確將此類別標示為超出範圍或僅供強化?
- 發布行為
- 錯誤是否存在於最新的發布標籤或 npm 版本中?
- 是否在發布前已修復?
- 漏洞利用路徑
- 報告是否展示真正的邊界繞過,而非僅是提示注入、本地同使用者控制或輔助層級語意?
- 若資料僅在
SECURITY.md中標示的受信任工作空間記憶體檔案之間移動,則不要將「注入標記」單獨視為安全性錯誤。 - 在該情況下,僅在保留預期記憶體工作流程的前提下,將清理視為選擇性強化。
- 功能取捨
- 若強化變更會降低預期的使用者功能,請在提出前說明。
- 優先選擇能保留使用者工作流程的修復,而非預設拒絕的回歸,除非邊界要求如此。
- 強化後續
- 即使應關閉 GHSA,仍可詢問是否有狹義的強化變更能在不改變文件定義的信任邊界下減少誤操作。
- 將強化與漏洞狀態分開。措辭為「非 GHSA 關閉所必需,但值得考慮」。
- 僅在強化方案具體、風險低且保留預期維護者/運算子工作流程時提出。
- 若強化需要產品/安全性模型變更,請明確說明,不要暗示是關閉的必要修復。
回應格式
準備維護者可使用的關閉回覆時:
- 先輸出 GHSA URL。
- 然後草擬一則詳細回覆供維護者發布。
- 包含:
- 關閉的確切原因
- 確切的程式碼引用
- 確切的發布標籤/版本事實
- 修復來源或規範性重複的 GHSA(若適用)
- 選擇性的強化備註(僅在有價值且保留功能時)
語氣保持堅定、具體、非防禦性。
公開措辭規範
- 不要在公開公告文字中包含原始提交哈希、PR 標題/編號及修復機制摘要。僅使用修補後的發布/版本欄位。
- 將確切的提交 SHA、PR 及實作細節保留在內部備註與驗證檔案中。
- 對於強化/不發布的結果,不要加入詳細的利用細節、「由…修復」文字或「修復提交」章節。感謝通報者、保留貢獻、說明
SECURITY.md邊界,並清楚表示 GHSA 將在不發布的情況下關閉。 - 對於已發布的 CVE/GHSA 文字,偏好使用
### 修補版本並標示已修復的發布版。除非 Peter 明確要求公開細節,否則不要解釋修補程式的運作方式。 - 除非 Peter 明確要求,否則不要在變更記錄與發布說明文字中包含 GHSA ID。
討論模式
當 Peter 手動發布 GHSA 評論時,請使用此流程:
- 顯示 URL。
- 給出簡潔判決(
關閉、保持開放、或保持開放但縮小範圍)。 - 列出最有力的證據要點。
- 將任何選擇性的強化後續與關閉原因分開說明。
- 使用
pbcopy複製建議的評論內容。 - 在處理完一個公告後結束回覆。在 Peter 表示可以繼續前,不要繼續處理下一個公告。
若 GitHub API 無法為私人公告發布評論,請說明一次,並持續使用剪貼簿/UI 貼上。
剪貼簿步驟
草擬完當前公告的最終回覆內容後,複製它:
pbcopy <<'EOF'
<最終回覆>
EOF
告知使用者剪貼簿已包含該公告的建議回覆。
實用指令
gh api /repos/openclaw/openclaw/security-advisories/<GHSA>
gh api /repos/openclaw/openclaw/security-advisories --paginate
git tag --sort=-creatordate | head -n 20
npm view openclaw version --userconfig "$(mktemp)"
git tag --contains <commit>
git show <tag>:<path>
gh search issues --repo openclaw/openclaw --match title,body,comments -- "<terms>"
gh search prs --repo openclaw/openclaw --match title,body,comments -- "<terms>"
網路安全分類器中斷
若允許的防禦性工作被網路安全分類器中斷,請僅針對該有限任務使用經核准且可用的 Daybreak Blue 路線,然後恢復先前的模型。保留核准的身份、範圍、權限、沙箱及審查關卡。切勿為繞過存取拒絕、不允許的請求或拒絕的工具操作而切換模型;若該路線也拒絕,請停下來回報。遵循 OpenAI 指引 以獲得核准的模型存取權。
決策備註
- 「已在 main 修復但未發布」通常不應關閉。
- 「需要攻擊者控制受信任的本地狀態」通常超出範圍。
- 「同主機同使用者程序已可讀寫本地狀態」通常超出範圍。
- 「受信任工作空間記憶體提升/重新索引受信任工作空間記憶體」通常超出範圍,除非跨越文件定義的邊界。
- 「輔助函式的行為與文件定義的設定語意不同」通常無效。
- 若僅是嚴重性錯誤但漏洞真實存在,請保持開放並在回覆中縮小影響範圍。