OpenClaw На главную

Решение проблем OpenClaw

Собрали решения для самых частых проблем при работе с OpenClaw. Если вы используете нашу платформу, большинство проблем решается автоматически или через пересоздание агента.

Ошибка 1008 «pairing required»

Одна из самых частых ошибок. Означает, что агент ждёт привязки к Telegram-аккаунту.

Причина: Агент запущен в режиме pairing, но никто ещё не написал боту в Telegram.

Решение:

  1. Найдите вашего бота в Telegram
  2. Напишите ему любое сообщение
  3. Pairing произойдёт автоматически

Если не помогает — удалите агента и создайте нового, указав свой Telegram ID (приватный режим). Подробнее — Подключение Telegram.

На нашей платформе. Если вы видите ошибку 1008 — удалите агента и создайте нового с указанием вашего Telegram ID. Это самый надёжный способ.

«access not configured»

Агент сообщает, что доступ не настроен.

Причина: Не настроен провайдер моделей (API-ключ) или Telegram.

Решение для CLI:

На нашей платформе — обратитесь в поддержку через личный кабинет.

«openclaw: command not found»

Команда openclaw не найдена в терминале.

Решение:

  1. Перезапустите терминал (закройте и откройте заново)
  2. Проверьте, установлен ли OpenClaw: npm list -g openclaw
  3. Если не установлен — установите: npm install -g openclaw
  4. Если установлен, но не найден — добавьте npm в PATH:
# Узнать путь npm
npm config get prefix

# Добавить в PATH (Linux/macOS)
export PATH="$(npm config get prefix)/bin:$PATH"
# Добавьте эту строку в ~/.bashrc или ~/.zshrc для постоянного эффекта

Подробнее — Установка OpenClaw.

Агент не отвечает

Бот в Telegram молчит или веб-интерфейс не работает.

Диагностика:

  1. Проверьте статус в личном кабинете — агент должен быть в статусе «Работает»
  2. Если статус «Создаётся» — подождите 1-2 минуты
  3. Если статус «Остановлен» — нажмите «Запустить» или удалите и создайте нового
  4. Если статус «Ошибка» — удалите агента и создайте нового

Для CLI:

# Проверить статус gateway
openclaw status --deep

# Посмотреть логи
tail -50 /tmp/openclaw-gateway.log

# Перезапустить
for pid in $(pgrep openclaw-gate); do kill -9 $pid; done
rm -f /tmp/openclaw-gateway.lock /tmp/openclaw.lock
sleep 2
openclaw gateway

Не работает cron (задачи по расписанию)

Запланированные задачи не выполняются.

Проверьте:

Для CLI:

«missing scope operator read»

Ошибка связана с конфигурацией scopes (разрешений) агента.

Решение:

OpenClaw Doctor

Встроенный инструмент диагностики для CLI-версии:

openclaw doctor

Doctor проверяет:

Следуйте рекомендациям, которые выдаёт doctor.

Удаление OpenClaw

Полная инструкция по удалению CLI:

Удаление через npm

npm uninstall -g openclaw

Удаление данных

После удаления CLI данные агента остаются на диске. Для полного удаления:

# Linux/macOS
rm -rf ~/.openclaw

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

Удаление на нашей платформе

На нашей платформе для удаления агента достаточно нажать «Удалить» в личном кабинете. Контейнер и все данные будут удалены. Для удаления аккаунта — обратитесь в поддержку.

Переустановка

Чистая переустановка OpenClaw CLI:

# Удалить старую версию
npm uninstall -g openclaw

# Очистить данные (опционально, для чистого старта)
rm -rf ~/.openclaw

# Установить заново
npm install -g openclaw

# Проверить
openclaw --version

«OpenClaw prison»

Это шутливое название ситуации, когда агент попадает в зацикленную задачу и тратит ресурсы. Если агент кажется «зависшим» в бесконечном цикле:

Превышен лимит диска

Каждый контейнер имеет ограничение в 1 ГБ дискового пространства. Если лимит превышен, агент может работать нестабильно: не сохранять файлы, не обновлять память, выдавать ошибки.

Признаки:

Решение:

  1. Откройте вкладку «Файлы» в личном кабинете
  2. Найдите крупные файлы — обычно это сгенерированные изображения, логи или загруженные документы
  3. Удалите ненужные файлы
  4. Проверьте папку workspace/output/ — там скапливаются результаты работы навыков

Кнопка «Перезапустить агента»

В личном кабинете есть кнопка для перезапуска агента. Она помогает в ситуациях, когда агент работает некорректно, но контейнер запущен.

Когда использовать:

Что происходит при перезапуске:

Кулдаун. Перезапуск доступен не чаще одного раза в 5 минут. Gateway требуется 3-5 минут на полный запуск — дождитесь этого времени перед повторными попытками.

Telegram-бот перестал отвечать

Иногда Telegram-бот перестаёт отвечать, хотя статус агента — «Работает» и веб-чат функционирует. Это связано с тем, что процесс получения сообщений из Telegram (polling) может «замолчать» при определённых ошибках.

Признаки:

Решение:

  1. Нажмите кнопку «Перезапустить агента» в личном кабинете
  2. Подождите ~10 минут — gateway перезапустится и подключение к Telegram восстановится
  3. Напишите боту сообщение для проверки

Если проблема повторяется часто — обратитесь в поддержку через личный кабинет.

На нашей платформе

Большинство проблем на нашей платформе решается одним из двух способов:

  1. Перезапуск агента — если агент работает, но не отвечает
  2. Пересоздание агента — если что-то сломалось в конфигурации (создаёт новый контейнер)

Обе кнопки доступны в личном кабинете.

Не нашли решение? Напишите нам через раздел обращений в личном кабинете — мы поможем разобраться.