Как удалить OpenClaw?

Удаление OpenClaw (uninstall / remove) — задача с подвохом: стандартное npm uninstall не убирает systemd-сервисы, не чистит кэши и не выключает Telegram-ботов. Если после удаления попытаться поставить OpenClaw заново — он часто конфликтует с «осколками» предыдущей установки. Ниже — полный гайд с учётом этих ловушек.

Шаг 0: подготовка перед удалением. Если планируете вернуться или перенести инсталляцию — экспортируйте workspace и память агентов перед удалением: папка ~/.openclaw/ содержит всё (memory, config, агентов, ключи). Сохраните её копию (tar -czf openclaw-backup.tar.gz ~/.openclaw). Отдельно — отключите ботов в мессенджерах: в Telegram через @BotFather командой /deletebot (иначе пользователи продолжат писать в «мёртвого» бота). Если использовали Yandex Cloud / GigaChat — отзовите токены в их консолях.

Удаление CLI-установки (npm). Это самый частый сценарий. Сначала остановите Gateway, затем удалите глобальный npm-пакет и директорию данных. Пакет называется openclaw (без scope) — это важно: команды вида npm uninstall -g @openclaw/cli или @openclaw/openclaw работать не будут.

Удаление systemd-сервиса (Linux). Если вы создавали unit-файл для автозапуска (вручную или через openclaw service install) — npm uninstall его не удалит. Это самый типичный «призрак»: пакета нет, а сервис продолжает падать в логах. Найдите все openclaw-юниты через systemctl list-unit-files | grep openclaw, остановите и отключите их, затем удалите unit-файлы из /etc/systemd/system/ (или /lib/systemd/system/) и перечитайте конфигурацию systemd.

Удаление Docker-установки. Остановите и удалите контейнер с томом, затем удалите образ. Если использовали Docker Compose — docker compose down -v убирает контейнер и тома, но не образ.

Удаление Homebrew (macOS). brew uninstall openclaw убирает бинарь, но не данные. Папка ~/.openclaw остаётся — удаляйте отдельно.

Удаление на Windows. Если ставили через npm — npm uninstall -g openclaw + удаление %USERPROFILE%\.openclaw. Если был сервис через NSSM или планировщик задач — удалите его отдельно.

Что точно нужно удалить вручную: — Бинарь и npm-пакет (через uninstall) — Папка данных ~/.openclaw/ (workspace, память, конфиги) — systemd-сервис (если создавали) — Docker-контейнер, том, образ (если Docker) — Логи в /var/log/openclaw/ (если настраивали) — Файлы .env с API-ключами рядом с проектом (если ставили в режиме разработки) — Telegram-бот через @BotFather (бот в чате останется иначе)

Что НЕ удаляется автоматически и обычно не нужно трогать: — Node.js (нужен для других проектов; убирайте только если уверены) — Кэш npm (~/.npm) — может пригодиться при будущих установках — Бэкапы, которые вы делали сами

Проверка остатков. После удаления выполните проверку — не осталось ли «хвостов»: команда which openclaw должна вернуть пустоту, ls ~/.openclaw — «No such file or directory», systemctl list-units --all 'openclaw*' — без активных юнитов. Также проверьте, что порт Gateway (обычно 3000 или 18789) свободен через lsof -i :3000.

Чистая переустановка. Если удаление нужно для повторной установки «с нуля» — обязательно сделайте все шаги выше до npm install -g openclaw. Частая ошибка: ставят пакет поверх старого ~/.openclaw — OpenClaw подхватывает старые конфиги, ловит конфликты по портам или зависшую сессию pairing. Чистая переустановка решает 90% таких случаев.

# Шаг 0: бэкап перед удалением (опционально)
tar -czf ~/openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw

# Отвязать pair перед удалением (если есть доступ к Gateway)
openclaw pair revoke --all
openclaw stop

# Удаление CLI / npm (Linux, macOS, WSL, Windows)
npm uninstall -g openclaw
rm -rf ~/.openclaw

# Проверка
which openclaw    # должно быть пусто
ls ~/.openclaw    # No such file or directory

# Полное удаление systemd-сервиса (Linux) — типичные «призраки»
systemctl list-unit-files | grep openclaw

# для каждого найденного юнита, например openclaw.service:
sudo systemctl stop openclaw.service
sudo systemctl disable openclaw.service
sudo rm /etc/systemd/system/openclaw.service
sudo rm -f /lib/systemd/system/openclaw.service
sudo systemctl daemon-reload
sudo systemctl reset-failed

# Удаление Docker-установки
docker compose down -v          # контейнер + тома
docker rmi openclaw/openclaw:latest
docker volume prune              # на всякий случай — почистить orphan-тома

# Удаление через Homebrew (macOS)
brew uninstall openclaw
rm -rf ~/.openclaw
rm -rf ~/Library/Application\ Support/openclaw/  # на случай старых версий

# Проверка после удаления — что ничего не осталось
which openclaw                                         # пусто
ls ~/.openclaw 2>&1 | head -1                          # No such file or directory
systemctl list-units --all 'openclaw*' 2>/dev/null    # 0 loaded
lsof -i :3000 -i :18789 2>/dev/null                   # порт свободен
ps aux | grep -i openclaw | grep -v grep              # никаких процессов