技能介绍

问题从哪来

Agent 工作区会不断安装各类技能：它们可能执行 shell、访问网络、读写敏感数据。若没有在仓库里写清「允许什么、禁止什么」，你很难判断某个技能是否符合团队基线，也无法证明工作区本身是否具备基本的审计与隔离习惯。

技能如何工作

OpenClaw Marshal 用一份本地策略文件 .marshal-policy.json 统一描述规则，再对工作区与已安装技能做合规扫描，全程 Python 标准库、无 pip、无外网调用。

典型流程：

Initialize Policy：生成带合理默认值的策略文件
Show Policy / Policy Summary：查看当前生效规则
Full Compliance Audit：对所有技能与工作区配置打分，列出违规项与建议
Check Specific Skill：单技能按规则逐项 pass/fail
Generate Compliance Report：输出可复制进审计材料的格式化报告
Quick Status：一行摘要（策略是否加载、合规分、严重违规数）

检查维度包括：Command Safety（如 eval、pipe-to-shell、rm -rf / 等危险模式）、Command Policy（commands.allow / block / review）、Network Policy（域名白黑名单与可疑 TLD）、Data Handling（密钥扫描、PII 扫描是否配置）、Workspace Hygiene（.gitignore、ledger 审计轨迹、signet 技能签名）、以及调试/冗长日志等 Configuration 项。进程退出码：0 合规、1 需人工复核、2 存在严重违规。

未传 --workspace 时，会依次尝试 OPENCLAW_WORKSPACE、当前目录（存在 AGENTS.md）、默认 ~/.openclaw/workspace。

适用边界

本技能侧重 策略定义与审计报告，不包含基于 hook 的实时拦截或自动修复；需要阻断执行、心跳集成或 GDPR/HIPAA/SOC2 模板时，需参考 SKILL 中提到的 openclaw-marshal-pro 能力。可与 OpenClaw、Claude Code、Cursor 等遵循 Agent Skills 规范的环境配合使用。