📦 Config Preflight Validator — 配置预校验工具
v1.0.0OpenClaw 配置预校验工具。在执行 config.patch 或修改 openclaw.json 前进行本地 Schema 验证，提供具体的错误字段描述。
0· 296·2 当前·2 累计
by 安全扫描
OpenClaw
安全
high confidence技能的代码和指令与其声明的目的（OpenClaw 配置的本地 JSON Schema 验证）相匹配，且不请求无关的凭据或安装。
评估建议
该技能似乎能实现其所述功能：OpenClaw 配置的本地 Schema 验证。在安装或运行之前，(1) 请确认您信任脚本可能调用的 'openclaw' CLI（脚本将调用它来获取 schema），(2) 注意它将在 ~/.openclaw/workspace/.lib/openclaw_schema.json 创建/读取缓存，(3) 考虑安装 jsonschema 包（pip install jsonschema）以进行更严格的验证。同时请注意打包位置的小 mismatch：您可能需要将提供的脚本放置在 SKILL.md 示例所期望的位置，或通过其明确路径运行。...详细分析 ▾
✓ 用途与能力
名称/描述、SKILL.md 和包含的 Python 脚本是一致的：工具通过 openclaw CLI 获取实时 schema、缓存它并运行本地验证。脚本使用 subprocess 调用 openclaw CLI 和简单的本地文件 I/O 与所述目的相符。注：SKILL.md 示例引用从 ~/.openclaw/workspace/.lib 运行脚本，但仓库提供的是 scripts/config-preflight-validator.py — 这是一个打包/位置不匹配（而非安全不匹配）。
✓ 指令范围
运行时指令和脚本将其操作限制为：调用 'openclaw gateway config.schema' CLI（可选）、读取指定的配置文件，以及在用户主目录下读取/写入 schema 缓存 (~/.openclaw/...) 。脚本本身没有到外部端点的网络调用，除了明确的缓存和用户提供的文件路径外不能访问文件系统的其他部分，且没有授予 agent 任意数据收集的宽泛模糊指令。
✓ 安装机制
未提供安装规范（仅指令）并附有一个小型 Python 脚本。这是较低风险的模式：安装时不会下载任何内容。脚本可选地偏好使用 jsonschema 包进行完整验证（已文档化）。
✓ 凭证需求
该技能不请求环境变量或凭据。脚本依赖 PATH 来定位 'openclaw' CLI 并使用用户主目录进行缓存 — 两者都与其目的相称。没有隐藏的密钥访问。
✓ 持久化与权限
该技能不请求持久或平台级权限（始终为 false）。它在用户主目录下写入本地 schema 缓存，这对于此功能是预期的且范围有限。该技能不会更改其他技能的配置或系统级设置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/3/5
初始版本：在配置更改前提供本地 JSON Schema 验证，以防止模糊的验证问题。
● 无害
安装命令
点击复制官方npx clawhub@latest install config-preflight-validator
镜像加速npx clawhub@latest install config-preflight-validator --registry https://cn.longxiaskill.com
技能文档
解决 "Validation issues" 错误信息模糊的问题，在调用网关 API 前给出具体错误字段描述。
🎯 功能特性
- Schema 同步：自动从
gateway config.schema获取最新规范。 - 本地校验：在提交修改前，基于 JSON Schema 验证数据结构。
- 特定规则检查：针对
plugins.allow等列表格式、channels对象格式进行硬编码校验。
🚀 使用方法
校验补丁
python3 ~/.openclaw/workspace/.lib/config-preflight-validator.py --patch '{"plugins": {"allow": ["new-plugin"]}}'
校验完整文件
python3 ~/.openclaw/workspace/.lib/config-preflight-validator.py --file ~/.openclaw/openclaw.json
更新 Schema 缓存
python3 ~/.openclaw/workspace/.lib/config-preflight-validator.py --update-schema
🛠️ 安装要求
- Python 3.9+
- 推荐安装
jsonschema(pip install jsonschema)