Playbook • CONFIG

openclaw.json Mastery

$14

A safer way to understand and fix OpenClaw config without exposing secrets: known-good examples, permission notes, smoke tests, and rollback steps.

Plain-English version

Use this when OpenClaw starts acting differently after a config edit. It helps you compare your setup to a simple known-good version, test the result, and undo the change if it still feels wrong.

Helps you avoid
  • config drift
  • permission breakage
  • broken file/tool access
Best for
  • OpenClaw users whose file or tool access changed unexpectedly
  • teams that need a known-good config before experimenting
  • operators cleaning up profile or permission drift
Includes
  • A simple way to get reliable answers to specific configuration questions
  • Known-good minimal configs (with explanations)
  • Profiles & permissions: what changes what (and how to revert)
  • Top 10 config mistakes + fix checklist
  • Smoke tests: quick commands to verify you’re ‘back to green’
  • A config-change proof card so normal work does not resume on vibes alone
What’s included
  • openclaw.minimal.json and openclaw.tool-profile.json known-good starter examples
  • config-naming-compatibility.md for installs that use config.yaml, env overrides, or profile-specific paths
  • symptom-to-fix-matrix.md, config-cheatsheet.md, and top-10-breakage-fixes.md for diagnosis
  • config-diff-checklist.md and smoke-test-checklist.md for before/after proof, including a failed-smoke triage ladder when checks do not pass
  • config-change-proof-card.md for GREEN / YELLOW / RED resume decisions
  • secret-redaction-worksheet.md so you can ask for help without leaking keys, tokens, buyer data, private endpoints, or home paths
  • current-code-config-review.md for repo-aware OpenClaw config questions, including an AI answer acceptance gate before applying advice
  • first-safe-config-change-example.md for a concrete 15-minute reversible permission-fix receipt before you touch your own setup
  • rollback-notes.md so config fixes keep a path back
Before a config fix: make the rollback point first

Config Mastery helps you compare and repair `openclaw.json`. If the edit could break a working setup, pair it with OpenClaw Safety Net so you have a verified backup, restore drill, and closeout note before changing real agent routes.

  1. Name the config symptom and the exact file or profile you plan to change.
  2. Snapshot the current working state before copying examples or changing provider/auth/tool settings.
  3. After the edit, run the smoke test from this pack and keep the restore path until one real agent task is back to green.
Good to know before you buy
  • Pair with OpenClaw Safety Net before risky config edits if you also need a verified backup, restore drill, and rollback path.
  • No support. You get the asset as-is.
  • We’ll keep the playbook updated as OpenClaw evolves.
No-support policy: low-cost digital downloads sold as‑is; no 1:1 support is included.