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.