Reference

Host Files and State

View as Markdown

NemoClaw stores host-side configuration, credentials, registry metadata, transient install state, and local backups under ~/.nemoclaw/. Use this page when you need to identify what a file does before deleting, backing up, or sharing diagnostics.

The nemo-deepagents alias uses the same host-side ~/.nemoclaw/ configuration, credential registry, sandbox registry, backup, and mount directories as the default NemoClaw CLI. Deep Agents-specific runtime state lives inside the sandbox under /sandbox/.deepagents, not in a separate host state root.

Do not paste credentials.json, provider tokens, bot tokens, proxy tokens, or debug archives containing them into chat or issue comments. Share redacted diagnostics only.

Files

PathPurposeSafe to delete
~/.nemoclaw/config.jsonHost-level CLI configuration and defaults created by onboarding or config commands.Only if you want NemoClaw to forget host defaults and rebuild them on the next setup.
~/.nemoclaw/credentials.jsonHost-side provider and integration credential registry.Only when you intentionally want to re-enter credentials.
~/.nemoclaw/sandboxes.jsonCurrent sandbox registry used by nemo-deepagents list, default sandbox selection, rebuild, and recovery commands.No. Deleting it makes the host forget existing sandboxes and can block state-preserving recovery.
~/.nemoclaw/onboard-session.jsonResume marker for an onboarding attempt that failed before completion.Yes, when you intentionally want to discard the failed session and start over. Prefer nemo-deepagents onboard --fresh when available.
~/.nemoclaw/ollama-proxy-tokenLocal auth token used by the host-side Ollama auth proxy.Yes, but re-run onboarding afterward so NemoClaw recreates and registers the proxy token.

sandboxes.json is the current registry file name. If you see registry.json in older tests, notes, or discussions, treat it as legacy wording for the sandbox registry unless a specific release note says otherwise.

Directories

PathPurposeSafe to delete
~/.nemoclaw/rebuild-backups/Host-side snapshots written by backup-all, snapshot create, and rebuild flows.Only after you no longer need rollback or restore points.
~/.nemoclaw/backups/Workspace backups written by legacy backup helpers and some recovery flows.Only after confirming you no longer need those workspace archives.
~/.nemoclaw/mounts/Default local mount points created by share or mount commands.Unmount first, then remove unused directories.
~/.nemoclaw/blueprints/Cached blueprint inputs used by onboarding and sandbox recreation.Avoid manual deletion unless you plan to rerun onboarding from fresh inputs.

Uninstall Behavior

nemo-deepagents uninstall --yes removes active NemoClaw runtime resources but preserves the user data needed for recovery by default. Preserved entries include rebuild-backups/, backups/, and sandboxes.json. Interactive uninstall prompts before removing preserved state. For non-interactive runs, pass --destroy-user-data only when you accept losing local registry metadata and backups.

For operational uninstall steps, refer to: