Openclaw — ИИ-агент, который работает в связке с большинством ИИ-моделей и позволяет делегировать ему выполнение рутинных задач.
В инструкции рассмотрим установку Openclaw на операционную систему Ubuntu 26, настройку агента и подключение ИИ-модели через API-ключ.
Перед началом работы необходимо:
- подготовить сервер с Ubuntu 26;
- получить API-ключ используемой ИИ-модели.
Шаг 1. Установка NodeJS
Для работы Openclaw необходимо установить NodeJS.
Выполните команду:
curl -fsSL https://deb.nodesource.com/setup_26.x | sudo -E bash -
После этого установите NodeJS:
sudo apt install -y nodejs
Проверить установку можно командой:
node --version
В результате будет отображена установленная версия NodeJS.
Шаг 2. Установка Openclaw
Установить Openclaw можно двумя способами.
Вариант 1. Установка через мастер настройки
curl -fsSL https://openclaw.ai/install.sh | bash
Вариант 2. Установка через npm
В данном варианте мастер настройки автоматически не запускается.
npm install -g openclaw@latest
После установки выполните проверку:
openclaw --version
Рисунок 1 — Проверка установки Openclaw
Шаг 3. Установка службы агента и настройка Openclaw
Для установки службы агента и запуска мастера настройки выполните команду:
openclaw onboard --install-daemon
Выбор режима доступа
Мастер предложит выбрать тип подключения: однопользовательский или многопользовательский.
При выборе режима «Yes» будет установлен однопользовательский вариант.
Рисунок 2 — Выбор режима доступа
Отправка данных разработчикам
Далее мастер предложит отправить информацию разработчикам Openclaw. Можно согласиться или отказаться.
Выбор метода установки
Рекомендуется выбрать вариант:
QuickStart
Рисунок 3 — Выбор метода установки
Имя агента
Укажите имя создаваемого агента.
Например:
efsol_agent
Рисунок 4 — Настройка имени агента
Выбор ИИ-модели
На следующем шаге выберите используемую ИИ-модель и укажите подготовленный API-ключ.
Рисунок 5 — Выбор ИИ-модели
Набор доступных моделей зависит от выбранного провайдера ИИ.
Проверка подключения API
После выбора модели обязательно выполните проверку подключения по API-ключу.
В примере используется Deepseek.
Рисунок 6 — Проверка доступности API
Выбор поисковой системы
Далее мастер предложит выбрать поисковую систему.
Можно выбрать любой вариант, учитывая требования к API-ключам.
Зависимости скиллов
Мастер предложит добавить зависимости скиллов. Их можно установить сразу или настроить позже.
Рисунок 7 — Выбор зависимостей скиллов
Завершение настройки
После окончания настройки мастер покажет краткую сводку параметров.
Рисунок 8 — Краткая сводка настроек
Выйти из окна можно комбинацией:
Ctrl + C
Нажмите комбинацию два раза подряд.
Проверка конфигурации Openclaw
После настройки рекомендуется выполнить проверку:
openclaw doctor
Утилита найдет ошибки конфигурации, исправит их автоматически или предложит варианты решения.
Настройка доступа через браузер
Для доступа к агенту через браузер необходимо установить шлюз и выделить ему порт.
openclaw gateway --port 10700
Порт 10700 является примером. Можно использовать любой свободный порт.
После запуска откройте страницу агента в браузере. По умолчанию сервис доступен через:
127.0.0.1
или
localhost
Рисунок 9 — Доступность чата агента через браузер
Завершение установки
Для входа агент запросит токен. Создать его можно согласно подсказкам на странице подключения.
После ввода токена в поле Gateway secret нажмите Connect.
Установка завершена
Базовая установка Openclaw завершена.
Дальнейшая настройка выполняется в зависимости от задач, которые должен выполнять ИИ-агент.