OpenClaw 中文文档
本页内容

本页内容

查看 Markdown以纯文本查看本页在 ChatGPT 中打开针对本页提问在 Claude 中打开针对本页提问

CLI 命令

政策发现、修复和退出代码

解释策略发现、修复它以及退出代码。 openclaw policy 参考的一部分。

发现项

检查身份证 寻找
policy/policy-jsonc-missing 策略已启用，但缺少 policy.jsonc。
policy/policy-jsonc-invalid 策略无法解析，或包含格式错误的规则条目。
policy/policy-hash-mismatch 策略与配置的 expectedHash 不匹配。
policy/attestation-hash-mismatch 当前策略证据不再与已接受的证明相匹配。
policy/policy-conformance-invalid 基线策略文件或被检查的策略文件包含无效的比较语法。
policy/policy-conformance-missing 被检查的策略文件缺少基线策略文件所要求的规则。
policy/policy-conformance-weaker 被检查的策略文件的值比基线策略文件更弱。
policy/channels-denied-provider 已启用的频道匹配到了一条频道拒绝规则。
policy/mcp-denied-server 配置的 MCP 服务器被策略拒绝。
policy/mcp-unapproved-server 配置的 MCP 服务器不在允许列表中。
policy/models-denied-provider 配置的模型提供方或模型引用使用了被拒绝的提供方。
policy/models-unapproved-provider 配置的模型提供方或模型引用不在允许列表中。
policy/network-private-access-enabled 当策略拒绝时，启用了私有网络 SSRF 逃逸开关。
policy/routing-bindings-required 策略要求频道路由绑定，但未进行配置。
policy/routing-binding-channel-unconfigured 路由绑定所命名的频道不存在于 channels.* 中。
policy/routing-agent-mismatch 已编写的路由解析到了不同的 agent。
policy/routing-match-kind-mismatch 已编写的路由匹配到了意外的绑定特异性级别。
policy/ingress-dm-policy-unapproved 频道 DM 策略不在策略允许列表中。
policy/ingress-dm-scope-unapproved session.dmScope 与策略要求的 DM 隔离范围不匹配。
policy/ingress-open-groups-denied 频道组策略为 open，而策略拒绝开放组入口。
policy/ingress-group-mention-required 频道或组条目禁用了提及门控，而策略要求启用。
policy/gateway-non-loopback-bind 当策略拒绝时，网关绑定姿态允许非回环暴露。
policy/gateway-auth-disabled 当策略要求认证时，网关认证被禁用。
policy/gateway-rate-limit-missing 当策略要求时，网关认证限流姿态未明确配置。
policy/gateway-control-ui-insecure 网关 Control UI 不安全暴露切换已启用。
policy/gateway-tailscale-funnel 当策略拒绝时，网关 Tailscale Funnel 暴露已启用。
policy/gateway-remote-enabled 当策略拒绝时，网关远程模式处于活动状态。
policy/gateway-http-endpoint-enabled 在策略拒绝时，网关 HTTP API 端点已启用。
policy/gateway-http-url-fetch-unrestricted 网关 HTTP URL-fetch 输入缺少必需的 URL 白名单。
policy/gateway-node-command-denied 被策略拒绝的网关节点命令未被 OpenClaw 配置拒绝。
policy/agents-workspace-access-denied agent 沙箱模式或工作区访问超出了策略允许列表。
policy/agents-tool-not-denied agent 或默认配置未拒绝策略要求拒绝的某个工具。
policy/tools-profile-unapproved 配置的全局或按 agent 工具配置文件不在允许列表中。
policy/tools-fs-workspace-only-required 文件系统工具未配置为仅限工作区路径姿态。
policy/tools-exec-security-unapproved exec 安全模式不在策略允许列表中。
policy/tools-exec-ask-unapproved exec ask 模式不在策略允许列表中。
policy/tools-exec-host-unapproved exec 主机路由不在策略允许列表中。
policy/tools-elevated-enabled 当策略拒绝时，已启用提升权限工具模式。
policy/tools-also-allow-missing 配置的 alsoAllow 列表缺少策略要求的条目。
policy/tools-also-allow-unexpected 配置的 alsoAllow 列表包含策略未预期的条目。
policy/tools-required-deny-missing 全局或按 agent 的工具拒绝列表未包含所需的被拒绝工具。
policy/sandbox-mode-unapproved 沙箱模式不在策略允许列表中。
policy/sandbox-backend-unapproved 沙箱后端不在策略允许列表中。
policy/sandbox-container-posture-unobservable 对某个无法观测的后端启用了容器姿态规则。
policy/sandbox-container-host-network-denied 基于容器的沙箱或浏览器使用了主机网络模式。
policy/sandbox-container-namespace-join-denied 基于容器的沙箱或浏览器加入了另一个容器命名空间。
policy/sandbox-container-mount-mode-required 基于容器的沙箱或浏览器挂载不是只读的。
policy/sandbox-container-runtime-socket-mount 基于容器的沙箱或浏览器挂载暴露了容器运行时 socket。
policy/sandbox-container-unconfined-profile 当策略拒绝时，容器沙箱配置文件为 unconfined。
policy/sandbox-browser-cdp-source-range-missing 当策略要求时，沙箱浏览器 CDP source range 缺失。
policy/data-handling-telemetry-content-capture 当策略拒绝时，遥测内容捕获已启用。
policy/data-handling-session-retention-not-enforced 当策略要求时，未强制执行会话保留维护。
policy/data-handling-session-transcript-memory-enabled 当策略拒绝时，会话转录记忆索引已启用。
policy/secrets-unmanaged-provider 配置的 SecretRef 引用了未在 secrets.providers 下声明的提供方。
policy/secrets-denied-provider-source 配置的 secret 提供方或 SecretRef 使用了被策略拒绝的来源。
policy/secrets-insecure-provider 当策略拒绝时，secret 提供方选择了不安全姿态。
policy/auth-profile-invalid-metadata 配置的 auth profile 缺少有效的提供方或模式元数据。
policy/auth-profile-unapproved-mode 配置的 auth profile 模式不在策略允许列表中。
policy/exec-approvals-missing 策略要求 SQLite exec approvals 文档，但其行缺失。
policy/exec-approvals-invalid 配置的 SQLite exec approvals 文档无法解析。
policy/exec-approvals-default-security-unapproved exec approval 默认值使用了不在策略允许列表中的安全模式。
policy/exec-approvals-agent-security-unapproved 按 agent 生效的 exec approval 安全模式不在允许列表中。
policy/exec-approvals-auto-allow-skills-enabled 当策略拒绝时，执行审批代理会隐式自动允许技能 CLI。
policy/exec-approvals-allowlist-missing approvals 允许列表缺少策略要求的模式。
policy/exec-approvals-allowlist-unexpected approvals 允许列表包含策略未预期的模式。
policy/tools-missing-risk-level 受治理的工具声明缺少风险元数据。
policy/tools-unknown-risk-level 受治理的工具声明使用了未知的风险值。
policy/tools-missing-sensitivity-token 受治理的工具声明缺少敏感度元数据。
policy/tools-missing-owner 受治理的工具声明缺少所有者元数据。
policy/tools-unknown-sensitivity-token 受治理的工具声明使用了未知的敏感度值。

