docs: sweep support troubleshooting updates

2026-01-25 04:33:14 +00:00
parent 26d3fbb09f
commit ede5145191
6 changed files with 25 additions and 1 deletions
--- a/docs/gateway/configuration.md
+++ b/docs/gateway/configuration.md
@@ -46,6 +46,9 @@ better forms without hard-coding config knowledge.
 Use `config.apply` to validate + write the full config and restart the Gateway in one step.
 It writes a restart sentinel and pings the last active session after the Gateway comes back.

+Warning: `config.apply` replaces the **entire config**. If you want to change only a few keys,
+use `config.patch` or `clawdbot config set`. Keep a backup of `~/.clawdbot/clawdbot.json`.
+
 Params:
 - `raw` (string) — JSON5 payload for the entire config
 - `baseHash` (optional) — config hash from `config.get` (required when a config already exists)