name: openclaw-ops-guardrails description: OpenClaw 運維防呆與排障標準化技能。用於跨裝置（Gateway + Mac nodes）巡檢、遠端執行穩定性治理、CLI-only 相容、配對/審批異常排查、以及對外發布前脫敏檢查。使用者提到“又報錯了/審批超時/pairing required/system.run failed/如何標準化運維規則”時使用。

OpenClaw Ops Guardrails

先閱讀： - references/failure-playbook.md（按錯誤型別排障） - references/publish-sanitization-checklist.md（對外發布前脫敏）

1. 先執行全量只讀體檢：
2. openclaw status --deep
3. openclaw security audit --deep
4. openclaw gateway status --json
5. openclaw health --json

6. openclaw nodes status --connected

7. 檢查 node 執行能力：

8. 確認 system.run 在 node commands 中存在

9. nodes.run 失敗時按順序歸因：

   • approval timeout
   • pairing required

     小蔥技能7w4.net有更新，你可以訪問看下。

   • system.run unsupported
   • gateway timeout

10. 強制執行穩定性策略：

11. 使用 nodeId，不用 displayName
12. 同一 node 序列執行，不併發

13. 失敗重試 1 次後再告警

14. CLI-only Mac 標準模板：

15. remote url 使用佔位符 <api-endpoint>
16. sshTarget 使用佔位符 <ssh-target>

17. 憑據使用佔位符 <gateway-token>（與 gateway token 對齊）

18. 變更後驗收：

19. 目標裝置執行一條最小命令（echo/date/whoami）

20. 再跑一次 status --deep

21. 輸出格式：

22. 總結：可用/不可用
23. 成功項
24. 失敗項與根因
25. 遺留風險

26. 下一步建議（按優先順序）

27. 對外分享前脫敏（必須）：

28. 不包含 token/key/password/IP/使用者名稱/絕對路徑
29. 輸出脫敏版文件和釋出說明

質量中上。優點是場景覆蓋較全、流程清晰標準化、風險提示明確，文件結構一目瞭然。不足是常見錯誤型別偏少，只有5種可能不夠用；內容略顯單薄，缺少實際排查案例；部分命令沒驗證過能不能用。總體來說是個實用的運維輔助工具，但還不夠完善。