Verifiedon 2026.7.1-2
Action boundary
Before you act
- Expected result
- A redacted configuration snapshot identifies active file, validation result, and one relevant path without revealing a credential.
- Failure mode
- A broad config dump, shell history, or screenshot turns a secret or private endpoint into a diagnostic artifact.
- Rollback
- Do not write configuration; remove any unsafe evidence from the diagnostic packet and re-capture a narrow redacted result.
Read narrowly, validate first
openclaw config file identifies the active configuration file. openclaw config validate --json checks it against the active schema without starting the gateway. For a hypothesis, use config get <path> rather than copying the whole file: the documented command reads from a redacted config snapshot, so secrets do not print.
Lab: configuration evidence card
Record: active config path category (not the full private path if it identifies a person), validator exit/result, and one non-secret setting relevant to the symptom. Good examples are a workspace path category, selected model name, or whether a channel account is enabled. Use config schema when you need to understand a path before reading it.
Write safety
Do not turn this lesson into a repair. config set can parse JSON5 and object assignment can replace values. If a later repair needs config patch, first create a patch file, run openclaw config patch --file ./openclaw.patch.json5 --dry-run, and preserve the current validation result. In Nix mode, writers intentionally refuse; change the declared Nix source rather than bypassing that boundary.
Checkpoint
A missing path returns a non-zero result. That is evidence for a missing or renamed configuration surface—not permission to invent a replacement key. Check the current schema and version before changing anything.
Source provenanceVerification and sources
Review receipt rr_cli_config_inspection
- Outcome
- approved
- Method
- source-review
- Reviewer
- forge-independent-review
- Reviewed
Evidence
- openclaw-docs-index — openclaw-main-1237c0c-cli-config; snapshot
4c4f8edb1973…
Limitations
- Primary-source editorial review; no learner configuration was modified.
Lesson checkpoint
Ready to move on?
Mark this lesson complete when you can apply its outcome without relying on the examples above.