openclaw-config-guard

@ltotal/openclaw-config-guard is a publishable npm CLI that watches an OpenClaw config directory, splits large openclaw.json sections into conf.d/*.json, and touches the root config when sub-config files change so OpenClaw can hot-reload consistently.

The CLI provides:

• start, stop, restart, status, and logs commands for managing the background guard
• watch for foreground debugging
• config for an interactive settings wizard covering:
  • TARGET_DIR
  • MAX_BACKUPS
  • STABILITY_WAIT
  • USE_POLLING
  • POLL_INTERVAL
  • SUB_EXT
  • KEYS_TO_EXTRACT

Install

npm install -g @ltotal/openclaw-config-guard

Node.js 20.19.0 or newer is required.

Or run it without a global install:

npx @ltotal/openclaw-config-guard help

Commands

openclaw-config-guard config
openclaw-config-guard start
openclaw-config-guard status
openclaw-config-guard logs
openclaw-config-guard restart
openclaw-config-guard stop

For local debugging, you can also run the watcher in the foreground:

openclaw-config-guard watch

Config Wizard

The wizard stores settings in:

~/.openclaw-config-guard/config.json

Default values:

{
  "targetDir": "~/.openclaw",
  "maxBackups": 6,
  "stabilityWait": 5000,
  "usePolling": false,
  "pollInterval": 500,
  "subExt": ".json",
  "keysToExtract": [
    "agents",
    "gateway",
    "hooks",
    "models",
    "skills",
    "channels",
    "plugins",
    "bindings"
  ]
}

Runtime Files

The CLI keeps its own runtime files under:

~/.openclaw-config-guard/

• config.json: saved wizard settings
• state.json: active background process metadata
• guard.log: watcher logs
• guard.log.1 to guard.log.3: rotated log files when the active log exceeds 1 MiB

Publishing checklist

1. Confirm the GitHub URLs in package.json match the real repository.
2. Run npm run release:check.
3. Publish with npm run publish:npm -- --access public.

Development

npm install
npm test
npm run release:check
node ./bin/openclaw-config-guard.js help