ClawPhylax Verify

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install clawphylax-verify
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 clawphylax-verify。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

ClawPhylax Verify 通过 ClawPhylax 插件为 Openclaw Skills 提供安装前静态扫描和运行时证据。它通过识别已联系的主机、出站上传、凭据文件读取、异常目的地和被阻止的事件，帮助确定某个 skill 实际执行的操作。
请将此 skill 与常规静态审查结合使用：扫描器显示 skill 声称要做什么，而 ClawPhylax 记录它在网络上实际做了什么。它支持更安全的第三方 skill 安装、基于证据的安全审查、主机允许列表和拒绝列表，以及对可疑代理流量的透明说明。

应用场景

在安装不受信任的第三方 Openclaw Skill 之前，评估其是否安全。
识别 skill 联系的每个主机，并将这些目的地与其文档所述服务进行比较。
检测上传与凭据文件读取结合导致的潜在数据外泄。
调查代理运行期间联系的未知或异常主机。
审查特定 skill 的运行时活动，或生成更广泛的出站连接报告。
将一台机器上已批准且保护隐私的主机证据分享给其他用户。
标记或阻止特定 skill 的主机，而不改变全局执行设置。

工作原理

在不安装第三方 skill 的情况下获取或检查它，然后使用 ClawPhylax 扫描其文件夹。
将结果分类为 clean、review 或 suspicious：clean 表示存在已记录主机且没有上传或凭据读取；review 表示发现上传或凭据读取；suspicious 表示已知投放主机，或凭据访问与上传同时出现。
在回答运行时安全或目的地问题前，确认 ClawPhylax 插件处于活动状态。
查询运行时账本，获取主机、最近事件或限定时间范围的报告。
当命令从 skill 目录运行时，将活动归因于 skill:；无法精确归因时归因于 tool:；提供商流量表示为 model-turn。
按顺序报告未记录主机、敏感读取、上传、异常主机、被阻止事件，以及 learning 或 stable 基线状态。
将空账本视为尚未观察到，而绝不能视为 skill 安全的证明。
可选地使用从其他机器分享的已批准 clawphylax-card/v1 卡片，将本地扫描与运行时证据进行比较。
仅在用户请求时应用特定 skill 的拒绝或允许规则，且未经用户明确批准，绝不切换到 enforce 模式。

配置指南

如果所需的 ClawPhylax 插件尚未启用，请安装并启用：
openclaw plugins install clawphylax
openclaw plugins enable clawphylax
检查插件状态：
openclaw clawphylax status
在不安装 skill 的情况下检查它并扫描本地文件夹：
openclaw skills inspect
openclaw clawphylax scan
也可以使用等效的 clawhub inspect 命令进行检查。在可用时，该 skill 还支持 clawphylax_scan、clawphylax_hosts、clawphylax_report 和 clawphylax_card 工具。查看运行时活动：
openclaw clawphylax hosts skill:
openclaw clawphylax recent --origin skill: --limit 30
openclaw clawphylax report --since 24h
为一个 skill 管理主机决策：
openclaw clawphylax deny 'skill:'
openclaw clawphylax allow 'skill:'
在 observe 模式下使用 deny 可标记主机，在 enforce 模式下可阻止主机。更改执行行为前，请获得明确批准。

数据架构

ClawPhylax Verify 围绕 skills、origins、hosts、events、verdicts、baselines 和可分享卡片组织安全证据。
实体或字段 用途
Skill folder 安装前扫描的本地源，用于查找主机引用、上传和凭据文件读取。
Origin 从 skill 目录执行的命令使用 skill:；归因范围更广时使用 tool:；提供商流量使用 model-turn。
Host 在扫描或运行时账本中观察到的网络目的地，并与文档所述服务比较。
Verdict 根据已记录主机、上传、凭据读取、已知投放主机和综合风险信号，分为 clean、review 或 suspicious。
Runtime event 网络证据，例如 sensitive-read、upload、unexpected-host 或被阻止的活动。
Baseline learning 表示历史不足，无法判断新颖性；stable 表示新观察到的主机对于该 origin 并不寻常。
Card 可分享的 clawphylax-card/v1 主机名记录，记录某个 skill 观察到的主机；根据 skill 指令，不包含该机器的其他数据。
Host policy 控制标记或阻止行为的 skill 专用 allow 和 deny 关系。
主要生成的证据包括运行时账本、报告、扫描判定以及可选的已批准卡片。扫描器会读取文件，但不会跟踪下载脚本之后执行的操作。Exec 命令按文本分析，不会跟踪子进程。

高级特性

查询主机、最近事件和基于时间的报告的运行时账本。
检测敏感凭据文件读取、上传、异常目的地、已知投放主机和被阻止的连接。
使用 skill origin、tool origin 和 model-turn 提供商流量进行基于证据的归因。
通过 learning 与 stable 基线区分历史不足和真正的新颖行为。
通过来自 ClawHub、代码仓库或 issue tracker 的已批准
clawphylax-card/v1
证据卡片进行跨机器比较。
skill 专用主机拒绝规则，可在 observe 模式下标记，在 enforce 模式下阻止。
skill 专用允许规则，用于不应再被标记的可信主机对。
兼容 OpenClaw CLI 工作流和 ClawPhylax 工具调用。
明确的安全边界：不会将未观察到事件视为安全证明，并要求用户批准后才更改执行设置。

name: clawphylax-verify description: "Verify a third-party skill is safe before installing it, and check what installed skills actually do on the network: scan a skill folder for the hosts it contacts, uploads and credential-file reads; list hosts a skill or tool contacted at runtime; find data exfiltration; audit outbound connections per skill; explain why the agent contacted an unknown host. Use whenever asked whether a skill is safe, where a skill sends data, before installing an untrusted skill, or when a reply footer mentions ClawPhylax." homepage: https://github.com/aeneassoft/clawphylax
license: MIT