Document persistence of SOUL.md, USER.md, IDENTITY.md and provide backup/restore guidance

[lellky]

Problem:

NemoClaw/OpenClaw creates important configuration files inside the sandbox — SOUL.md, USER.md, and IDENTITY.md — located at /sandbox/.openclaw/workspace/. These files define the agent's personality, user preferences, and identity. However:

1. No documentation mentions these files exist, what they do, or where they're stored.
2. The files do not survive gateway destroy — sandbox data lives in a PVC inside the k3s cluster, so while it survives sandbox restarts, destroying the gateway loses everything.
3. There is no built-in backup/restore mechanism for these files. Users must manually discover the correct path and use openshell sandbox download/upload to preserve them.

What we had to do to figure this out:

• The files are not at /sandbox/SOUL.md as one might guess — they're at /sandbox/.openclaw/workspace/SOUL.md (and similarly for the others). We had to download the entire /sandbox/ directory to discover this.
• We wrote custom backup/restore shell scripts using openshell sandbox download and openshell sandbox upload to transfer these files to/from the host.

Suggestions:

1. Document the workspace files (SOUL.md, USER.md, IDENTITY.md) — what they are, where they live, and that they're user-customizable.
2. Add a built-in openshell sandbox backup/openshell sandbox restore command (or nemoclaw backup/nemoclaw restore) that handles these files automatically.
3. Alternatively, support persistent host volume mounts for the workspace directory so these files survive gateway recreation.
4. At minimum, warn users during gateway destroy that sandbox data (including these files) will be lost.

Environment: OpenShell 0.0.10, NemoClaw on Ubuntu Linux.

Feel free to edit as needed before posting.

[BenediktSchackenberg]

Opened PR #476 to address this: #476

Adds documentation for workspace file persistence, a backup/restore how-to guide, a convenience shell script, and a warning on the destroy command.

[wscurran]

Thanks for pointing out the lack of documentation on the persistence of SOUL.md, USER.md, and IDENTITY.md files inside the sandbox, as well as the need for backup and restore guidance, which is an important aspect of getting started with NemoClaw.