diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index e123fd56b..078c54d0b 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "85ce75c005a256a977f0a5bb831c16aa1433bfc5",
-  "syncedAt": "2026-05-02T11:04:09.991Z"
+  "sha": "40f2bf3950590d2b0263034e451243a73efab96f",
+  "syncedAt": "2026-05-02T11:20:37.789Z"
 }
diff --git a/docs/tools/plugin.md b/docs/tools/plugin.md
index 6335cb60b..8dab7e207 100644
--- a/docs/tools/plugin.md
+++ b/docs/tools/plugin.md
@@ -368,6 +368,12 @@ including plugin id, declared tool names, result shape, and whether the tool is
 optional. Slow lines are promoted to warnings when a single factory takes at
 least 1s or total plugin tool factory prep takes at least 5s.
 
+OpenClaw caches successful plugin tool factory results for repeated resolutions
+with the same effective request context. The cache key includes the effective
+runtime config, workspace, agent/session ids, sandbox policy, browser settings,
+delivery context, requester identity, and ownership state, so factories that
+depend on those trusted fields are re-run when the context changes.
+
 If one plugin dominates the timing, inspect its runtime registrations:
 
 ```bash