mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-17 13:00:48 +00:00
a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
136 lines
3.6 KiB
Markdown
136 lines
3.6 KiB
Markdown
---
|
||
read_when:
|
||
- 你想从机器上移除 OpenClaw
|
||
- 卸载后 Gateway 网关服务仍在运行
|
||
summary: 完全卸载 OpenClaw（CLI、服务、状态、工作区）
|
||
title: 卸载
|
||
x-i18n:
|
||
generated_at: "2026-02-03T07:50:10Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 6673a755c5e1f90a807dd8ac92a774cff6d1bc97d125c75e8bf72a40e952a777
|
||
source_path: install/uninstall.md
|
||
workflow: 15
|
||
---
|
||
|
||
# 卸载
|
||
|
||
两种方式：
|
||
|
||
- 如果 `openclaw` 仍已安装，使用**简单方式**。
|
||
- 如果 CLI 已删除但服务仍在运行，使用**手动服务移除**。
|
||
|
||
## 简单方式（CLI 仍已安装）
|
||
|
||
推荐：使用内置卸载程序：
|
||
|
||
```bash
|
||
openclaw uninstall
|
||
```
|
||
|
||
非交互式（自动化 / npx）：
|
||
|
||
```bash
|
||
openclaw uninstall --all --yes --non-interactive
|
||
npx -y openclaw uninstall --all --yes --non-interactive
|
||
```
|
||
|
||
手动步骤（效果相同）：
|
||
|
||
1. 停止 Gateway 网关服务：
|
||
|
||
```bash
|
||
openclaw gateway stop
|
||
```
|
||
|
||
2. 卸载 Gateway 网关服务（launchd/systemd/schtasks）：
|
||
|
||
```bash
|
||
openclaw gateway uninstall
|
||
```
|
||
|
||
3. 删除状态 + 配置：
|
||
|
||
```bash
|
||
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
|
||
```
|
||
|
||
如果你将 `OPENCLAW_CONFIG_PATH` 设置为状态目录外的自定义位置，也请删除该文件。
|
||
|
||
4. 删除你的工作区（可选，移除智能体文件）：
|
||
|
||
```bash
|
||
rm -rf ~/.openclaw/workspace
|
||
```
|
||
|
||
5. 移除 CLI 安装（选择你使用的那个）：
|
||
|
||
```bash
|
||
npm rm -g openclaw
|
||
pnpm remove -g openclaw
|
||
bun remove -g openclaw
|
||
```
|
||
|
||
6. 如果你安装了 macOS 应用：
|
||
|
||
```bash
|
||
rm -rf /Applications/OpenClaw.app
|
||
```
|
||
|
||
注意事项：
|
||
|
||
- 如果你使用了配置文件（`--profile` / `OPENCLAW_PROFILE`），对每个状态目录重复步骤 3（默认为 `~/.openclaw-<profile>`）。
|
||
- 在远程模式下，状态目录位于 **Gateway 网关主机**上，因此也需要在那里运行步骤 1-4。
|
||
|
||
## 手动服务移除（CLI 未安装）
|
||
|
||
如果 Gateway 网关服务持续运行但 `openclaw` 缺失，请使用此方法。
|
||
|
||
### macOS（launchd）
|
||
|
||
默认标签是 `bot.molt.gateway`（或 `bot.molt.<profile>`；旧版 `com.openclaw.*` 可能仍然存在）：
|
||
|
||
```bash
|
||
launchctl bootout gui/$UID/bot.molt.gateway
|
||
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
|
||
```
|
||
|
||
如果你使用了配置文件，请将标签和 plist 名称替换为 `bot.molt.<profile>`。如果存在任何旧版 `com.openclaw.*` plist，请将其移除。
|
||
|
||
### Linux（systemd 用户单元）
|
||
|
||
默认单元名称是 `openclaw-gateway.service`（或 `openclaw-gateway-<profile>.service`）：
|
||
|
||
```bash
|
||
systemctl --user disable --now openclaw-gateway.service
|
||
rm -f ~/.config/systemd/user/openclaw-gateway.service
|
||
systemctl --user daemon-reload
|
||
```
|
||
|
||
### Windows（计划任务）
|
||
|
||
默认任务名称是 `OpenClaw Gateway`（或 `OpenClaw Gateway (<profile>)`）。
|
||
任务脚本位于你的状态目录下。
|
||
|
||
```powershell
|
||
schtasks /Delete /F /TN "OpenClaw Gateway"
|
||
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
|
||
```
|
||
|
||
如果你使用了配置文件，请删除匹配的任务名称和 `~\.openclaw-<profile>\gateway.cmd`。
|
||
|
||
## 普通安装 vs 源码检出
|
||
|
||
### 普通安装（install.sh / npm / pnpm / bun）
|
||
|
||
如果你使用了 `https://openclaw.ai/install.sh` 或 `install.ps1`，CLI 是通过 `npm install -g openclaw@latest` 安装的。
|
||
使用 `npm rm -g openclaw` 移除（或 `pnpm remove -g` / `bun remove -g`，如果你是用那种方式安装的）。
|
||
|
||
### 源码检出（git clone）
|
||
|
||
如果你从仓库检出运行（`git clone` + `openclaw ...` / `bun run openclaw ...`）：
|
||
|
||
1. 在删除仓库**之前**卸载 Gateway 网关服务（使用上面的简单方式或手动服务移除）。
|
||
2. 删除仓库目录。
|
||
3. 按上述方式移除状态 + 工作区。
|