[WSL2][Docs] Transfer State Manually doc lists non-existent MEMORY.md/memory/, omits real HEARTBEAT.md/POLICY.md/TOOLS.md
- Dominant language
- TypeScript
- Stars
- 22.5k
- Forks
- 3.1k
- Avg merge
- 1d 1h
- Merged PRs (30d)
- 715
Description
## Description
The "Download State" section of the Transfer State Manually (OpenClaw) doc lists `MEMORY.md` and the `memory/` directory as workspace files/folders to download, but neither exists in a fresh v0.0.114 OpenClaw sandbox's workspace. The same section omits `HEARTBEAT.md`, `POLICY.md`, and `TOOLS.md`, which do exist in the workspace and are files a user following this doc might reasonably also want to back up.
Platform scope: Reproduced on WSL2 only; other platforms not tested, but this is a doc-content vs. workspace-layout mismatch unrelated to host platform, so it is expected to reproduce identically everywhere.
Regression: Unknown — earlier versions not tested; plausibly the workspace file set changed in a past release (`HEARTBEAT.md`/`POLICY.md`/`TOOLS.md` added, `MEMORY.md`/`memory/` removed) without the doc being updated to match.
OpenShell issue: No — this is a documentation content defect, not a product defect. The underlying `openshell sandbox download`/`upload` mechanism itself works correctly.
## Environment
```text
Device: WSL2 (Windows host, Docker Desktop backend)
OS: WSL2 + Docker Desktop
Architecture: x86_64
OpenShell CLI: 0.0.106
NemoClaw: v0.0.114
OpenClaw: 2026.7.1
```
## Steps to Reproduce
1. Onboard a fresh OpenClaw sandbox:
```bash
nemoclaw onboard --fresh --non-interactive --name {sandbox} --no-gpu --yes-i-accept-third-party-software
```
2. List the sandbox workspace:
```bash
nemoclaw {sandbox} exec --no-tty -- ls -la /sandbox/.openclaw/workspace/
```
3. Compare against the "Download State" file list on the Transfer State Manually (OpenClaw) doc page: `SOUL.md`, `USER.md`, `IDENTITY.md`, `AGENTS.md`, `MEMORY.md`, `memory/`
4. Attempt to download the doc-listed `MEMORY.md` and `memory/`:
```bash
openshell sandbox download {sandbox}:/sandbox/.openclaw/workspace/MEMORY.md ./
openshell sandbox download {sandbox}:/sandbox/.openclaw/workspace/memory/ ./memory/
```
5. Reproduced independently on two separately-onboarded fresh sandboxes to rule out a one-off artifact.
## Expected Result
The doc's "Download State" file list matches the actual files present in a v0.0.114 OpenClaw sandbox workspace, so following the doc's instructions successfully downloads every listed file.
## Actual Result
Actual workspace contents (both independent sandboxes):
```text
AGENTS.md HEARTBEAT.md IDENTITY.md POLICY.md SOUL.md TOOLS.md USER.md
```
`MEMORY.md` and `memory/` do not exist. Attempting to download them per the doc fails, and the doc also never mentions `HEARTBEAT.md`, `POLICY.md`, or `TOOLS.md`, all three of which are real files present in every fresh sandbox's workspace.
All other doc-listed files (`SOUL.md`, `USER.md`, `IDENTITY.md`, `AGENTS.md`) download successfully as documented, and the upload path (re-uploading an edited file back into the workspace) also works exactly as documented — only the `MEMORY.md`/`memory/` file-list claim and the omission of the three untracked files are wrong.
## Logs
```text
=== download MEMORY.md ===
Downloading sandbox:/sandbox/.openclaw/workspace/MEMORY.md to ./
realpath: /sandbox/.openclaw/workspace/MEMORY.md: No such file or directory
Error: failed to resolve sandbox source path '/sandbox/.openclaw/workspace/MEMORY.md'
FAILED: MEMORY.md
=== download memory/ dir ===
Downloading sandbox:/sandbox/.openclaw/workspace/memory/ to ./memory/
realpath: /sandbox/.openclaw/workspace/memory/: No such file or directory
Error: failed to resolve sandbox source path '/sandbox/.openclaw/workspace/memory/'
FAILED: memory dir
=== ls -la /sandbox/.openclaw/workspace/ ===
total 48
drwxrws--- 1 sandbox sandbox 4096 Aug 27 09:29 .
drwxrws--- 1 sandbox sandbox 4096 Aug 27 09:29 ..
-rw-rw-r-- 1 sandbox sandbox 7197 Aug 27 09:29 AGENTS.md
-rw-r--r-- 1 sandbox sandbox 1137 Aug 27 09:29 HEARTBEAT.md
-rw-r--r-- 1 sandbox sandbox 1279 Aug 27 09:29 IDENTITY.md
-rw-r--r-- 1 sandbox sandbox 5184 Aug 27 09:29 POLICY.md
-rw-r--r-- 1 sandbox sandbox 1519 Aug 27 09:29 SOUL.md
-rw-r--r-- 1 sandbox sandbox 877 Aug 27 09:29 TOOLS.md
-rw-r--r-- 1 sandbox sandbox 538 Aug 27 09:29 USER.md
```
Contributor guide
Research direction
Start at the Transfer State Manually (OpenClaw) doc's "Download State" section and compare its list with the workspace files named in the issue: AGENTS.md, HEARTBEAT.md, IDENTITY.md, POLICY.md, SOUL.md, TOOLS.md, and USER.md. Done means the documentation no longer lists MEMORY.md or memory/ and includes the three existing files, while preserving the working download and upload instructions.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 90/100