Переустановить OpenClaw вроде как просто, пока не сталкиваешься с первым подводным камнем. Гейтвей, плагины, каналы обновлений, рабочая копия git. Если просто перетереть файлы, можно остаться и без конфигов, и без готовых агентов, которых собирал неделю. Я этот грабли прошёл на своей шкуре, поэтому расскажу как делать правильно, с сохранением всего состояния.
Первое правило: резервная копия до любых манипуляций
Документация прямо говорит: перед обновлением создайте проверенную резервную копию. Не просто файлик куда-то скинуть, а именно проверенную. Я в своё время пренебрёг, и после неудачного обновления пришлось заново настраивать пару агентов. Больше не повторяю.
Что именно бекапить: рабочий каталог OpenClaw (обычно это ~/openclaw или путь из переменной OPENCLAW_HOME, если вы её задавали), базу данных и конфигурацию. Всё это лежит вместе, так что чаще всего достаточно скопировать папку целиком. Потом проверьте, что из неё реально можно восстановиться. Мёртвый бекап хуже, чем его отсутствие, потому что убаюкивает.
Ещё момент: если откатываетесь на старую версию, сначала откатывайте только код. Восстанавливать состояние (конфиги и БД) имеет смысл, только если старая версия не может работать с тем, что уже лежит в системе. И помните, данные, созданные после резервной копии, будут потеряны. Это нормально, главное чтобы вы об этом знали заранее.
Самый простой путь: команда openclaw update
Если ваш OpenClaw стоит как служба, забудьте про ручное выдёргивание пакета. Команда openclaw update сама согласует замену пакета с работающим Gateway. Это предпочтительный сценарий, и документация это подчёркивает.
Что она делает: проверяет установленную версию, если надо - обновляет глобальный пакет, затем синхронизирует плагины, обновляет автодополнение основных команд и перезапускает всё, что нужно. При этом упакованные вспомогательные компоненты и записи плагинов остаются в соответствии с новой сборкой. Полную пересборку автодополнения команд плагинов она не трогает, для этого потом можно явно выполнить openclaw completion --write-state, если понадобится.
Звучит отлично, но есть нюансы. Команда не поможет, если установка сломана настолько, что CLI вообще не запускается. Или если вы сидите на нестандартном канале. Тогда идём по ручному сценарию.
Ручная переустановка: по шагам с командами
Ручной путь нужен, когда обновление через CLI недоступно. Тут главная опасность - работающий процесс Gateway. Менеджеры пакетов заменяют файлы на месте, поэтому живой Gateway во время замены может попытаться подгрузить файлы ядра или плагинов из недоконченной установки. Отсюда и порядок действий.
Сначала останавливаем управляемый Gateway. Потом ставим пакет тем же менеджером и с той же областью установки, которой принадлежит текущий Gateway. В официальной документации это выглядит так:
openclaw gateway stop
npm i -g openclaw@openclaw
openclaw gateway install --force
openclaw gateway restart
Разберу, что тут происходит. Первая команда глушит службу. Вторая ставит актуальный пакет в глобальную область npm. Третья переустанавливает службу Gateway с принудительным режимом, чтобы она подхватила новое расположение файлов и настройки. Четвёртая запускает всё заново. Всё, после этого OpenClaw работает на свежей версии, а ваши данные остаются на месте.
Один момент, который часто упускают: используйте тот же менеджер пакетов. Если изначально ставили через bun, а переустанавливаете через npm, можно получить конфликт путей и странное поведение. Какой менеджер ставил, тем и чините.
Переключение между каналами: stable и dev
OpenClaw даёт два канала установки, и переключаться между ними можно без танцев с бубном.
Канал dev использует рабочую копию git. По умолчанию это ~/openclaw, либо $OPENCLAW_HOME/openclaw, если задана переменная OPENCLAW_HOME. Можно переопределить и через OPENCLAW_GIT_DIR. Команда openclaw update --channel dev подтягивает свежий код из репозитория, собирает и ставит глобальный CLI из этой рабочей копии. Это для тех, кто хочет жить на острие и ловить новые фичи раньше всех.
Канал stable ставит из npm с тегом latest. Это то, что большинству и нужно в продакшене. Переключаетесь обратно командой openclaw update --channel stable. Вся прелесть в том, что состояние и агенты при таком переключении не страдают, если вы не теряете рабочую директорию.
Лично я держу основные проекты на stable, а dev-канал использую на отдельной машине для экспериментов. Так и баги не кусают, и новые возможности видно заранее.
Если всё сломалось: openclaw update repair
Бывает, что переустановка прошла, но что-то пошло не так. Плагины не видны, конфиг не подхватывается, автодополнение отвалилось. Прежде чем сносить всё подчистую, попробуйте механизм восстановления.
openclaw update repair запускает цепочку: сначала openclaw doctor --fix, потом перезагружает восстановленную конфигурацию и записи об установке, синхронизирует отслеживаемые плагины для активного канала, чинит установки управляемых npm-плагинов, восстанавливает отсутствующие данные и обновляет реестр. Полезная штука, часто вытягивает даже с виду безнадёжные случаи.
Важный нюанс: эта команда не устанавливает новый основной пакет и не перезапускает Gateway. То есть это именно ремонт, а не переустановка. Если проблема в самом ядре, repair не поможет, тогда нужен полный цикл из предыдущего раздела.
Полная переустановка с чистого листа
Иногда проще снести всё и поставить заново. Особенно если вы экспериментировали с каналами, ставили плагины из разных источников и теперь не понимаете, что вообще творится в системе.
Удаление OpenClaw делается штатными средствами, но тут я советую быть внимательным. Стандартное удаление через npm (npm uninstall -g openclaw) уберёт пакет, но оставит конфигурацию и данные агентов. Это правильно, потому что восстановиться потом будет проще. Если хотите удалить совсем всё, включая данные, придётся чистить и рабочий каталог вручную.
После удаления ставим заново. Под Node.js (если вы управляете им сами) классика такая:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Первая команда ставит глобальный пакет, вторая запускает инициализацию и установку демона. Если вы на pnpm, картина чуть другая:
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
pnpm отдельно требует подтверждения сборок, это его особенность. Про неё легко забыть, а потом удивляться, почему половина функционала не работает.
Для bun аналогично:
bun add -g openclaw@latest
openclaw onboard --install-daemon
Для разработчиков, которые хотят запускать OpenClaw из локальной копии исходников, есть отдельный путь. Нужно склонировать репозиторий, собрать и сделать глобальную ссылку:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Тут чуть дольше, зато вы всегда видите код и можете вносить свои правки. Для контрибьюторов и любопытных - самое то.
Типичная головная боль: openclaw не найден
Переустановили, команда openclaw пишет command not found. Девять из десяти случаев - это проблема PATH. Каталог глобальных исполняемых файлов npm просто не добавлен в переменную PATH вашей оболочки. На Reddit пользователи OpenClaw не раз жаловались на эту ошибку - и каждый раз решение упирается в PATH. Решение тривиальное: добавить его. В официальной документации есть полное руководство, включая пути для Windows, так что если столкнулись - загляните туда, а не пытайтесь лечить через переустановку Node.js.
Если после переустановки команда находится, но ругается на запущенный Gateway или странные ошибки плагинов, первое, что делаю я - проверяю, не осталось ли старого процесса. В Linux это ps aux | grep openclaw. Старые процессы частенько держат старые библиотеки в памяти, и после обновления это даёт сбои, которые никак не объяснить кодом.
Пара слов про экосистему вокруг OpenClaw
Говоря о переустановке агентной инфраструктуры, стоит помнить: сам софт - это только половина дела. Вторая половина - модели, на которых ваши агенты работают. И тут в 2026 году открывается интересная картина.
Я по роду деятельности постоянно тестирую разные нейросети и подписываюсь на новые модели. И довольно долго мучился с тем, что доступ к флагманским моделям из России - это квест с иностранными картами, прокси и постоянным риском отвалиться в самый неподходящий момент. Пока не нашёл для себя рабочий вариант: сервис, который даёт доступ ко всем основным моделям сразу через один интерфейс. Если у вас та же боль, обратите внимание на 3GPT от 3SELLER.
Там доступны и свежие Chat GPT 6 Astra, и Claude Fable 5.1, и Opus 5.5, и даже генератор изображений Nano Banana с видео. Платить можно российской картой, через СБП или криптой, что для нас с вами критично. Я себе взял подписку за 149 рублей и теперь не думаю о том, какой моделью закрыть задачу. Просто выбираю нужную в интерфейсе и работаю. Там даже есть готовые ИИ-агенты под типовые задачи - выбрал подходящего, и общаешься. Модель внутри агента можно менять прямо в чате.
Это, кстати, хорошо ложится на тему статьи: переустановил OpenClaw, настроил агентов, а дальше используешь их в связке с нормальными флагманскими моделями. Вся связка работает как часы.
Что в итоге
Переустановка OpenClaw не должна быть страшной. Порядок простой: сделали резервную копию, попробовали openclaw update, если не вышло - остановили Gateway, переставили пакет тем же менеджером, перезапустили. Если что-то сломалось после, применили update repair. Каналы switching делается двумя командами. Всё остальное - это уже детали конкретной системы.
Главное, что я вам советую: не игнорируйте бекапы и не ленитесь проверять, что они рабочие. Половина историй про потерянные конфиги начинается со слов "я думал, там всё сохранится". Не думайте, проверяйте.
И да, когда соберёте свою боевую связку из OpenClaw и нормальных моделей - не забудьте прикрутить к ней доступ к флагманским нейросетям. 3GPT решает именно эту боль для российских пользователей. Бесплатных крутых моделей много, но флагманы дают совсем другой уровень качества, и за 149 рублей это лучшая сделка на рынке прямо сейчас.