规则参考

所有受支持的规则命名空间，逐字段说明。本文是 openclaw policy 参考的一部分。

策略规则参考¶

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

渠道¶

MCP 服务器¶

模型提供方¶

网络¶

消息路由¶

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

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

入站与渠道访问¶

网关¶

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

Agent 工作区¶

沙箱安全态势¶

策略将缺失的 sandbox.mode 视为隐式默认值 off，因此 sandbox.requireMode 会将新建或未配置的沙箱报告为不在 ["all"] 之类的白名单内。

数据处理¶

机密¶

执行审批¶

执行审批检查默认读取 ~/.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 姿态以及条目来源——绝不包括套接字路径/令牌、commandText、lastUsedCommand、解析后的路径或时间戳。

示例：要求存在审批工件，拒绝宽松的默认值，并仅允许所选代理使用已审查的执行审批姿态。

{
  "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",
            ],
          },
        },
      },
    },
  },
}

认证配置文件¶

工具元数据¶

工具姿态¶

工具需求与核心工具策略使用相同的组成员关系、别名和 * 匹配规则。例如，group:fs 包含 ls，group:runtime 包含 secrets，cron 解析为 automations，图像理解工具是 view_image。所需的拒绝列表必须覆盖所需组中的每个工具；空列表不覆盖任何工具，且拒绝 write 不会拒绝 apply_patch。