---
read_when:
  - 你想从机器上移除 HanzoBot
  - 卸载后 Gateway 网关服务仍在运行
summary: 完全卸载 HanzoBot（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
---

# 卸载

两种方式：

- 如果 `hanzo-bot` 仍已安装，使用**简单方式**。
- 如果 CLI 已删除但服务仍在运行，使用**手动服务移除**。

## 简单方式（CLI 仍已安装）

推荐：使用内置卸载程序：

```bash
hanzo-bot uninstall
```

非交互式（自动化 / npx）：

```bash
hanzo-bot uninstall --all --yes --non-interactive
npx -y hanzo-bot uninstall --all --yes --non-interactive
```

手动步骤（效果相同）：

1. 停止 Gateway 网关服务：

```bash
hanzo-bot gateway stop
```

2. 卸载 Gateway 网关服务（launchd/systemd/schtasks）：

```bash
hanzo-bot gateway uninstall
```

3. 删除状态 + 配置：

```bash
rm -rf "${BOT_STATE_DIR:-$HOME/.hanzo-bot}"
```

如果你将 `BOT_CONFIG_PATH` 设置为状态目录外的自定义位置，也请删除该文件。

4. 删除你的工作区（可选，移除智能体文件）：

```bash
rm -rf ~/.hanzo-bot/workspace
```

5. 移除 CLI 安装（选择你使用的那个）：

```bash
npm rm -g hanzo-bot
pnpm remove -g hanzo-bot
bun remove -g hanzo-bot
```

6. 如果你安装了 macOS 应用：

```bash
rm -rf /Applications/HanzoBot.app
```

注意事项：

- 如果你使用了配置文件（`--profile` / `BOT_PROFILE`），对每个状态目录重复步骤 3（默认为 `~/.hanzo-bot-<profile>`）。
- 在远程模式下，状态目录位于 **Gateway 网关主机**上，因此也需要在那里运行步骤 1-4。

## 手动服务移除（CLI 未安装）

如果 Gateway 网关服务持续运行但 `hanzo-bot` 缺失，请使用此方法。

### macOS（launchd）

默认标签是 `bot.molt.gateway`（或 `bot.molt.<profile>`；旧版 `com.hanzo-bot.*` 可能仍然存在）：

```bash
launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
```

如果你使用了配置文件，请将标签和 plist 名称替换为 `bot.molt.<profile>`。如果存在任何旧版 `com.hanzo-bot.*` plist，请将其移除。

### Linux（systemd 用户单元）

默认单元名称是 `hanzo-bot-gateway.service`（或 `hanzo-bot-gateway-<profile>.service`）：

```bash
systemctl --user disable --now hanzo-bot-gateway.service
rm -f ~/.config/systemd/user/hanzo-bot-gateway.service
systemctl --user daemon-reload
```

### Windows（计划任务）

默认任务名称是 `HanzoBot Gateway`（或 `HanzoBot Gateway (<profile>)`）。
任务脚本位于你的状态目录下。

```powershell
schtasks /Delete /F /TN "HanzoBot Gateway"
Remove-Item -Force "$env:USERPROFILE\.hanzo-bot\gateway.cmd"
```

如果你使用了配置文件，请删除匹配的任务名称和 `~\.hanzo-bot-<profile>\gateway.cmd`。

## 普通安装 vs 源码检出

### 普通安装（install.sh / npm / pnpm / bun）

如果你使用了 `https://hanzo-bot.ai/install.sh` 或 `install.ps1`，CLI 是通过 `npm install -g hanzo-bot@latest` 安装的。
使用 `npm rm -g hanzo-bot` 移除（或 `pnpm remove -g` / `bun remove -g`，如果你是用那种方式安装的）。

### 源码检出（git clone）

如果你从仓库检出运行（`git clone` + `hanzo-bot ...` / `bun run hanzo-bot ...`）：

1. 在删除仓库**之前**卸载 Gateway 网关服务（使用上面的简单方式或手动服务移除）。
2. 删除仓库目录。
3. 按上述方式移除状态 + 工作区。