Config Preflight Validator

在调用网关 config.patch 或修改 openclaw.json 前做本地 JSON Schema 校验，支持校验配置补丁或完整配置文件，并对 plugins.allow、channels 等做规则检查，输出具体错误字段；Schema 可从网关同步缓存。依赖 Python 3.9+，推荐安装 jsonschema。

halfmoon82

热度 67.38

最近更新 2026-05-11 17:28:46

分类：效率依赖：代码执行 / 读写文件 / 第三方 API应用场景：数据处理 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add config-preflight-validator

Metadata

name: config-preflight-validator
description: OpenClaw 配置预校验工具。在执行 config.patch 或修改 openclaw.json 前进行本地 Schema 验证，提供具体的错误字段描述。
version: 1.0.0
author: DeepEye
tags: ["config","validation","schema","production","safety"]

🔍 Config Preflight Validator

解决 "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)