OpenClaw 中文文档
本页内容

本页内容

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

CLI 命令

范围政策覆盖

让指定代理或渠道遵守比基线更严格的规则。 openclaw policy 参考的一部分。

范围叠加

当特定代理或通道需要比顶层基线更严格的策略时，请使用 scopes.<scopeName>。作用域名称只是一个标签；匹配使用作用域内的选择器。覆盖是叠加式的：全局规则仍会运行，而作用域规则可以基于相同证据添加自己的发现。

选择器 支持的部分 适用场景
agentIds tools, agents.workspace, sandbox, dataHandling.memory, execApprovals 一个或多个运行时代理需要更严格的规则。
channelIds ingress.channels 一个或多个通道需要更严格的入口规则。

如果 agentIds 条目不存在于 agents.entries.* 中，则 OpenClaw 会根据该运行时代理 ID 的继承 global/default 状态评估范围规则，而不是跳过它。

jsonc
{  "tools": {    "exec": {      "allowHosts": ["sandbox", "node"],    },  },  "sandbox": {    "requireMode": ["all", "non-main"],  },  "scopes": {    "release-workspace": {      "agentIds": ["release-agent", "review-agent"],      "agents": {        "workspace": {          "allowedAccess": ["none", "ro"],        },      },    },    "release-lockdown": {      "agentIds": ["release-agent"],      "tools": {        "exec": {          "allowHosts": ["sandbox"],          "allowSecurity": ["deny", "allowlist"],          "requireAsk": ["always"],        },        "denyTools": ["exec", "process", "write", "edit", "apply_patch"],      },      "sandbox": {        "requireMode": ["all"],        "allowBackends": ["docker"],      },      "dataHandling": {        "memory": {          "denySessionTranscriptIndexing": true,        },      },    },    "shell-sandbox": {      "agentIds": ["shell-agent"],      "sandbox": {        "allowBackends": ["openshell"],        "containers": {          "requireReadOnlyMounts": false,        },      },    },    "telegram-ingress": {      "channelIds": ["telegram"],      "ingress": {        "channels": {          "allowDmPolicies": ["pairing"],          "denyOpenGroups": true,          "requireMentionInGroups": true,        },      },    },  },}

如果每个作用域管辖的是不同字段，那么同一个代理可以出现在多个作用域中，如上所示。对于同一个代理重复出现的作用域字段必须同样或更严格；更宽松的重复声明会被拒绝（允许列表必须是子集，拒绝列表必须是超集，必需布尔值必须固定）。

容器姿态规则（sandbox.containers.*）仅根据匹配代理的 sandbox 后端能够暴露的证据进行检查。Docker 和 Podman 后端会暴露相同的 sandbox.docker.* 容器姿态设置。如果某个后端无法观察到为其启用的规则，策略会报告 policy/sandbox-container-posture-unobservable，而不是判定通过；应将容器规则限定在使用能够暴露这些规则的后端的代理组中。

后端授权使用配置的身份。 backend: "docker" 需要 allowBackends: ["docker"]，而 backend: "podman" 需要 allowBackends: ["podman"]。

顶层的 ingress.session.requireDmScope 保持全局生效；session.dmScope 不是可归属于通道的证据，因此不能通过 channelIds 设置作用域。

policy.jsonc 中出现的每个 scope 都必须有效且可执行。

本页有帮助吗？