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.

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 nemoclaw 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 nemoclaw 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

nemoclaw 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 Manage Sandbox Lifecycle.