> **💡 导语**：
> 无论你是想重装 OpenClaw，还是彻底告别这个强大的 AI Gateway，一个**干净、彻底的卸载**都至关重要。残留的后台服务、配置文件或全局包可能会导致端口冲突、磁盘空间浪费，甚至影响新版本的安装。
>
> 本文将为你提供一份覆盖 **Windows、macOS、Linux** 三大操作系统，以及 **npm、pnpm、bun** 等多种包管理器的**终极卸载指南**。请严格按照步骤操作，确保不留一丝痕迹！

---

## ⚠️ 卸载前的重要提示

1.  **备份重要数据**：卸载会删除 `~/.openclaw` 目录下的所有内容，包括你的 API 密钥、自定义技能（Skills）和工作区数据。如需保留，请先备份。
    *   配置文件: `~/.openclaw/.env`
    *   技能目录: `~/.openclaw/skills/`
2.  **推荐顺序**：遵循 **“停止服务 → 卸载 CLI → 清理文件”** 的三步走原则。

---

## 🚀 第一部分：首选方案 - 使用官方一键卸载命令（强烈推荐！）

如果你的 `openclaw` 命令行工具 (CLI) 仍然可以正常使用，这是最简单、最安全的方式。

### 执行命令

在终端（macOS/Linux）或 PowerShell（Windows）中运行：

```bash
openclaw uninstall --all --yes --non-interactive
```

### 命令作用详解

*   `--all`: 卸载所有组件，包括 CLI、Gateway 服务和本地数据。
*   `--yes`: 自动确认所有提示，无需手动输入 `y`。
*   `--non-interactive`: 以非交互模式运行，适合脚本化操作。

