Files
openclaw/docs/plugins/reference/policy.md
Gio Della-Libera 1e2e614748 Policy: add tool posture conformance checks (#85482)
* feat(policy): add tool posture conformance

* fix(policy): attest tool alsoAllow posture
2026-05-23 16:44:42 -07:00

1.6 KiB

summary, read_when, title
summary read_when title
Adds policy-backed doctor checks for workspace conformance.
You are installing, configuring, or auditing the policy plugin
Policy plugin

Policy plugin

Adds policy-backed doctor checks for workspace conformance.

Distribution

  • Package: @openclaw/policy
  • Install route: included in OpenClaw

Surface

plugin; CLI command: openclaw policy

Behavior

The Policy plugin contributes doctor health checks for policy-managed OpenClaw settings and governed workspace declarations. Policy currently covers channel conformance, governed tool metadata, MCP server posture, model-provider posture, private-network access posture, Gateway exposure posture, agent workspace/tool posture, configured global/per-agent tool posture, and OpenClaw config secret provider/auth profile posture.

Policy stores authored requirements in policy.jsonc, observes existing OpenClaw settings and workspace declarations as evidence, and reports drift through openclaw policy check and openclaw doctor --lint. A clean policy check emits policy, evidence, findings, and attestation hashes that operators can record for audit.

Tool posture rules can require approved profiles, workspace-only filesystem tools, bounded exec security/ask/host settings, disabled elevated mode, and required tool deny entries. The evidence also records additive alsoAllow entries because they can widen effective tool posture. These checks observe config conformance only; they do not read runtime approval state or add runtime enforcement.