运行检查
在策略编写期间运行检查,以及其背后的插件设置。属于 openclaw policy 参考的一部分。
运行检查¶
在策略编写期间运行仅策略检查:
openclaw policy check
openclaw policy check --agent ops
openclaw policy check --json
openclaw policy check --severity-min error
policy check 仅运行策略检查集,并输出证据、发现项和证明哈希。当 Policy 插件启用时,相同的发现项也会出现在
openclaw doctor --lint 中。
在具有显式所有权的智能体集群中,传入 --agent <id>,以便命令从该智能体的
工作区读取受治理声明和 policy.jsonc。单智能体或保留的旧所有者配置仍可以
无需该标志进行解析;OpenClaw 绝不会任意选择第一个智能体。
将操作员策略文件与已编写的基线进行比较:
openclaw policy compare --baseline official.policy.jsonc
openclaw policy compare --baseline official.policy.jsonc --agent ops
openclaw policy compare --baseline official.policy.jsonc --policy policy.jsonc --json
policy compare 将策略文件语法与策略文件语法进行比较;它不会检查运行时状态、证据、凭据或机密。它使用与治理作用域覆盖相同的规则元数据:允许列表必须保持相等或更窄,拒绝列表必须保持相等或更宽,必需布尔值必须保持其值,有序字符串只能向配置顺序中更严格的一端移动,精确列表必须匹配。基线可以是组织编写的策略;被检查的策略可以增加更严格的值或额外规则。当顶层被检查规则同等或更严格时,可以满足作用域基线规则。作用域名称在文件之间无需匹配;比较以选择器(agentIds/channelIds)和字段为键。对于路由检查,每个基线检查 id 必须保持相同的路由和预期智能体。被检查的策略可以增加检查或收窄 matchedBy,但移除检查、更改其路由或智能体,或扩大其接受的匹配类型则更弱。
当被检查的策略路径来自插件配置且为相对路径时,--agent <id> 会选择用于解析它的工作区。绝对策略路径不依赖于智能体工作区。
干净的 compare(--json):
{
"ok": true,
"baselinePath": "official.policy.jsonc",
"policyPath": "policy.jsonc",
"rulesChecked": 3,
"findings": []
}
干净的 policy check --json 输出包含操作员或主管可以记录的稳定哈希:
{
"ok": true,
"attestation": {
"policy": {
"path": "policy.jsonc",
"hash": "sha256:..."
},
"workspace": {
"scope": "policy",
"hash": "sha256:..."
},
"findingsHash": "sha256:...",
"attestationHash": "sha256:..."
},
"checksRun": 5,
"checksSkipped": 0,
"findings": []
}
配置策略¶
策略配置位于 plugins.entries.policy.config 下。
{
"plugins": {
"entries": {
"policy": {
"enabled": true,
"config": {
"enabled": true,
"path": "policy.jsonc",
"workspaceRepairs": false,
"expectedHash": "sha256:...",
"expectedAttestationHash": "sha256:...",
},
},
},
},
}
| 设置 | 用途 |
|---|---|
enabled |
即使在 policy.jsonc 尚不存在时也启用策略检查。 |
workspaceRepairs |
允许 doctor --fix 编辑由策略管理的工作区设置。 |
expectedHash |
用于已批准策略工件的可选哈希锁定。 |
expectedAttestationHash |
用于最后一次接受的干净策略检查的可选哈希锁定。 |
path |
策略工件相对于工作区的位置。 |
将 plugins.entries.policy.config.enabled 设置为 false,可在保留插件安装的同时禁用某个工作区的策略检查。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw