Руководство по удалению OpenClaw

В этой статье объясняется, как полностью удалить OpenClaw, включая CLI, службу Gateway, файлы конфигурации и данные рабочего пространства.

Существует два сценария удаления OpenClaw:

  • CLI всё ещё существует (рекомендуемый подход)
  • CLI удалён, но фоновые службы всё ещё работают (ручная очистка)

I. Рекомендуемый подход (CLI всё ещё существует)

Если команду openclaw всё ещё можно запустить в вашей системе, рекомендуется использовать встроенную команду удаления.

1. Стандартное удаление

openclaw uninstall

Эта команда удалит:

  • Служба Gateway
  • Локальные данные состояния
  • Файлы конфигурации
  • Данные, такие как рабочий каталог агента

2. Неинтерактивное удаление (скрипты автоматизации)

Подходит для CI или сред автоматизированных скриптов:

# 直接执行
openclaw uninstall --all --yes --non-interactive

# 无本地 CLI 时，通过 npx 执行
npx -y openclaw uninstall --all --yes --non-interactive
  • uninstall: Деинсталлятор
  • --all: Удаляет службы и локальные данные вместе (включая службу шлюза, файлы конфигурации, базу данных и т. д.)
  • --yes: Автоматически подтверждает, поэтому вам не придётся вручную повторно вводить Y

II. Ручное удаление (полная очистка)

Если вы хотите полностью контролировать процесс удаления, можно выполнить ручную очистку, следуя приведённым ниже шагам.

1. Остановите службу шлюза

openclaw gateway stop

2. Удалите службу шлюза

openclaw gateway uninstall

Этот шаг удалит фоновые службы из системы:

  • macOS: launchd
  • Linux: systemd
  • Windows: Запланированные задачи

3. Удаление каталогов конфигурации и состояния

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Каталоги по умолчанию:

~/.openclaw

К ним относятся:

  • Файлы конфигурации
  • Токен
  • Сессия
  • Журналы
  • Данные состояния агента

Если были заданы пользовательские переменные среды:

OPENCLAW_CONFIG_PATH

Также необходимо вручную удалить соответствующие файлы.

4. Удаление рабочей области агента (необязательно)

rm -rf ~/.openclaw/workspace

Этот каталог обычно содержит:

  • Код, сгенерированный агентом
  • Файлы выполнения задач
  • Промежуточные данные

5. Удаление CLI

Выберите соответствующую команду в зависимости от способа установки:

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

6. Удаление приложения macOS (если установлено)

rm -rf /Applications/OpenClaw.app

III. CLI потерян, но службы всё ещё работают

Если вы уже удалили CLI, но OpenClaw Gateway всё ещё работает в фоновом режиме, вы можете вручную удалить системную службу.

1. macOS (служба launchd)

Метка службы по умолчанию:bot.molt.gateway(Для multi-config:bot.molt.<profile>, для старых версий:com.openclaw.*）

# 停止并卸载服务
launchctl bootout gui/$UID/bot.molt.gateway

# 删除服务配置文件
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

# 多配置场景：替换为对应 profile 标签
# launchctl bootout gui/$UID/bot.molt.<profile>
# rm -f ~/Library/LaunchAgents/bot.molt.<profile>.plist

# 清理旧版残留（如有）
rm -f ~/Library/LaunchAgents/com.openclaw.*.plist

2. Linux (пользовательская служба systemd)

Имя службы по умолчанию:openclaw-gateway.service(Для multi-config:openclaw-gateway-<profile>.service）

# 停止并禁用服务
systemctl --user disable --now openclaw-gateway.service

# 删除服务配置文件
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 刷新 systemd 配置
systemctl --user daemon-reload

# 多配置场景：替换为对应 profile 服务名
# systemctl --user disable --now openclaw-gateway-<profile>.service
# rm -f ~/.config/systemd/user/openclaw-gateway-<profile>.service
# systemctl --user daemon-reload

3. Windows (запланированная задача)

Имя задачи по умолчанию:OpenClaw Gateway(Для multi-config:OpenClaw Gateway (<profile>)）

# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 删除任务脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

# 多配置场景：替换为对应 profile 任务名
# schtasks /Delete /F /TN "OpenClaw Gateway (<profile>)"
# Remove-Item -Force "$env:USERPROFILE\.openclaw-<profile>\gateway.cmd"

IV. Удаление установок Docker

Если OpenClaw работает в Docker:

docker stop openclaw
docker rm openclaw
docker volume rm openclaw-data

или

docker-compose down -v

V. Удаление установки из исходного кода (git clone)

Если установлено черезgit cloneустановку из исходного кода, сначала нужно очистить службу, затем удалить исходный код и конфигурацию:

  1. Сначала выполните "рекомендуемый способ удаления" или "вручную очистите остатки службы", чтобы остановить и удалить службу шлюза

  2. Удалите каталог репозитория исходного кода

    # 替换为你的源码路径
rm -rf /path/to/openclaw-repo
  3. Удалите каталоги состояния, конфигурации и рабочей области в соответствии с предыдущими шагами

VI. Рекомендуется создать резервную копию перед удалением

Если необходимо сохранить данные, можно сначала создать резервную копию:

openclaw backup create

Затем переходите к удалению.

Проверка удаления

После удаления вы можете проверить, завершена ли очистка, следующими способами:

  • Запуститеopenclaw --version, если отображается "command not found", CLI был успешно удалён
  • Проверьте системные службы:
    • macOS：launchctl list | grep moltНет вывода
    • Linux：systemctl --user list-units | grep openclawНет вывода
    • Windows: в Планировщике заданий нет задач, связанных с "OpenClaw Gateway"
  • Проверьте каталоги:~/.openclaw(и multi-config~/.openclaw-<profile>) были удалены

VII. Общие остаточные каталоги

При полном удалении рекомендуется проверить следующие каталоги:

~/.openclaw
~/.openclaw/workspace
~/Library/LaunchAgents/ai.openclaw.gateway.plist
~/.config/systemd/user/openclaw-gateway.service
Другие расширения