Как установить OpenClaw на Ubuntu и проверить Gateway

Что понадобится

Нужна Ubuntu с доступом к интернету и правами на установку программ. Для актуального Linux-установщика документация указывает Node.js 24.16+ или 26.1+; Node.js 26 рекомендуется. Проверьте среду:

node --version
printf '%s\n' "$SHELL"

Для onboarding подготовьте существующий вход Claude Code или Codex CLI либо API-ключ провайдера модели. Это условие первого рабочего чата, а не только установки CLI.

Установите OpenClaw

Для Ubuntu используйте Linux-установщик:

curl -fsSL https://openclaw.ai/install.sh | bash

Скрипт определяет Linux-среду, при необходимости устанавливает Node.js, устанавливает OpenClaw и запускает первоначальную настройку. Если onboarding нужно пройти позже, используйте отдельный режим:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

При самостоятельном управлении Node.js доступен пакетный способ. Для npm 12 и npm 11.16+ официальная инструкция приводит:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Для npm 11.15 и более ранних версий этот флаг не используется. Выберите один способ установки и не смешивайте его с другим до завершения диагностики.

Пройдите onboarding

Если установщик запустил мастер автоматически, завершите его и выберите подходящий вариант настройки. При режиме --no-onboard выполните:

openclaw onboard --install-daemon

Onboarding настраивает конфигурацию и Gateway. Рекомендация Paramiko: перед изменениями подготовьте резервную копию важных конфигураций и проверьте, под какой учётной записью будет работать служба. Не сохраняйте API-ключи в тексте статьи, общем скрипте или публичном чате.

Установите службу Linux

Если Gateway сейчас работает в терминале, остановите foreground-процесс сочетанием Ctrl+C. Затем установите управляемый запуск:

openclaw gateway install

Для Linux документация описывает пользовательскую службу systemd. Проверьте состояние:

openclaw gateway status

Рекомендация Paramiko: после установки выйдите из текущего shell и повторите проверку из новой сессии. Так можно отдельно убедиться, что служба не зависит от случайно выставленных переменных интерактивного терминала. Это проверка эксплуатации, а не утверждение о дополнительной функции OpenClaw.

Проверьте CLI и интерфейс

Выполните базовые команды:

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

Официальное руководство указывает ожидаемый для текущей документации порт Gateway 18789. Это не следует считать неизменяемым значением: при другой конфигурации проверяйте фактические параметры запуска.

Если dashboard открывается, отправьте тестовое сообщение в Control UI и убедитесь, что получен ответ модели. Такая проверка подтверждает связку CLI, сохранённой конфигурации, Gateway и доступа к модели, но не проверяет отдельные каналы или бизнес-интеграции.

Если openclaw не найден

Проверьте Node.js, глобальный prefix npm и PATH текущей оболочки:

node -v
npm prefix -g
echo "$PATH"

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

Если CLI доступен, но есть проблемы с конфигурацией, используйте:

openclaw doctor
openclaw triage

doctor предназначен для проверки конфигурации, а triage — для диагностики текущего состояния. Не публикуйте вывод, содержащий секреты или чувствительные параметры.

До подключения рабочих данных

Рекомендация Paramiko: сначала проверьте установку на отдельной Ubuntu-машине и ограниченном тестовом сценарии. Определите, какие действия агент может выполнять самостоятельно, а какие требуют подтверждения человека. Перед подключением каналов или внутренних систем проверьте доступы, обработку ошибок и результат на тестовых данных.

Установка OpenClaw заканчивается технической проверкой CLI, Gateway и тестового сообщения. Подключение Telegram, CRM, почты или внутреннего API — отдельная задача, для которой нужно подтвердить конкретную совместимость и права. Paramiko может помочь описать процесс, согласовать доступы и проверить ограниченный пилот; это предложение подхода, а не заявление о готовой интеграции.