Skip to main content

​
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

FileDescription
SOUL.mdCore personality, tone, and behavioral rules.
USER.mdPreferences, context, and facts the agent learns about you.
IDENTITY.mdAgent name, creature type, emoji, and self-presentation.
AGENTS.mdMulti-agent coordination, memory conventions, and safety guidelines.

​
The Memanto Advantage

In standard open-source setups, memory lives purely in MEMORY.md or a memory/ directory of daily notes. If the sandbox is destroyed, the agent suffers total amnesia. With MemantoClaw, long-term semantic memory is routed securely to Moorcheh’s servers via the host bridge. Even if you destroy the sandbox, the retrieved context and learned knowledge safely persist remotely.

​
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.