guardrails — 交互式安全护栏配置

通过交互式访谈流程，帮助用户为其 OpenClaw workspace 配置全面的安全护栏。

命令

guardrails setup

交互式设置模式 — 引导用户创建其 GUARDRAILS.md 文件。

工作流：

1. 运行环境发现脚本：bash scripts/discover.sh
2. 风险分类：bash scripts/discover.sh | python3 scripts/classify-risks.py
3. 生成定制化问题：bash scripts/discover.sh | python3 scripts/classify-risks.py | python3 scripts/generate_questions.py
4. 与用户开展交互式访谈：
   • 基于生成的问题库（已适配所发现的环境）向用户提问
   • 为每个问题提供参考建议
   • 支持用户自定义回答
   • 在必要时进行追问
5. 生成 GUARDRAILS.md：echo '' | python3 scripts/generate_guardrails_md.py /path/to/guardrails-config.json
   • 标准输入 JSON 格式：{"discovery": {...}, "classification": {...}, "answers": {...}}
6. 向用户展示生成的 GUARDRAILS.md 以供审阅
7. 在写入 workspace 前请求用户确认
8. 将 GUARDRAILS.md 写入 workspace 根目录
9. 将 guardrails-config.json 保存至 workspace 根目录

重要提示：

• 访谈过程中应保持对话自然、友好
• 说明每个问题的重要性
• 提供关于已识别风险的上下文信息
• 突出高风险技能/集成项
• 允许用户跳过任一问题或自定义答案
• 在最终写入前与用户共同审阅输出内容

guardrails review

审阅模式 — 将现有配置与当前环境进行比对校验。

工作流：

1. 执行环境发现与风险分类
2. 加载现有的 guardrails-config.json
3. 将新发现的技能/集成项与配置文件中记录的内容进行比对
4. 识别配置缺口（例如：新增但未覆盖的技能；已移除但仍保留在配置中的技能）
5. 仅就识别出的缺口向用户提问 — 不重复执行完整访谈
6. 如有必要，更新配置文件及 GUARDRAILS.md

guardrails monitor

监控模式 — 检测环境变更及潜在违规行为。

工作流：

1. 执行：bash scripts/monitor.sh
2. 解析返回的 JSON 报告
3. 若状态为 "ok"：静默处理，或仅作简要确认提示
4. 若状态为 "needs-attention"：向用户发出通知，并附带详细信息
5. 若状态为 "review-recommended"：建议用户运行 guardrails review

该命令可手动执行，也可通过 cron 或心跳机制定时触发。

生成的文件

• GUARDRAILS.md — 主护栏文档（位于 workspace 根目录）
• guardrails-config.json — 用于监控的机器可读配置（位于 workspace 根目录）

注意事项

• 该技能仅用于辅助 创建 护栏 — 实际执行与强制生效由 agent 负责
• 环境发现（discover.sh）依赖 bash + jq；风险分类（classify-risks.py）仅使用 Python 标准库
• 问题生成与 GUARDRAILS.md 生成需调用 LLM — 请设置 OPENAI_API_KEY 或 ANTHROPIC_API_KEY
• Python 脚本依赖 requests 库（可通过 pip install requests 安装）
• 环境发现与风险分类均为只读操作
• 仅 setup 和 review 模式会写入文件，且均需获得用户明确确认