Uninstall#

OpenShell profiles#

For installation and runtime usage, see the Agent Sandboxing guide.

./uninstall.sh --runtime openshell --yes

This removes all installer-owned sandboxes/providers and their chat/workspace data, shared IR, managed OVMS and private backend network, model downloads, and installer state. An external inference backend is not removed. If the same state directory records a host-installed agent, that recorded agent is removed too. Back up needed data before consenting. The OpenShell local gateway service, Debian CLI package and user state are also removed when this deployment installed them (openshell-owned receipt). Pre-existing OpenShell installations are preserved. Remaining unrelated sandboxes/providers across all workspaces, gateway registrations, or another account’s running gateway block system-wide OpenShell removal. Incomplete or failed resource discovery also blocks removal rather than treating unlisted resources as absent.

Failures retain remaining ownership/transition state for retry instead of reporting complete cleanup. Legacy installations without an OpenShell ownership receipt are not automatically claimed. In OpenShell mode, --keep-agent-data is rejected because it cannot retain a deleted sandbox’s home; back it up instead.

Model deletion is the default in both runtime modes. To retain model downloads during full uninstall, add --keep-models. Other installer state is removed; the models and their parent state directory remain. --delete-models is still accepted for compatibility and explicitly selects the default deletion behavior.

For deliberately scoped removal without removing shared inference/OpenShell:

./uninstall.sh --runtime openshell --sandbox-only --harness openclaw --yes
./uninstall.sh --runtime openshell --sandbox-only --harness hermes --yes
./uninstall.sh --runtime openshell --sandbox-only --harness deepagents-code --yes

This mode retains removed-profile.json for audit and does not uninstall host agents. --harness selects one sandbox only in this scoped mode; full uninstall removes all owned sandbox profiles. The OpenShell prepared-runner test suite uses this scoped mode for cleanup.

The uninstaller does not stop separately launched laptop SSH tunnels or local port-forwarding commands. Stop those processes separately after uninstall.

Host installation#

./uninstall.sh                  # prompts, deletes downloaded models by default
./uninstall.sh --yes --delete-models --harness openclaw
./uninstall.sh --yes --keep-models   # explicitly retain downloaded models
./uninstall.sh --yes --keep-agent-data --harness hermes   # keep ~/.hermes (sessions, memories, skills)
./uninstall.sh --harness hermes --keep-models             # remove Hermes but keep the downloaded models

Note

Uninstalling Hermes (full uninstall): ./uninstall.sh --harness hermes is a full uninstall, not an agent-only removal. It also deletes the downloaded/exported models (~/.agent-harness-install/models) and ~/.hermes. Re-downloading models is time and bandwidth intensive, so add --keep-models to retain them (and --keep-agent-data to retain ~/.hermes). With --keep-models, the models and their parent ~/.agent-harness-install directory remain; the Inference Router, OVMS container and backend network are still removed.

Removes the Inference Router container and, if this install started one, the OpenVINO Model Server container, the private backend network, the installed agent (its actual package — e.g., npm uninstall -g openclaw, uv tool uninstall deepagents-code, or Hermes’s own data directory ~/.hermes — not just its CLI shim), and the ~/.agent-harness-install state directory. Owned OpenShell sandboxes and an installer-owned OpenShell runtime are removed too. Model deletion is the default; --delete-models remains a compatibility alias. Pass --keep-agent-data to preserve Hermes’s or dcode’s config/sessions/memories/skills instead of deleting them. An agent data directory is only deleted if it is an absolute, non-symlink path that is not $HOME or one of its parents (guarding a mistyped HERMES_HOME/DEEPAGENTS_HOME); otherwise it is left in place with a warning.

Left in place: Docker, Node.js/nvm, the Intel compute runtime, the Docker daemon proxy drop-in (if one was written), the downloaded OVMS and Inference Router images, the PATH block added to your shell profile, and a host-installed OpenClaw’s own ~/.openclaw config (including the ovms provider it was pointed at) — remove those yourself if you no longer need them.