Config Audit

Validate OpenClaw configuration files for JSON syntax and model references.

9|3|Updated Apr 16, 2024
One-click install
npx skills add https://github.com/keiretsu-labs/kubernetes-manifests --skill config-audit-keiretsu-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Config Audit
Source: https://github.com/keiretsu-labs/kubernetes-manifests/tree/main/openclaw/workspaces/main/skills/config-audit
Command: npx skills add https://github.com/keiretsu-labs/kubernetes-manifests --skill config-audit-keiretsu-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, yq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your OpenClaw configuration files are syntactically correct, properly reference models and environments, and avoid common pitfalls that could lead to agent startup failures or unexpected behavior.

Core Features & Use Cases

  • JSON Syntax Validation: Checks for malformed JSON in openclaw.json.
  • Model Reference Verification: Ensures that all specified model providers and IDs are valid.
  • Environment Variable Escaping: Verifies correct escaping for variables intended for runtime resolution by OpenClaw, not Flux.
  • Agent Configuration Checks: Validates agent identity, workspace paths, and adherence to defaults.
  • Known Bad Pattern Detection: Identifies common misconfigurations and anti-patterns.
  • Use Case: After editing your openclaw.json to add a new AI model or agent, run this Skill to catch any syntax errors, incorrect model references, or improper environment variable escaping before deploying, preventing potential pod crashes.

Quick Start

Use the config audit skill to validate the openclaw.json file.

Frequently Asked Questions about Config Audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate openclaw.json syntax before deploying agents?

To validate openclaw.json syntax, use a config audit to detect malformed JSON, verify model references, and check environment variable escaping. This prevents agent startup failures and pod crashes by ensuring adherence to configuration best practices.

Why does my agent configuration fail on startup after editing openclaw.json?

Agent startup failures often stem from incorrect model references, invalid agent identity, or improper environment variable escaping intended for runtime resolution. A config audit identifies these common misconfigurations and known bad patterns before deployment.

Do I need jq and yq to run a config audit on OpenClaw?

Yes, you need jq and yq installed to run a config audit on OpenClaw. These command-line tools are required dependencies for parsing JSON and YAML structures, validating syntax, and verifying agent workspace paths during the audit process.

What is the best way to check environment variable escaping in OpenClaw configurations?

The best way to check environment variable escaping is using a config audit. It verifies that variables intended for runtime resolution by OpenClaw are escaped correctly, preventing Flux from resolving them prematurely and avoiding unexpected agent behavior.

Can I detect known bad patterns and anti-patterns in my OpenClaw config?

Yes, you can detect known bad patterns and anti-patterns in your OpenClaw config. The config audit identifies common misconfigurations, validates agent identity against defaults, and checks workspace paths to ensure your setup avoids pitfalls that cause unexpected behavior.