Установка OpenCLAW:
Как создать AI-агента и чат-бот

Прежде чем мы начнем разворачивать нашего нейроагента, убедитесь, что у вас готова техническая база. Это фундамент всего нашего будущего "контент-завода", поэтому к выбору сервера нужно подойти ответственно.

• Виртуальный сервер (VPS): Строго на базе операционной системы Ubuntu 24.04 LTS. Менее 2 ГБ ОЗУ не рекомендуем, так как нейросети и базы данных (включая парсинг огромных файлов) требуют оперативной памяти.
  
  👉 Рекомендуем: Арендовать мощный VPS на Beget (выбирайте тариф от 2 ГБ ОЗУ). Это проверенный провайдер с отличной скоростью, техподдержкой и готовыми образами Ubuntu.
• IP-адрес: Публичный адрес вашего сервера (например, 87.250.250.242), который вы получите сразу после аренды на Beget. Это ваш уникальный идентификатор в интернете, по которому мы будем подключаться к серверу.
• Инструмент управления: Терминал (на macOS/Linux) или PowerShell/CMD (на Windows). В Windows просто нажмите Win+R, напишите cmd и нажмите Enter. Через эту черную консоль мы будем передавать команды нашему серверу.
• Прокси (Опционально): Если вы выбрали сервер в РФ, но хотите использовать заблокированные модели (ChatGPT, Claude). Подробности в Шаге 2.

Откройте ваш терминал и установите защищенное SSH соединение с сервером от имени суперпользователя (root). Это даст нам полный контроль над системой для установки ядра.

ssh root@ВАШ_IP_АДРЕС_СЕРВЕРА

При запросе пароля введите его. Символы не отображаются на экране — это нормальная защита Linux от подглядывания. Просто введите пароль и нажмите Enter.

Где взять Proxy? (Только для РФ серверов)

Если ваш сервер физически находится в РФ, доступ к API нейросетей будет закрыт. Вам потребуется прокси.

Теперь установим прокси на ваш сервер. Мы подготовили специальный автоматический скрипт, который сделает всё за вас. Он скачает и настроит локальный прокси-сервер Squid, через который OpenCLAW сможет направлять трафик в интернет через купленный вами upstream proxy.

