Docs: add policy rule reference tables#85795
Conversation
|
Codex review: needs maintainer review before merge. Latest ClawSweeper review: 2026-05-23 18:44 UTC / May 23, 2026, 2:44 PM ET. Workflow note: Future ClawSweeper reviews update this same comment in place. How this review workflow works
PR Surface View PR surface stats
Summary Reproducibility: not applicable. this is a stacked policy/docs PR rather than a bug report. The review used the PR body, related parent context, current-main source, and the local PR commits instead of a failing reproduction path. PR rating Rank-up moves:
What the crustacean ranks mean
Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics. Real behavior proof Risk before merge
Maintainer options:
Next step before merge Security Review detailsBest possible solution: Settle the parent policy tool-posture PR first, then rebase this follow-up so reviewers can evaluate the policy reference tables as the remaining change. Do we have a high-confidence way to reproduce the issue? Not applicable: this is a stacked policy/docs PR rather than a bug report. The review used the PR body, related parent context, current-main source, and the local PR commits instead of a failing reproduction path. Is this the best way to solve the issue? Yes for the docs direction, but not as a direct merge while it carries the parent feature. The maintainable path is to decide the parent policy contract first and then land this as a rebased docs follow-up. Label justifications:
What I checked:
Likely related people:
Codex review notes: model gpt-5.5, reasoning high; reviewed against edbd8333511c. |
|
ClawSweeper PR egg ✨ Hatched: 🥚 common Sunspot Diff Drake Hatch commandComment Hatchability rules:
Rarity: 🥚 common. What is this egg doing here?
|
042bd01 to
05b9839
Compare
Summary
This docs-only follow-up upgrades the policy CLI page with a normalized field reference for every current policy category, including the tool-posture section that is now on main from #85482.
The goal is to make the operator-facing policy contract easier to review: each table maps a policy.jsonc field to the OpenClaw config or workspace evidence it observes and the reason an operator would use it.
Verification
Real behavior proof
Behavior addressed: Documentation-only reference coverage for existing Policy plugin rule fields.
Real environment tested: WSL checkout at /root/src/openclaw-policy-doc-reference-tables on Ubuntu-24.04.
Exact steps or command run after this patch: Ran docs listing, MDX validation, Markdown formatting, whitespace checks, and Codex review against the docs-only diff from origin/main.
Evidence after fix: docs/cli/policy.md now includes field-reference tables for channels, MCP servers, model providers, network, Gateway, agent workspace, secrets, auth profiles, tool metadata, and tool posture.
Observed result after fix: Docs checks, formatting checks, whitespace checks, and Codex review pass with no accepted/actionable findings.
What was not tested: Runtime policy behavior; this PR changes documentation only.