diff --git a/docs/concepts/memory-qmd.md b/docs/concepts/memory-qmd.md
index 8bf6d56a5d1..3c68baeafbb 100644
--- a/docs/concepts/memory-qmd.md
+++ b/docs/concepts/memory-qmd.md
@@ -150,6 +150,12 @@ Set to `120000` for slower hardware.
 **Empty results in group chats?** Check `memory.qmd.scope` -- the default only
 allows DM sessions.
 
+**Workspace-visible temp repos causing `ENAMETOOLONG` or broken indexing?**
+QMD traversal currently follows the underlying QMD scanner behavior rather than
+OpenClaw's builtin symlink rules. Keep temporary monorepo checkouts under
+hidden directories like `.tmp/` or outside indexed QMD roots until QMD exposes
+cycle-safe traversal or explicit exclusion controls.
+
 ## Configuration
 
 For the full config surface (`memory.qmd.*`), search modes, update intervals,
diff --git a/docs/reference/memory-config.md b/docs/reference/memory-config.md
index e849477b730..3a2fc77a5ec 100644
--- a/docs/reference/memory-config.md
+++ b/docs/reference/memory-config.md
@@ -185,7 +185,9 @@ Evergreen files (`MEMORY.md`, non-dated files in `memory/`) are never decayed.
 ```
 
 Paths can be absolute or workspace-relative. Directories are scanned
-recursively for `.md` files. Symlinks are ignored.
+recursively for `.md` files. Symlink handling depends on the active backend:
+the builtin engine ignores symlinks, while QMD follows the underlying QMD
+scanner behavior.
 
 For agent-scoped cross-agent transcript search, use
 `agents.list[].memorySearch.qmd.extraCollections` instead of `memory.qmd.paths`.