**此命令会自动完成以下所有手动步骤**！ 如果执行成功，你可以直接跳到文末的[验证环节](#-第五部分-验证卸载是否成功)。

---

## 🛠 第二部分：手动卸载方案（当 CLI 已损坏或无法使用时）

如果 `openclaw` 命令已失效，请按以下步骤手动清理。

### 步骤 1：停止并卸载 Gateway 后台服务

OpenClaw 的 Gateway 服务会在系统后台持续运行，必须先将其停止并移除。

#### **通用方法**（适用于所有平台）
尝试运行以下命令（即使 CLI 失效，有时这些子命令仍可工作）：

```bash
# 尝试停止服务
openclaw gateway stop

# 尝试卸载服务
openclaw gateway uninstall
```

#### **如果上述命令无效，请根据你的操作系统手动操作**：

*   **Windows **(PowerShell)
    ```powershell
    # 停止计划任务
    Unregister-ScheduledTask -TaskName "OpenClaw" -Confirm:$false

    # 如果是作为 Windows 服务安装的（较少见）
    Stop-Service -Name "OpenClaw"
    Remove-Service -Name "OpenClaw"
    ```

*   **macOS **(Bash/Zsh)
    ```bash
    # 停止并卸载 launchd 服务
    launchctl unload ~/Library/LaunchAgents/io.openclaw.gateway.plist
    rm -f ~/Library/LaunchAgents/io.openclaw.gateway.plist
    ```

*   **Linux **(systemd, Bash)
    ```bash
    # 停止并禁用 systemd 服务
    systemctl --user stop openclaw-gateway.service
    systemctl --user disable openclaw-gateway.service
    # 删除服务文件
    rm -f ~/.config/systemd/user/openclaw-gateway.service
    systemctl --user daemon-reload
    ```

### 步骤 2：卸载 CLI 工具（根据你的安装方式）

根据你最初安装 OpenClaw 时使用的包管理器，选择对应的卸载命令。

*   **npm **(Node Package Manager)
    ```bash
    npm uninstall -g openclaw
    ```

*   **pnpm **(Performant npm)
    ```bash
    pnpm remove -g openclaw
    ```

*   **bun**
    ```bash
    bun remove -g openclaw
    ```

*   **通过官方安装脚本安装 **(`install.sh` / `install.ps1`)
    如果你是通过 `curl ... | bash` 或 PowerShell 脚本安装的，通常 CLI 会被放在 `/usr/local/bin/openclaw` (macOS/Linux) 或 `$env:ProgramFiles\OpenClaw\openclaw.exe` (Windows)。你可以直接删除该文件。
    ```bash
    # macOS / Linux
    sudo rm -f /usr/local/bin/openclaw

    # Windows (PowerShell)
    Remove-Item "$env:ProgramFiles\OpenClaw\openclaw.exe" -Force
    Remove-Item "$env:ProgramFiles\OpenClaw" -Recurse -Force # 删除整个目录
    ```

### 步骤 3：彻底清理用户数据和配置文件

这是确保“完全卸载”的最后一步，会删除所有本地状态。

```bash
# 删除主配置目录（适用于所有平台）
rm -rf ~/.openclaw

# macOS 用户额外检查（如果安装了图形应用）
rm -rf /Applications/OpenClaw.app
```

---

## 💻 第三部分：各平台详细操作速查表

| 平台 | 停止/卸载服务 | 卸载 CLI | 清理数据 |
| :--- | :--- | :--- | :--- |
| **Windows **(PowerShell) | `Unregister-ScheduledTask -TaskName "OpenClaw"` | `npm uninstall -g openclaw` 或 `Remove-Item "$env:ProgramFiles\OpenClaw" -Recurse` | `Remove-Item "$env:USERPROFILE\.openclaw" -Recurse` |
| **macOS **(Terminal) | `launchctl unload ~/Library/LaunchAgents/io.openclaw.gateway.plist && rm ...` | `npm uninstall -g openclaw` 或 `sudo rm /usr/local/bin/openclaw` | `rm -rf ~/.openclaw` |
| **Linux **(Terminal) | `systemctl --user stop openclaw-gateway && rm ~/.config/systemd/user/openclaw-gateway.service` | `npm uninstall -g openclaw` | `rm -rf ~/.openclaw` |

---

## 🧪 第五部分：验证卸载是否成功

完成以上所有步骤后，进行最终验证：

1.  **检查 CLI 是否消失**：
    ```bash
    openclaw --version
    ```
    你应该看到类似 `command not found` 的错误信息。

2.  **检查进程是否停止**：
    ```bash
    # 查找任何包含 openclaw 的进程
    ps aux | grep openclaw
    ```
    除了 `grep` 命令本身，不应再有其他相关进程。

3.  **检查配置目录是否清空**：
    ```bash
    ls ~/.openclaw
    ```
    应该提示 `No such file or directory`。

4.  **检查端口占用 **(可选)：
    OpenClaw 默认使用 `3000` 和 `8080` 端口。你可以用 `lsof -i :3000` (macOS/Linux) 或 `netstat -ano | findstr :3000` (Windows) 确认端口是否已释放。

---

## 💎 总结

通过 **官方一键卸载命令** 或 **详尽的手动清理流程**，你现在应该已经成功地从你的系统中彻底移除了 OpenClaw。无论是为了迎接新版本，还是为其他项目腾出空间，一个干净的环境都是最佳起点。

**记住核心三步**：
1.  **停服务** (`gateway uninstall`)
2.  **删 CLI** (`npm/pnpm uninstall`)
3.  **清数据** (`rm -rf ~/.openclaw`)

现在，你的系统已经焕然一新！

💡 导语： 无论你是想重装 OpenClaw，还是彻底告别这个强大的 AI Gateway，一个干净、彻底的卸载都至关重要。残留的后台服务、配置文件或全局包可能会导致端口冲突、磁盘空间浪费，甚至影响新版本的安装。

🔥 完整卸载 OpenClaw — 各平台卸载完全指南（Windows/macOS/Linux/npm/pnpm）

后端

运维

开发工具

彻底卸载OpenClaw的终极指南：提供Windows/macOS/Linux全平台解决方案，包含一键卸载命令和手动清理步骤，确保删除CLI工具、后台服务和配置文件。卸载前请备份.env和skills目录数据，遵循"停止服务→卸载CLI→清理文件"三步原则，彻底释放3000/8080端口占用。

命令行工具

包管理器

Windows

Linux

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

🔥 完整卸载 OpenClaw — 各平台卸载完全指南（Windows/macOS/Linux/npm/pnpm）-腾讯云开发者社区-腾讯云

🔥 完整卸载 OpenClaw — 各平台卸载完全指南（Windows/macOS/Linux/npm/pnpm）

🔥 完整卸载 OpenClaw — 各平台卸载完全指南（Windows/macOS/Linux/npm/pnpm）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