Распространенные ошибки при установке OpenClaw и способы их устранения

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

Недавняя публикация в r/openclaw затрагивает повторяющиеся ошибки при установке и запуске инструмента OpenClaw, предоставляя конкретные команды и исправления.

Ключевые проблемы и их решения

«Установлено, но openclaw не обнаруживается»

Это происходит, когда глобальный каталог bin npm не указан в вашем PATH. Исполняемый файл существует, но система не может его найти.

• Выполните npm prefix -g, чтобы найти ваш глобальный префикс.
• Добавьте <prefix>/bin в ваш $PATH в файле .bashrc или .zshrc.
• Перезагрузите оболочку, после чего команда openclaw --version должна работать.

«EACCES: permission denied» при установке

Это проблема с правами доступа к глобальному каталогу npm по умолчанию, который часто принадлежит root.

• Не используйте sudo.
• Вместо этого настройте префикс, принадлежащий пользователю:

  mkdir -p ~/.npm-global
  npm config set prefix '~/.npm-global'
  export PATH="$HOME/.npm-global/bin:$PATH"

• Добавьте экспорт в конфигурацию вашей оболочки и повторно запустите установку без sudo.

Тихие сбои из-за старой версии Node.js

OpenClaw требует Node.js версии 22+. Более старые версии могут установиться без ошибок, но создадут исполняемый файл, который ломается при запуске.

• Всегда сначала проверяйте node --version.

«inappropriate ioctl for device»

Это проблема с TTY, часто возникающая в контейнерах Docker или CI-средах без реального терминала.

• Запустите openclaw onboard --non-interactive --accept-risk, чтобы пропустить интерактивный мастер.

Плагин Telegram застрял в состоянии «недоступен»

Если предыдущая неудачная установка оставила плагин Telegram в частично настроенном состоянии, он может зависнуть.

• Выполните openclaw doctor --fix, чтобы очистить состояние.

Примечание о «gateway connect pairing required»

Это сообщение не является ошибкой установки. Оно относится к политике DM, где OpenClaw по умолчанию требует ручной привязки перед ответом на личные сообщения. Обратитесь к документации OpenClaw по настройке каналов.