Manage SandboxesState and Backups

Transfer State Manually

View as Markdown

Use manual transfer when you need to inspect or move specific state files. Use Create and Restore Snapshots for normal backup, rebuild, and restore workflows.

Download State

Use nemohermes <name> download to copy files from the sandbox to your host. The wrapper rejects a directory that contains a symbolic link or another special file before it invokes the OpenShell download or creates the host destination.

For Hermes, prefer Create and Restore Snapshots for a faithful state.db restore. Use manual download and upload only when you need to inspect or transfer a specific file.

$SANDBOX=my-hermes
$BACKUP_DIR=~/.nemoclaw/backups/$(date +%Y%m%d-%H%M%S)
$mkdir -p "$BACKUP_DIR/dashboard-home"
$
$nemohermes "$SANDBOX" download /sandbox/SOUL.md "$BACKUP_DIR/"
$nemohermes "$SANDBOX" download /sandbox/.hermes/state.db "$BACKUP_DIR/"
$nemohermes "$SANDBOX" download /sandbox/.hermes/profiles/dashboard-home/MEMORY.md "$BACKUP_DIR/dashboard-home/MEMORY.md"
$nemohermes "$SANDBOX" download /sandbox/.hermes/profiles/dashboard-home/USER.md "$BACKUP_DIR/dashboard-home/USER.md"
$nemohermes "$SANDBOX" download /sandbox/.hermes/platforms/ "$BACKUP_DIR/platforms/"

Copy only the dashboard profile’s MEMORY.md and USER.md files. Do not copy .hermes/profiles/dashboard-home/.env or .hermes/profiles/dashboard-home/config.yaml. NemoClaw regenerates both files from the managed policy and current inference route. The dashboard process receives its API bearer token through the runtime environment instead of the mirrored .env file.

If startup refuses a legacy profile migration, download the preserved user files for inspection:

$mkdir -p "$BACKUP_DIR/dashboard-home-legacy"
$nemohermes "$SANDBOX" download /sandbox/.hermes/dashboard-home/MEMORY.md "$BACKUP_DIR/dashboard-home-legacy/MEMORY.md"
$nemohermes "$SANDBOX" download /sandbox/.hermes/dashboard-home/USER.md "$BACKUP_DIR/dashboard-home-legacy/USER.md"

Do not download the legacy .env or config.yaml. Compare the preserved user files with the canonical profile before you upload either version.

Upload State

Use nemohermes <name> upload to copy files from the host into a sandbox.

For Hermes, prefer Create and Restore Snapshots for a faithful state.db restore. Use manual download and upload only when you need to inspect or transfer a specific file.

$SANDBOX=my-hermes
$BACKUP_DIR=~/.nemoclaw/backups/20260320-120000  # pick a timestamp
$
$nemohermes "$SANDBOX" upload "$BACKUP_DIR/SOUL.md" /sandbox/
$nemohermes "$SANDBOX" upload "$BACKUP_DIR/state.db" /sandbox/.hermes/
$nemohermes "$SANDBOX" upload "$BACKUP_DIR/dashboard-home/MEMORY.md" /sandbox/.hermes/profiles/dashboard-home/MEMORY.md
$nemohermes "$SANDBOX" upload "$BACKUP_DIR/dashboard-home/USER.md" /sandbox/.hermes/profiles/dashboard-home/USER.md
$nemohermes "$SANDBOX" upload "$BACKUP_DIR/platforms/" /sandbox/.hermes/platforms/