Config Preflight Validator

这是OpenClaw配置预校验工具，解决官方验证错误模糊问题。核心功能：自动同步网关最新Schema规范，本地验证配置补丁或完整文件，额外针对plugins.allow等特定格式做硬编码校验。典型场景：执行config.patch或修改openclaw.json前预校验，通过命令行调用，支持校验补丁/文件、更新Schema缓存，输出具体错误字段。

halfmoon82

热度 67.53

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

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：DevOps / 数据处理

安装技能

复制下面的话术发给你的 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)