diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 4496407c3..862ad7f45 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "88da533714e5f9d6988d4a0af32bb62cd059fb52",
-  "syncedAt": "2026-05-01T08:56:18.526Z"
+  "sha": "94543092be042eedfed7316da5e8097bfc5ea13f",
+  "syncedAt": "2026-05-01T09:09:34.303Z"
 }
diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256
index 8c999c3e9..5b532b8ff 100644
--- a/docs/.generated/config-baseline.sha256
+++ b/docs/.generated/config-baseline.sha256
@@ -1,4 +1,4 @@
-d70e31fd5f36d4b117ffa750fba88072d6714edc245a18d4b0915a2d11ce603a  config-baseline.json
-0a259216178a582c567d1fa48c5236bff4bbd27c3e6af838ffcd042459ffce3c  config-baseline.core.json
+516de8f5049d2c8b7f326cfc1b665cf459609aa491c432d93b8ca8b9463d7243  config-baseline.json
+b06e5cd6e7d3a26d99fd4d31d576c49958195451b0b1e9c2db45f038a3c16c44  config-baseline.core.json
 da8e055ebba0730498703d209f9e2cfaa1484a83f3240e611dcdd7280e22a525  config-baseline.channel.json
 4d017161b4dc986fdc6cc68167fedbd1d415ddbcd66125a872e18aa1769cd182  config-baseline.plugin.json
diff --git a/docs/gateway/config-agents.md b/docs/gateway/config-agents.md
index f3cc2276b..8849e6342 100644
--- a/docs/gateway/config-agents.md
+++ b/docs/gateway/config-agents.md
@@ -67,6 +67,20 @@ Disables automatic creation of workspace bootstrap files (`AGENTS.md`, `SOUL.md`
 }
 ```
 
+### `agents.defaults.skipOptionalBootstrapFiles`
+
+Skips creation of selected optional workspace files while still writing required bootstrap files. Valid values: `SOUL.md`, `USER.md`, `HEARTBEAT.md`, and `IDENTITY.md`.
+
+```json5
+{
+  agents: {
+    defaults: {
+      skipOptionalBootstrapFiles: ["SOUL.md", "USER.md"],
+    },
+  },
+}
+```
+
 ### `agents.defaults.contextInjection`
 
 Controls when workspace bootstrap files are injected into the system prompt. Default: `"always"`.