← Back to Skills Marketplace
emberdesire

Jasper ConfigGuard

by emberDesire · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1527
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install jasper-configguard
Description
Safely apply OpenClaw config changes with backup, automatic rollback on failure, health checks, and commands for patching, restoring, listing, diffing, valid...
README (SKILL.md)

Jasper ConfigGuard v1.0.0

Safe config changes for OpenClaw with automatic rollback. Never brick your gateway again.

Setup

npm install -g jasper-configguard

Usage

Apply a config change safely

jasper-configguard patch '{"gateway":{"bind":"tailnet"}}'

The tool will:

  1. Back up your current config
  2. Apply the patch (deep merge)
  3. Restart the gateway
  4. Wait for health check
  5. Auto-rollback if gateway fails

Preview changes

jasper-configguard patch --dry-run '{"agents":{"defaults":{"model":{"primary":"opus"}}}}'

Restore from backup

jasper-configguard restore

List backups

jasper-configguard list

Check health

jasper-configguard doctor

Agent Integration

Use from your agent to safely modify OpenClaw config:

# Safe model switch
jasper-configguard patch '{"agents":{"defaults":{"model":{"primary":"anthropic/claude-opus-4-5"}}}}'

# Enable a plugin safely
jasper-configguard patch '{"plugins":{"entries":{"my-plugin":{"enabled":true}}}}'

# If something breaks, restore
jasper-configguard restore

API

const { ConfigGuard } = require('jasper-configguard');
const guard = new ConfigGuard();

// Safe patch
const result = await guard.patch({ gateway: { bind: 'tailnet' } });
if (!result.success) console.log('Rolled back:', result.error);

// Dry run
const preview = guard.dryRun({ agents: { defaults: { model: { primary: 'opus' } } } });
console.log(preview.diff);
Usage Guidance
This package appears to do what it says: it reads/writes your OpenClaw config (~/.openclaw/openclaw.json), stores backups in ~/.openclaw/config-backups/, and may restart the gateway process (pgrep/kill). Before installing or letting an agent invoke it autonomously, consider: (1) Verify the package source (npm name, repository, owner) and that you trust the publisher. (2) Back up your current config manually. (3) Run it in a non-production environment first (use --dry-run and --no-restart). (4) Ensure the agent/runtime has only the minimum permissions you are comfortable with — this tool needs filesystem write access and the ability to signal processes. (5) Note the minor metadata mismatch: the registry metadata lists no required config paths, but the tool expects ~/.openclaw; ensure path expectations match your deployment. If you want stricter control, require manual confirmation for patches or avoid enabling autonomous invocation for this skill.
Capability Analysis
Type: OpenClaw Skill Name: jasper-configguard Version: 1.0.0 The OpenClaw AgentSkills skill bundle 'jasper-configguard' is designed for safe configuration management with automatic rollback for the OpenClaw gateway. The code (cli/configguard.js, src/index.js) uses file system operations (read/write config, manage backups in ~/.openclaw), process management (pgrep and kill -USR1 for 'openclaw-gateway' to restart), and local network calls (http.get to localhost:18789 for health checks). These actions are all directly and plausibly required for its stated purpose. There is no evidence of data exfiltration, arbitrary malicious execution, persistence mechanisms, or prompt injection attempts in SKILL.md or README.md. The capabilities, while involving system interaction, are tightly scoped to the intended function and do not indicate intentional harmful behavior.
Capability Assessment
Purpose & Capability
Name/README/SKILL.md all describe safe edits to an OpenClaw config and rollback behavior. The code operates on ~/.openclaw/openclaw.json (or cwd/openclaw.json), posts health-checks to localhost:18789, creates backups, writes files, and issues pgrep/kill commands to the gateway process — all coherent with a config-guard tool.
Instruction Scope
SKILL.md instructs installation via npm and shows CLI/programmatic usage that reads/writes ~/.openclaw/openclaw.json, manages backups in ~/.openclaw/config-backups/, and restarts the gateway. Those operations are expected for the tool, but the registry metadata did not declare any required config paths or filesystem access; the instructions explicitly require write access to ~/.openclaw which should be noted.
Install Mechanism
The skill bundle includes full source files but provides no install spec in the registry. SKILL.md instructs users to install via `npm install -g jasper-configguard` (which downloads code from the npm registry). No download-from-untrusted-URL or extraction steps are present in the manifest — risk is standard for installing an npm package; verify package provenance before global install.
Credentials
No environment variables or secrets are requested. The code uses HOME to locate config paths and expects write access to those paths. It does not request or transmit credentials or contact external endpoints beyond the local gateway (http://localhost:18789).
Persistence & Privilege
The skill will modify local configuration files and attempt to restart the gateway using OS signals (pgrep/kill). That is an expected privilege for a config management tool but is a privileged action on the host — consider whether the agent runtime should be allowed to perform these operations automatically.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jasper-configguard
  3. After installation, invoke the skill by name or use /jasper-configguard
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of jasper-configguard v1.0.0 - Safely apply configuration changes to OpenClaw with automatic backups and rollback on failure. - Includes health checks after service restarts; auto-restores previous config if OpenClaw fails to start. - Provides commands: patch (apply config), restore (from backup), list (backups), diff (preview changes), validate, and doctor (health check). - Supports dry-run for safe preview of configuration changes. - Agent and JavaScript API integration for automated config management.
Metadata
Slug jasper-configguard
Version 1.0.0
License
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Jasper ConfigGuard?

Safely apply OpenClaw config changes with backup, automatic rollback on failure, health checks, and commands for patching, restoring, listing, diffing, valid... It is an AI Agent Skill for Claude Code / OpenClaw, with 1527 downloads so far.

How do I install Jasper ConfigGuard?

Run "/install jasper-configguard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Jasper ConfigGuard free?

Yes, Jasper ConfigGuard is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Jasper ConfigGuard support?

Jasper ConfigGuard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Jasper ConfigGuard?

It is built and maintained by emberDesire (@emberdesire); the current version is v1.0.0.

💬 Comments