From 8e698115600c4be459e9f4c007192d2c406bf311 Mon Sep 17 00:00:00 2001
From: Arnav Panicker <117341727+addu2612@users.noreply.github.com>
Date: Mon, 29 Jun 2026 02:49:19 +0530
Subject: [PATCH] docs(cli): clarify strict json parsing (#80981)

---
 docs/cli/config.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/cli/config.md b/docs/cli/config.md
index 6fd3832d93cf..b06b7eee4a79 100644
--- a/docs/cli/config.md
+++ b/docs/cli/config.md
@@ -89,7 +89,7 @@ openclaw config set 'agents.list[1].tools.exec.node' "node-id-or-name"
 
 ## Values
 
-Values are parsed as JSON5 when possible; otherwise they are treated as strings. Use `--strict-json` to require JSON5 parsing. `--json` remains supported as a legacy alias.
+Values are parsed as JSON5 when possible; otherwise they are treated as strings. Use `--strict-json` to require standard JSON parsing with no string fallback. `--json` remains supported as a legacy alias for `--strict-json`.
 
 ```bash
 openclaw config set agents.defaults.heartbeat.every "0m"
@@ -97,6 +97,8 @@ openclaw config set gateway.port 19001 --strict-json
 openclaw config set channels.whatsapp.groups '["*"]' --strict-json
 ```
 
+When `--strict-json` is enabled, JSON5-only syntax such as comments, trailing commas, or unquoted object keys is rejected. Omit `--strict-json` for JSON5 value parsing with raw-string fallback.
+
 `config get <path> --json` prints the raw value as JSON instead of terminal-formatted text.
 
 <Note>