Workspace Files

Workspace files define your agent’s personality, memory, and user context. They persist across sandbox restarts but are permanently deleted when you run memantoclaw <name> destroy. These files live at /sandbox/.openclaw/workspace/ inside the sandbox.

File Reference

File	Description
`SOUL.md`	Core personality, tone, and behavioral rules.
`USER.md`	Preferences, context, and facts the agent learns about you.
`IDENTITY.md`	Agent name, creature type, emoji, and self-presentation.
`AGENTS.md`	Multi-agent coordination, memory conventions, and safety guidelines.

The Memanto Advantage

In standard open-source setups, OpenClaw relies on a local SQLite database for recent chat history (using BM25 keyword matching) and manual markdown files like MEMORY.md for facts. This approach is lossy, degrades over time, and if the sandbox is destroyed, the agent suffers total amnesia of its conversational context. With MemantoClaw, long-term semantic memory is securely routed to Moorcheh’s information-theoretic search engine via the host bridge. Even if you destroy the sandbox, the retrieved context and learned knowledge safely persist remotely, ready to be injected into your next agent immediately.

Back Up and Restore Workspace Files

Use the OpenShell CLI to manually copy local Markdown files out of the sandbox before destroying it:

SANDBOX=my-assistant
BACKUP_DIR=~/.memantoclaw/backups/$(date +%Y%m%d-%H%M%S)
mkdir -p "$BACKUP_DIR"

openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/SOUL.md "$BACKUP_DIR/"
openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/USER.md "$BACKUP_DIR/"

To restore:

openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/SOUL.md" /sandbox/.openclaw/workspace/

Using the Backup Script

MemantoClaw includes a convenience script:

./scripts/backup-workspace.sh backup my-assistant
./scripts/backup-workspace.sh restore my-assistant

For complete, unabridged technical details on this topic, refer to the official NVIDIA NemoClaw Documentation. Portions of this guide are summarized and adapted from NVIDIA Corporation (Copyright © 2026), licensed under the Apache License, Version 2.0.

​Workspace Files

​File Reference

​The Memanto Advantage

​Back Up and Restore Workspace Files

​Using the Backup Script

Workspace Files

File Reference

The Memanto Advantage

Back Up and Restore Workspace Files

Using the Backup Script