政策规则参考

每个受支持的规则命名空间，逐个字段。 openclaw policy 参考的一部分。

政策规则参考

下面的每条规则都是可选的；只有当规则存在时才会运行检查。已观察到的状态是现有的 OpenClaw 配置或工作区元数据。

频道

MCP 服务器

模型提供方

网络

消息路由

检查 id 必须是唯一的。路由支持channel，可选accountId、peer、parentPeer、guildId、teamId、memberRoleIds。对等类型为 direct、group 和 channel。 matchedBy 可以包含一种或多种运行时匹配类型，包括 binding.peer、binding.account、binding.channel 或 default。

路由检查仅用于一致性验证。它们不会改变启动、消息投递、绑定优先级或回退行为。发现项需要操作员审查，因为自动更改绑定可能会重定向私信。

Ingress和通道接入

网关

gateway.nodes.denyCommands 是一个精确、区分大小写的策略拒绝超集规则。 当 policy 必须证明特权节点命令已被 OpenClaw 配置明确拒绝时，请使用它。 对于故意允许某个特权节点命令的部署，应在审查后更新 policy.jsonc，而不是仅依赖 gateway.nodes.commands.allow。

代理工作区

沙盒姿势

策略将缺失的 sandbox.mode 视为其隐含默认值 off，因此 sandbox.requireMode 会将新建或未配置的 sandbox 视为不在诸如 ["all"] 之类的允许列表中。

数据处理

秘密

Exec 批准

Exec-approvals 检查默认读取 ~/.openclaw/state/openclaw.sqlite 中的运行时 exec_approvals_config 单例行，或者当设置 OPENCLAW_STATE_DIR 时读取 $OPENCLAW_STATE_DIR/state 下的同一数据库。调查结果使用稳定的 oc://exec-approvals.json/... URI 方案，该方案解决存储在该行中的权威 JSON 文档内的路径。 execApprovals.defaults.* 或 execApprovals.agents.* 下的姿势规则需要可读的工件证据；丢失或无效的工件报告为不可观察的证据，而不是尽力通过。一旦可读，省略的字段将继承运行时默认值：缺少 defaults.security 是 full，缺少代理安全性将继承该默认值。证据包括defaults、agents.*、agents.*.allowlist[].pattern、可选的argPattern、有效的autoAllowSkills姿势和条目源——从不套接字path/token、commandText、lastUsedCommand、解析路径或时间戳。

示例：要求 approvals 工件、拒绝宽松默认值，并仅允许为选定代理审查过的 exec approval 姿态。

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Security modes: "deny", "allowlist", or "full".      // This default permits only the locked-down deny posture.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Selected agents may use reviewed allowlist posture, but not "full".          "allowSecurity": ["allowlist"],          // false means skill CLIs must appear in the reviewed allowlist instead of          // being implicitly approved by autoAllowSkills.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Simple entry: exact reviewed executable pattern with no argPattern.              "travel-hub",              // Constrained entry: pattern plus reviewed argument regex.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

Auth 配置文件

工具元数据

工具姿态

工具要求使用相同的组成员身份、别名和 * 匹配作为核心工具策略。例如，group:fs包含ls，group:runtime包含secrets，cron解析为automations，图像理解工具为view_image。所需的拒绝列表必须涵盖所需组中的每个工具；空列表不包含任何内容，并且否认 write 并不否认 apply_patch。