bash <(curl -fsSL https://mayai.ru/proxy.sh)

После завершения обязательно проверьте, что внешний IP действительно поменялся на IP купленного прокси:

curl -s -x http://127.0.0.1:3128 https://ifconfig.me

Если команда вернула IP вашего купленного прокси, значит Squid настроен правильно и можно переходить дальше.
Если IP не изменился, не переходите к установке OpenCLAW, пока не исправите прокси. Иначе бот позже может выдавать ошибки доступа к LLM API по региону.

Работать под root-правами крайне небезопасно для постоянных сервисов, висящих в сети. Если хакер взломает бота, он получит полный контроль над всем сервером. Мы создадим ограниченного пользователя lutik (Лютик — имя нашего агента) специально для запуска ИИ.

Создаем профиль (введите любой пароль 2 раза, остальные поля вроде имени и телефона можно пропустить простым нажатием Enter):

adduser lutik

Выдаем ему административные права (sudo), чтобы Лютик мог сам устанавливать нужные ему системные пакеты (например, Node.js) при автоматической настройке ядра OpenCLAW, не спрашивая каждый раз пароль root:

usermod -aG sudo lutik

Переключаемся с root на наш новый безопасный профиль. Команда su означает Substitute User, а минус гарантирует загрузку профиля с чистого листа:

su - lutik

Защитим сервер от сканеров портов и вредоносных ботов, которые постоянно пытаются подобрать пароли ко всем серверам в интернете. Мы закроем все "дыры" (порты) извне, оставив открытым только один защищенный порт (OpenSSH) для нашего с вами управления сервером.

sudo ufw allow OpenSSH
sudo ufw enable

Когда система спросит Command may disrupt existing ssh connections. Proceed with operation (y|n)?, введите y (yes) и нажмите Enter. Не бойтесь, ваше текущее соединение не прервется.

Кульминация! Запускаем главный установочный скрипт. Он скачает Node.js (среду выполнения для JavaScript), настроит все необходимые зависимости, создаст локальные базы данных SQLite для хранения памяти бота и запустит интерактивный мастер настройки (Wizard) прямо в терминале.

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

В процессе установки мастер задаст вам несколько вопросов:

1. Провайдер LLM: Выберите OpenRouter (это лучший агрегатор нейросетей, где есть вообще всё).
2. Модель по умолчанию: 👉 Настоятельно рекомендуем выбрать Kimi 2.5 (moonshot-v1-auto) или Claude 3.5 Sonnet. Kimi 2.5 сейчас показывает феноменальные результаты в парсинге, логике и работе с русским языком. Она быстрая, дешевая и невероятно умная.
3. Каналы: Выберите Telegram и вставьте токен вашего бота (получается у @BotFather в самом приложении Telegram).

Библиотека скиллов (Навыков)

При установке вам предложат выбрать базовые навыки для вашего бота. Вот что они означают:

• lpassword: Клиент командной строки для взаимодействия с менеджером паролей.
• blogwatcher: Отслеживание и чтение обновлений блогов через RSS/Atom.
• blucli: Управление Bluetooth-соединениями и устройствами из терминала.
• camsnap: Команда для захвата изображений с подключенной веб-камеры.
• clawhub: CLI-интерфейс для работы с проектами и задачами на GitHub.
• eightctl: Управление конфигурацией для системы автоматизации.
• gemini: Интерфейс для взаимодействия с ИИ-моделью Google Gemini.
• gifgrep: Поиск текста или метаданных внутри GIF-изображений.
• github: Дополнительные инструменты для работы с GitHub API.
• gog: Управление библиотекой игр GOG.com и установкой.
• goplaces: Поиск мест, услуг и отзывов поблизости.
• himalaya: Почтовый клиент на базе Markdown для терминала.
• mcporter: Управление и перенос серверов/модов Minecraft.
• nano-banana-pro: Расширенный текстовый редактор nano с дополнительными функциями.
• nano-pdf: Пакет для просмотра и конвертации PDF-файлов внутри окружения nano.
• obsidian: Интеграция с базой знаний Obsidian (заметки).
• openai-whisper: CLI для распознавания речи на базе модели Whisper от OpenAI.
• openhue: Дистанционное управление освещением Philips Hue.
• oracle: Доступ к базе данных Oracle или выполнение запросов.
• ordercli: Оформление заказов или покупка товаров через CLI.
• sag: Утилита для работы с астрономическими данными или SAG-сервисами.
• songsee: Распознавание музыки по звуку или тексту песен.
• sonoscli: Управление акустическими системами Sonos.
• summarize: Генерация кратких сводок из больших текстовых документов.
• video-frames: Инструмент для извлечения кадров и анализа видео.
• wacli: Получение прогноза погоды и климатических данных.
• xurl: Утилита для обработки URL: сокращение, проверка, расширение.

Автоматизация и Hooks (Хуки)

Также Wizard предложит вам включить системные хуки. Хуки — это сценарии, которые срабатывают автоматически при определенных событиях.

• Skip for now (Отключить хуки): Хуки не активируются. Выбрав эту опцию, вы отключаете всю автоматизацию. Агент будет полагаться исключительно на свое поведение по умолчанию. Никакие данные не будут логироваться, и контекст не будет сохраняться между сессиями. Это полезно для чистых, изолированных тестов без посторонних влияний.
• boot-md (Загрузочный скрипт): Автоматически генерирует и выполняет Markdown 'загрузочный скрипт' во время последовательности запуска агента. Этот скрипт можно использовать для предварительной настройки переменных окружения, создания структур каталогов или инициализации других систем.
• bootstrap-extra-files (Внедрение файлов): Обеспечивает механизм для копирования дополнительных файлов или каталогов в рабочую среду агента сразу после запуска (например, конфигурационные файлы, шаблоны).
• command-logger (Регистратор команд): Активно записывает подробный лог каждой отдельной команды, выданной агенту, вместе с метками времени, полным текстом команды и информацией о том, была ли команда успешной. Идеально для аудита и отладки.
• session-memory (Память сессии): Автоматически сохраняет весь контекст сессии агента (всю историю разговоров, текущие состояния переменных и записи использования инструментов) в специальный файл или базу данных 'памяти', когда выдается конкретная команда, например /new или /reset. Этот контекст затем можно загрузить при запуске новой сессии, чтобы сохранить преемственность. Идеально подходит для поддержания долгосрочного контекста.

Настройка переменных (PATH)

По умолчанию Linux может не найти команду openclaw после установки. Чтобы система знала эту глобальную команду и вы могли вызывать панель управления или проверять статус из любой папки сервера, мы пропишем путь к ней в скрытый файл настроек вашего пользователя (.bashrc), обновим конфигурацию (командой source) и проверим, где лежит программа (командой which):

echo 'export PATH="/home/lutik/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
which openclaw

Если последняя команда (which) выдала длинный путь к файлу (например, /home/lutik/.npm-global/bin/openclaw) — вы всё сделали идеально. Двигаемся дальше!

Чтобы бот продолжал работу даже когда вы выключаете компьютер, закрываете терминал и ложитесь спать, нам нужно прописать его как системный сервис (фоновый демон systemd).

exit          # Выходим из аккаунта lutik обратно в root
exit          # Выходим из root (соединение с сервером закроется)
ssh lutik@ВАШ_IP_АДРЕС_СЕРВЕРА

Теперь мы подключились правильно. Активируем фоновую работу (linger) с помощью менеджера сеансов loginctl, чтобы процессы пользователя не убивались после закрытия терминала. Затем запускаем встроенную команду "лечения" (doctor --repair). Что она делает? Она проанализирует систему, сама создаст конфигурационный файл для systemd-сервиса (демона, который будет работать вечно), пропишет автозапуск бота при перезагрузке сервера и сразу запустит его. Это гарантия того, что бот всегда будет онлайн:

sudo loginctl enable-linger lutik
openclaw doctor --repair

mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d
cat > ~/.config/systemd/user/openclaw-gateway.service.d/proxy.conf <<'EOF'
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:3128"
Environment="HTTPS_PROXY=http://127.0.0.1:3128"
Environment="ALL_PROXY=http://127.0.0.1:3128"
EOF
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway.service

openclaw gateway status
PID=$(pgrep -f "openclaw.*gateway" | head -n 1)
tr '\0' '\n' < /proc/$PID/environ | grep -Ei '^(HTTP|HTTPS|ALL)_PROXY='

HTTP_PROXY=http://127.0.0.1:3128
HTTPS_PROXY=http://127.0.0.1:3128
ALL_PROXY=http://127.0.0.1:3128

Чтобы убедиться, что всё работает, запросим статус сервиса (подождите секунд 10-15 после предыдущей команды):

openclaw gateway status

Должно показать: Service: systemd (enabled) и Runtime: running.

Последний штрих безопасности. Командой chmod мы меняем права доступа к файлам. Мы закрываем доступ к скрытой папке .openclaw от всех других возможных пользователей на сервере, разрешая чтение и запись только владельцу (lutik). Это критически важно, так как там в открытом виде лежат ваши токены Telegram и ключи от LLM:

chmod 700 ~/.openclaw
chmod 700 ~/.openclaw/credentials
chmod 600 ~/.openclaw/openclaw.json

Проверка безопасности и аудит

Вы можете запустить встроенные команды для проверки того, что ваш бот и сервер защищены правильно. Команда doctor проверит общую конфигурацию и подскажет, если что-то сломалось, а security audit просканирует права доступа к файлам и укажет на потенциальные уязвимости (например, если кто-то другой может прочитать ваши ключи):

openclaw doctor
openclaw security audit

Свяжем бота с Телеграм. Напишите команду /start в диалог с вашим ботом. Поскольку мы указали токен бота на 5 шаге в Wizard-настройке, бот отреагирует и выдаст секретный код (pairing code). Введите его в терминале на сервере для подтверждения ваших прав администратора над этим ботом (бот проверяет, что вы имеете доступ к серверу):

openclaw pairing approve telegram ВАШ_КОД_ИЗ_ТГ

Как открыть OpenCLAW Dashboard с вашего компьютера

Команда на сервере:

openclaw dashboard

показывает локальную ссылку вида: http://127.0.0.1:18789/

Это адрес внутри сервера, поэтому напрямую в браузере на вашем компьютере он не откроется.

Чтобы открыть Dashboard, на вашем компьютере в новом окне PowerShell или Terminal выполните SSH-туннель:

ssh -N -L 18889:127.0.0.1:18789 root@ВАШ_IP_СЕРВЕРА

После ввода пароля оставьте это окно открытым. Затем откройте в браузере:

http://localhost:18889/