彻底卸载

彻底卸载 OpenClaw 输入如下指令：

openclaw uninstall --all --non-interactive --yes

uninstall

卸载完成

卸载后的收尾工作

openclaw uninstall 移除了服务和本地数据，但 CLI 工具本身仍然留在系统中。若要彻底清除 OpenClaw，还需根据当初的安装方式移除 CLI 包：

通过 install.sh 安装（npm 方式）：

npm uninstall -g openclaw

npm uninstall

卸载完成

介绍指令

admin@192 ~ % openclaw uninstall --help

🦞 OpenClaw 2026.5.5 (b1abf9d) — No $999 stand required.

Usage: openclaw uninstall [options]

Uninstall the gateway service + local data (CLI remains)

Options:
  --all              Remove service + state + workspace + app (default: false)
  --app              Remove the macOS app (default: false)
  --dry-run          Print actions without removing files (default: false)
  -h, --help         Display help for command
  --non-interactive  Disable prompts (requires --yes) (default: false)
  --service          Remove the gateway service (default: false)
  --state            Remove state + config (default: false)
  --workspace        Remove workspace dirs (default: false)
  --yes              Skip confirmation prompts (default: false)

Docs: docs.openclaw.ai/cli/uninstall

OpenClaw uninstall 指令完全指南

概述

openclaw uninstall 用于卸载 OpenClaw 的网关服务及本地数据，但 CLI 工具本身会被保留。通过搭配不同的选项，你可以精确控制删除哪些组件，做到"按需清理"。

基本用法

openclaw uninstall [options]

不带任何选项直接运行时，会进入交互式流程，提示你确认操作。

各选项详解

--all — 一键全量清理

openclaw uninstall --all

将以下所有组件一并移除：

等价于同时使用 --service --state --workspace --app。适用于你想彻底清除 OpenClaw 环境、准备全新安装的场景。

--service — 仅移除网关服务

openclaw uninstall --service

只卸载后台运行的 gateway service（网关服务），其他数据（配置、工作区等）均保留。适用于你想停止并删除服务进程，但仍需保留本地项目文件的情况。

--state — 移除状态与配置

openclaw uninstall --state

删除 OpenClaw 的 本地状态（state） 和 配置文件（config）。这包括认证信息、偏好设置、运行时缓存等。注意：工作区目录不会被影响。

--workspace — 移除工作区目录

openclaw uninstall --workspace

删除 OpenClaw 的 workspace 目录。工作区通常存放项目文件、临时资源等内容。如果你只想清理项目数据但保留服务和配置，这个选项很合适。

--app — 移除 macOS 应用

openclaw uninstall --app

卸载 OpenClaw 的 macOS 桌面应用。仅在 macOS 平台上有效。如果你是通过 Homebrew 或脚本安装的 CLI 版本、同时也安装了桌面客户端，可以用此选项单独移除 GUI 应用。

--dry-run — 预览模式（不实际删除）

openclaw uninstall --dry-run
openclaw uninstall --all --dry-run

不会删除任何文件，只打印出将要执行的操作列表。这是一个安全措施——在真正执行卸载前，先用 --dry-run 检查哪些文件会被影响，确认无误后再正式运行。

典型工作流：

# 第一步：预览
openclaw uninstall --all --dry-run

# 第二步：确认输出没问题后，正式执行
openclaw uninstall --all --yes

--yes — 跳过确认提示

openclaw uninstall --all --yes

默认情况下，卸载操作会弹出确认提示，要求你手动输入 y 确认。加上 --yes 后，所有确认提示自动跳过，适合在脚本或 CI/CD 流程中使用。

--non-interactive — 禁用所有交互提示

openclaw uninstall --all --yes --non-interactive

进入 完全非交互模式，禁用所有用户提示。注意：此选项通常需要搭配 --yes 使用，否则遇到确认提示时会因无法交互而报错。适用于自动化脚本、Docker 构建或远程批量操作等无人值守的场景。

-h, --help — 显示帮助信息

openclaw uninstall --help

打印该指令的帮助文档，包含所有可用选项的简要说明。

组合使用示例

注意事项

1. CLI 始终保留 — 无论使用哪种选项组合，openclaw 命令行工具本身不会被删除。如需完全移除 CLI，需通过系统包管理器（如 brew uninstall）单独处理。
2. 先 dry-run 再执行 — 涉及删除操作时，强烈建议先用 --dry-run 确认影响范围。
3. 非交互模式需搭配 --yes — 使用 --non-interactive 时务必同时加上 --yes，否则程序会在等待确认输入时挂起。
4. --app 仅限 macOS — 该选项在 Linux 或 Windows 上不会产生效果。

参考文档：docs.openclaw.ai/cli/uninstall