结果可以包括 target（观察到的不符合的工作区事物）和 requirement（使其成为结果的创作规则）。两者都是 oc:// 地址字符串，但字段名称描述的是策略角色而不是地址格式。

发现示例：

json
{  "checkId": "policy/channels-denied-provider",  "severity": "error",  "message": "Channel 'telegram' uses denied provider 'telegram'.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/channels/telegram",  "target": "oc://openclaw.config/channels/telegram",  "requirement": "oc://policy.jsonc/channels/denyRules/#0",  "fixHint": "Telegram is not approved for this workspace."}
json
{  "checkId": "policy/tools-missing-risk-level",  "severity": "error",  "message": "AGENTS.md tool 'deploy' has no explicit risk classification.",  "source": "policy",  "path": "AGENTS.md",  "line": 12,  "ocPath": "oc://AGENTS.md/tools/deploy",  "target": "oc://AGENTS.md/tools/deploy",  "requirement": "oc://policy.jsonc/tools/requireMetadata"}
json
{  "checkId": "policy/mcp-unapproved-server",  "severity": "error",  "message": "MCP server 'remote' is not in the policy allowlist.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/mcp/servers/remote",  "target": "oc://openclaw.config/mcp/servers/remote",  "requirement": "oc://policy.jsonc/mcp/servers/allow"}
json
{  "checkId": "policy/models-unapproved-provider",  "severity": "error",  "message": "Model ref 'anthropic/claude-sonnet-4.7' uses unapproved provider 'anthropic'.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/agents/defaults/model/fallbacks/#0",  "target": "oc://openclaw.config/agents/defaults/model/fallbacks/#0",  "requirement": "oc://policy.jsonc/models/providers/allow"}
json
{  "checkId": "policy/network-private-access-enabled",  "severity": "error",  "message": "Network setting 'browser-private-network' allows private-network access.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "target": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "requirement": "oc://policy.jsonc/network/privateNetwork/allow"}
json
{  "checkId": "policy/gateway-non-loopback-bind",  "severity": "error",  "message": "Gateway bind setting 'gateway-bind' permits non-loopback exposure.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/gateway/bind",  "target": "oc://openclaw.config/gateway/bind",  "requirement": "oc://policy.jsonc/gateway/exposure/allowNonLoopbackBind"}
json
{  "checkId": "policy/gateway-node-command-denied",  "severity": "error",  "message": "Gateway node command 'system.run' is denied by policy but not denied by OpenClaw config.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/gateway/nodes/commands/deny",  "target": "oc://openclaw.config/gateway/nodes/commands/deny",  "requirement": "oc://policy.jsonc/gateway/nodes/denyCommands",  "fixHint": "Add 'system.run' to gateway.nodes.commands.deny or update policy after review."}
json
{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "agents.defaults sandbox workspaceAccess 'rw' is not allowed by policy.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "target": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "requirement": "oc://policy.jsonc/agents/workspace/allowedAccess"}

修复

doctor --lint 和 policy check 为只读操作。

doctor --fix 仅在 workspaceRepairs 明确启用时，才会编辑受策略管理的工作区设置；否则，检查会报告它们将会修复的内容，并保持设置不变。

修复可以禁用 channels.denyRules 拒绝的通道并应用下面列出的自动缩小修复。仅在审核策略文件后才启用 workspaceRepairs，因为有效的规则可以更改工作区配置：

  • 当全局策略禁止提升权限工具时，将 tools.elevated.enabled=false
  • 当策略要求拒绝这些工具时，将缺少的必需拒绝工具 ID 添加到 tools.deny 或 agents.entries.*.tools.deny
  • 将不安全的 gateway.controlUi.* 开关设为 false
  • 当策略禁止远程 gateway 模式时，将 gateway.mode=local
  • 当策略禁止 Gateway HTTP API 端点时，将报告的 gateway.http.endpoints.*.enabled 路径设为 false
  • 当策略禁止开放的组入口时，将报告的通道入口 groupPolicy 路径设为 allowlist
  • 当策略要求组提及时，将报告的通道入口 requireMention 路径设为 true
  • 当策略禁止遥测内容捕获时，将 diagnostics.otel.captureContent=false，或对于对象形式的遥测捕获设置，将 diagnostics.otel.captureContent.enabled=false

作用域内的提升权限工具修复仅进行检测，不会实际修复。若发现结果报告的是共享遥测配置，则作用域内的数据处理修复也会跳过，因为更改共享设置会影响超出作用域策略目标的范围。

dataHandling.sensitiveLogging.requireRedaction无检查无维修。敏感日志编辑在 OpenClaw 中是无条件的，因此没有任何内容可以将其报告为已禁用。关键仍然是受支持的策略规则：openclaw policy 验证其形状，openclaw policy compare 仍然要求候选策略至少与其基线一样严格，openclaw policy check 在 dataHandling 证据和证明中记录运行时不变 oc://openclaw.invariant/logging/redaction，作为满足要求的证据。

当发现结果报告的是继承的根级 tools.deny 时，会跳过作用域内的必需拒绝修复，因为将所需工具添加到根配置会影响超出作用域策略目标的范围。仅限代理本地的必需拒绝修复可以更新报告的 agents.entries.*.tools.deny 路径。

当发现报告继承 channels.defaults.* 时，会跳过范围通道入口修复，因为更改共享通道默认值会影响范围策略目标以外的范围。网关 HTTP URL-fetch 白名单发现结果仍需手动进行，因为自动修复无法选择正确的端点 URL 白名单值。

Gateway 绑定和节点命令的发现仍需人工审查。当 policy/gateway-non-loopback-bind 或 policy/gateway-node-command-denied 可以映射到某个配置路径时，doctor --fix 会将建议的 gateway.bind 或 gateway.nodes.commands.deny 更改作为跳过的预览指导进行报告。它不会应用该更改，并且在操作员审查并更新配置或策略之前，该发现不算已修复。

jsonc
{  "plugins": {    "entries": {      "policy": {        "config": {          "workspaceRepairs": true,        },      },    },  },}

退出代码

命令 0 1 2
policy check 阈值下无发现项。 一项或多项发现达到了阈值。 参数或运行时失败。
policy compare 策略文件至少与基线一样严格。 策略文件无效、缺失，或比基线规则更宽松。 参数或运行时失败。
policy watch 无发现项且已接受的哈希仍为最新。 存在发现项或已接受的证明已过期。 参数或运行时失败。
本页有帮助吗？