Community编程与开发github.com

安全分类

对 OpenClaw 安全公告、草案和 GHSA 报告进行分类,附带已发布标签和信任模型证明。

安全分类 是什么?

该技能用于辅助维护者对 OpenClaw 安全公告(advisories)、草案和 GHSA 报告进行高置信度的分类。其核心目标是在不误报真实问题或引入不必要回归的前提下,实现准确的专业判断。该技能支持 GitHub CLI (`gh`)、`git` 和 `npm` 等工具,遵循一套详细的检查流程:包括验证信任模型(例如,是否为已声明的可信主机/本地状态)、检查已发布版本是否受影响、分析实际利用路径以及评估功能权衡。它提供统一的关闭标准(如重复、无效或已修复),并指导维护者撰写包含确切原因、代码引用和已发布标签事实的回复,同时注意公开措辞的卫生(如避免公开提交哈希或修复细节)。该技能还包含应对网络分类器中断的备用方案(Daybreak Blue 路线),以及一系列经验性的决策注释,帮助快速判断常见场景。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/clawdbot/clawdbot/tree/main/.agents/skills/security-triage

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

安全分类 是做什么的?

在审查 OpenClaw 安全公告、草案或 GHSA 报告时使用。

目标:维护者高置信度分类,避免误关真实问题或引入不必要的回归。

关闭标准

仅在以下任一情况成立时关闭:

  • 与现有公告或已修复的问题重复
  • 针对已发布行为无效
  • 超出 SECURITY.md 范围
  • 在任何受影响的版本/标签发布之前已修复

不要仅因为 main 分支已修复就关闭。如果最新的已发布标签或 npm 版本受影响,请保持开放状态,直到以正确的状态发布或公开。

必读内容

在回答之前:

  1. 阅读 SECURITY.md。
  2. 使用 gh api /repos/openclaw/openclaw/security-advisories/<GHSA> 读取 GHSA 正文。
  3. 检查确切的受影响代码路径。
  4. 验证发布状态:
    • git tag --sort=-creatordate | head
    • npm view openclaw version --userconfig "$(mktemp)"
    • git tag --contains <fix-commit>
    • 如果需要:git show <tag>:path/to/file
  5. 搜索规范重叠:
    • 已发布的 GHSA
    • 较早修复的缺陷
    • SECURITY.md 中已涵盖的相同信任模型类别

审查方法

对于每个公告,决定:

  • 关闭
  • 保持开放
  • 保持开放但缩小范围

当涉及评论/关闭时,默认一次处理一个公告:

  1. 审查恰好一个 GHSA。
  2. 首先打印 GHSA URL。
  3. 总结决策和证据以供讨论。
  4. 起草一条维护者可直接发布的评论。
  5. 仅将该评论复制到剪贴板。
  6. 停止并等待 Peter 发布/讨论,然后再处理下一个 GHSA。

除非 Peter 明确要求批量操作,否则不要批量输出多条关闭评论。

按以下顺序检查:

  1. 信任模型
    • 先决条件是否已处于可信主机/本地/插件/操作者状态中?
    • SECURITY.md 是否明确将该类别列为范围外或仅作为加固项?
  2. 已发布行为
    • 该缺陷是否存在于最新的已发布标签或 npm 版本中?
    • 它是否在发布前就已修复?
  3. 利用路径
    • 报告是否展示了真实的安全边界绕过,而非仅仅提示注入、本地同用户控制或辅助级别的语义问题?
    • 如果数据仅在被 SECURITY.md 列为可信工作空间内存的文件之间移动,请不要将“注入标记”单独视为安全缺陷。
    • 在这种情况下,仅在保留预期内存工作流程的前提下,将清理视为可选的加固措施。
  4. 功能权衡
    • 如果某项加固更改会降低预期的用户功能,请在提出之前明确指出。
    • 优先采用保留用户工作流程的修复,而非默认拒绝的回归,除非安全边界要求如此。
  5. 加固后续
    • 即使 GHSA 应关闭,也要询问是否可以进行一项狭窄的加固更改,以减少误操作风险,而不改变文档记录的信任边界。
    • 将加固与漏洞状态分开。措辞应为“GHSA 关闭不要求此更改,但值得考虑”。
    • 仅在加固方案具体、风险低且保留预期的维护者/操作者工作流程时才提出。
    • 如果加固需要更改产品或安全模型,应明确说明,并且不要暗示这是关闭所需的修复。

回应格式

在准备维护者可用的关闭回复时:

  1. 首先打印 GHSA URL。
  2. 然后起草一条维护者可以发布的详细回复。
  3. 包括:
    • 关闭的确切原因
    • 确切的代码引用
    • 确切的已发布标签/版本事实
    • 修复来源或规范重复的 GHSA(如适用)
    • 仅在值得且保留功能时附加强化说明

语气坚定、具体、非防御性。

公开措辞卫生

  • 将原始提交哈希、PR 标题/编号和修复机制摘要保留在公共公告文本之外。仅使用已打补丁的版本/发布字段。
  • 将确切的提交 SHA、PR 和实现说明保留在内部注释和验证文件中。
  • 对于加固/不发布的结果,不要添加利用细节、“由……修复”文本或“修复提交”部分。感谢报告者,保留贡献,说明 SECURITY.md 的边界,并明确说明该 GHSA 将被关闭且不发布。
  • 对于已发布的 CVE/GHSA 文本,优先使用包含已修复版本的 ### 已打补丁的版本。除非 Peter 明确要求,否则不要解释补丁的工作原理。
  • 除非 Peter 明确要求,否则不要将 GHSA ID 写入变更日志和发布说明中。

讨论模式

当 Peter 手动发布 GHSA 评论时,使用以下流程:

  1. 显示 URL。
  2. 给出简洁的裁决(关闭、保持开放 或 保持开放但缩小范围)。
  3. 列出最有力的证据要点。
  4. 将任何可选的加固后续与关闭原因分开说明。
  5. 使用 pbcopy 复制建议的评论正文。
  6. 在回复该公告后结束。直到 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 上已修复但未发布”通常不构成关闭理由。
  • “需要攻击者控制受信任的本地状态”通常属于范围外。
  • “同一主机、同一用户进程已可读写本地状态”通常属于范围外。
  • “受信任的工作空间内存提升/重新索引受信任的工作空间内存”通常属于范围外,除非它跨越了文档记录的边界。
  • “辅助函数的行为与文档记录的配置语义不同”通常无效。
  • 如果只是严重性错误但缺陷真实存在,则保持开放并在回复中缩小影响范围。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

1password

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

acp-router

Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation. Codex chat binding defaults to the native Codex app-server plugin unless ACP is explicit or background spawn needs ACP.

add-model-provider

Add and live-prove a model provider with non-interactive config one-liners, without exposing credentials.

agent-transcript

Requested GitHub PR/issue agent transcripts: redact, trim, preview, and insert safely.

apple-notes

Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS.

apple-reminders

List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl.

auto-qa

Run OpenClaw-wide autonomous QA and live/stress campaigns across independent subsystem lanes, with verified fixes and a resumable evidence report.

autoreview

Structured code review through the shared OpenClaw agent-skills installation.

bear-notes

Create, search, and manage Bear notes via grizzly CLI.

blacksmith-testbox

Run Blacksmith Testbox for CI-parity checks, secrets, hosted services, migrations, or builds local cannot reproduce.

block-kit

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

blogwatcher

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

browser-automation

Use when controlling web pages with the OpenClaw browser tool, especially multi-step flows, login checks, tab management, or recovery from stale refs/timeouts.

camsnap

Capture frames or clips from RTSP/ONVIF cameras and local webcams, including USB pan/tilt/zoom control.

canvas

Present HTML on connected OpenClaw node canvases, navigate/eval/snapshot, and debug canvas host URLs.

channel-message-flows

Use when running QA Lab channel message flow evidence.

clawdtributor

Clawtributor PRs here, last week or another window: discover conversation refs, recheck GitHub, rank by impact.

clawhub

Search ClawHub for plugins by default, or skills when explicitly requested; install, verify, update, uninstall, publish, or sync skills.

相关技能