docs(openclaw): document split roots and host-path remap defaults#2
Closed
kalinon wants to merge 6 commits intoByMosDev:mainfrom
Closed
docs(openclaw): document split roots and host-path remap defaults#2kalinon wants to merge 6 commits intoByMosDev:mainfrom
kalinon wants to merge 6 commits intoByMosDev:mainfrom
Conversation
Document the correct OpenClaw home mount pattern, explicitly set WORKSPACE_SUBDIR=. to avoid /workspace/workspace nesting, and clarify that normal MosBot usage requires read-write workspace mounts.
Update setup, workspace-service, troubleshooting, and configuration docs to use WORKSPACE_FS_ROOT + CONFIG_FS_ROOT, document migration from WORKSPACE_ROOT/WORKSPACE_SUBDIR, and add remap-prefix troubleshooting guidance.
Update OpenClaw configuration and troubleshooting docs to include both default remap prefixes: /home/node/.openclaw and ~/.openclaw. This matches API defaults and clarifies how host-absolute paths are translated into virtual workspace paths.
This was referenced Mar 3, 2026
Closed
Clarify that OPENCLAW_PATH_REMAP_PREFIXES appends custom prefixes while built-in prefixes are always active, and document that the most specific prefix wins when multiple remap prefixes match.
Contributor
Author
|
Follow-up docs update for Path Law v2. New commit: Highlights:
|
- update setup/workspace-service docs to map main workspace to /workspace\n- align troubleshooting guidance and examples with /workspace/* requests\n- update configuration reference virtual path conventions
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates OpenClaw documentation to match Path Law v2:
//workspacealiasChanges
CONFIG_ROOT=/openclaw-configMAIN_WORKSPACE_DIR=workspace~/.openclaw:/openclaw-config)CONFIG_ROOTPATH_NOT_ALLOWEDwhen using/workspace/.../for main,/workspace-<agent>for sub-agents,/projects|/skills|/docsfor sharedIssues Solved
/workspacevirtual alias behaviorRelated PRs
Tracking issue: