docs clarify openclaw artifact workspace ownership

docs/architecture/chain-map-artifact-lifecycle.md

@@ -46,6 +46,9 @@ Process:
   3. resolveWorkspaceDir({ openclawSessionKey, params, pluginConfig, config })
      → Falls back through: explicit → pluginConfig → agent config
        → profile env → ~/.openclaw/workspace
+     → Bridge must pass only a real OpenClaw workspace root here. App/owner
+       scoped hints such as `/owners/...` are UI/sync references, not plugin
+       workspace roots, and must fall back to the managed OpenClaw workspace.
 
   4. safeScopeSegment(openclawSessionKey)
      → replace [/\\:*?"<>|] with "-", truncate to 96 chars
@@ -64,6 +67,9 @@ Output:
 
 Fragile:
   - workspace resolution chain has 5 ordered sources
+  - `remoteWorkingDirectoryHint` may be an app owner-scoped reference; using it
+    as `workspaceDir` causes plugin `realpath(workspaceDir)` failures before
+    `tasks/<session>/<run>/` can be created
   - session key format must match across bridge and plugin
   - no cleanup of old scope directories
 ```

docs/architecture/chain-map-task-execution.md

@@ -79,6 +79,12 @@ xworkmate-bridge
              │       ├─ openclawSessionKey: OpenClaw SessionEntry key
              │       ├─ expectedArtifactDirs: typed artifact contract
              │       └─ scope: tasks/<openclawSessionKey>/<runId>/
+             ├─ Rewrite OpenClaw turn workspace references
+             │   ├─ `/owners/...` and other app owner-scoped hints are not
+             │   │  plugin workspace roots
+             │   ├─ workingDirectory / remoteWorkingDirectoryHint for chat.send
+             │   │  become prepared.artifactDirectory
+             │   └─ prompt `currentTaskWorkspace` points at artifactDirectory
              │
              ├─ gateway.request('chat.send')
              │   └─ payload: sessionKey, message, attachments, idempotencyKey

docs/architecture/cross-repo-call-analysis-2026-06-05.md

@@ -321,6 +321,11 @@ Bridge 不再组装 terminal snapshot。Terminal success/failure 必须来自 Op
 
 如果 agent config 变更（增删 agent、修改 default、调整 workspace），可能影响所有运行中 session 的 artifact 路径。
 
+App/owner-scoped `remoteWorkingDirectoryHint`（例如 `/owners/...`）不是
+OpenClaw 文件系统路径，Bridge 不得把它透传为 plugin `workspaceDir`。否则
+Plugin 会在创建 `tasks/<session>/<run>/` 前先 `realpath(workspaceDir)`，并以
+`ENOENT` 失败。
+
 ### 🟡 MEDIUM: 配置与部署区
 
 **6.10 Distributed bridge forwarding topology 变更**