NVIDIA / NVIDIA/NemoClaw

[WSL2][Docs] Transfer State Manually doc lists non-existent MEMORY.md/memory/, omits real HEARTBEAT.md/POLICY.md/TOOLS.md

Open Beginner friendly
#10,482 0 comments 0 reactions 0 assignees View on GitHub
area: docs
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.