Как установить Clawdbot на VPS

Clawdbot — это open-source, самостоятельно размещаемый персональный AI-ассистент, который подключается к вашим любимым мессенджерам. В отличие от облачных AI-ассистентов, таких как ChatGPT, Clawdbot полностью работает на вашей инфраструктуре, предоставляя полный контроль над вашими данными и конфиденциальностью. В этой статье мы проведём вас через процесс установки Clawdbot на VPS с использованием Node.js. Мы рекомендуем использовать LightNode в качестве провайдера VPS.

Что такое Clawdbot?

Clawdbot — мощный персональный AI-ассистент, который живёт внутри ваших любимых приложений и мессенджеров. Он подключается к WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat и другим, превращая большие языковые модели в по-настоящему персонального, всегда доступного помощника. Основные возможности:

• Поддержка множества платформ: работает более чем с 10 мессенджерами
• Постоянная память: запоминает ваши предпочтения и прошлые разговоры со временем
• Проактивные действия: может выполнять задачи, ставить напоминания и отправлять уведомления
• Самостоятельный хостинг: полный контроль над данными и конфиденциальностью
• Настраиваемость: расширяется с помощью навыков и инструментов
• Всегда онлайн: работает 24/7 на вашем VPS или локальной машине

Требования

Перед началом убедитесь, что у вас есть:

1. VPS-сервер: Вы можете выбрать из различных облачных провайдеров. Мы рекомендуем LightNode за отличную производительность и глобальное покрытие.
2. Базовые знания командной строки: умение работать с терминалом будет полезно.
3. Установленный Node.js: убедитесь, что на сервере установлен Node.js версии 22 или выше.
4. Минимальные системные требования: 2 ГБ ОЗУ, 1 vCPU, 10 ГБ дискового пространства (рекомендуется 4 ГБ ОЗУ для продакшена).

Почему мы рекомендуем LightNode VPS

LightNode — отличный выбор для хостинга Clawdbot по нескольким причинам:

Основные преимущества LightNode

• Доступные цены: тарифы начинаются от 7,71 $/месяц с почасовой оплатой, что позволяет тестировать без долгосрочных обязательств.
• Более 40 локаций по всему миру: дата-центры на 6 континентах, включая США, Европу, Азию, Ближний Восток и Африку, обеспечивают низкую задержку для пользователей по всему миру.
• Высокая производительность: NVMe SSD и процессоры с высокой частотой обеспечивают отличную производительность для AI-задач.
• Гарантия доступности 99,95%: надёжная инфраструктура с локальным BGP-доступом гарантирует, что ваш ассистент всегда онлайн.
• Гибкая оплата: платите только за фактическое использование с почасовой тарификацией — идеально для тестирования и масштабирования.
• Дружелюбно к разработчикам: полный root-доступ, мгновенное развертывание, поддержка Linux и Windows.
• Бесплатные снимки: один бесплатный снимок VPS для удобного резервного копирования и восстановления.
• Бонус для новых пользователей: получите до 15 $ бесплатных кредитов при первом пополнении.

Рекомендуемая конфигурация LightNode для Clawdbot

Эта конфигурация обеспечивает достаточные ресурсы для работы Clawdbot и оставляет запас для роста при увеличении нагрузки.

Начать с LightNode

Шаг 1: Настройка VPS

1. Запуск инстанса: Войдите в LightNode и создайте новый VPS. Рекомендуется выбрать локацию, близкую к вашим основным пользователям для оптимальной задержки. Для глобального доступа Сингапур или Гонконг отлично подойдут для азиатских пользователей, а Силиконовая долина — для североамериканских.

2. Выбор ОС: Выберите Ubuntu 22.04 LTS (рекомендуется) или Ubuntu 24.04. Эти версии отлично поддерживают Node.js и широко протестированы.

3. Доступ по SSH: Используйте SSH-клиент для подключения к серверу:

   ssh username@your_server_ip
   

Шаг 2: Установка Node.js

Clawdbot требует Node.js версии 22 или выше. Вот как установить его на Ubuntu:

# Обновить списки пакетов
sudo apt update

# Установить Node.js 22 из репозитория NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Проверить установку
node --version
# Должно вывести: v22.x.x

Альтернативно, можно использовать NVM (Node Version Manager) для большей гибкости:

# Установить NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Установить Node.js 22
nvm install 22
nvm use 22

# Проверить установку
node --version

Шаг 3: Установка Clawdbot

Доступно несколько способов установки. Выберите подходящий.

Метод 1: Официальный скрипт установки (рекомендуется для новичков)

Скрипт установки — самый простой способ, автоматически устанавливает зависимости:

# Скачать и запустить установщик
curl -fsSL https://clawd.bot/install.sh | bash

Эта команда:

• Определит вашу ОС
• Проверит наличие Node.js 22+
• Установит Clawdbot глобально через npm
• Настроит необходимые пути
• Запустит проверку установки (doctor)

Метод 2: Глобальная установка через npm

Для пользователей, знакомых с npm:

# Установить Clawdbot глобально
npm install -g clawdbot@latest

# Или через pnpm (быстрее)
pnpm add -g clawdbot@latest

# Проверить установку
clawdbot --version

Метод 3: Установка из исходников (для разработчиков)

# Клонировать репозиторий
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Установить зависимости
pnpm install

# Собрать UI
pnpm ui:build

# Собрать проект
pnpm build

# Запустить мастер настройки
./dist/entry.js onboard --install-daemon

Метод 4: Установка через Docker (опционально)

Для контейнерного развертывания:

# Клонировать репозиторий
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Запустить скрипт настройки Docker
./docker-setup.sh

Шаг 4: Запуск мастера настройки

После установки запустите мастер настройки Clawdbot:

# Запустить интерактивный мастер настройки
clawdbot onboard --install-daemon

Мастер проведёт вас через:

1. Настройку шлюза: выберите локальный или удалённый режим шлюза и настройте порт (по умолчанию: 18789).
2. Настройку аутентификации: настройте провайдера AI-модели.
   • Anthropic (Claude): API-ключ или OAuth (рекомендуется)
   • OpenAI (ChatGPT/Codex): API-ключ
   • Другие провайдеры: пользовательские эндпоинты и ключи API
3. Настройку каналов: подключите мессенджеры:
   • WhatsApp: вход через QR-код
   • Telegram: токен бота от @BotFather
   • Discord: токен бота из Discord Developer Portal
   • Slack: OAuth или токен бота
4. Установку сервиса: установите Gateway как фоновый сервис (systemd на Linux).
5. Идентичность агента: настройте личность и поведение ассистента по умолчанию.

Шаг 5: Запуск шлюза

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

# Проверить статус шлюза
clawdbot gateway status

# Просмотреть логи
clawdbot logs --follow

# Проверить состояние
clawdbot health

Ручной запуск (если сервис не запущен)

# Запустить шлюз в форграунд режиме
clawdbot gateway --port 18789 --verbose

Управление сервисом

# Запустить сервис
systemctl --user start clawdbot-gateway.service

# Остановить сервис
systemctl --user stop clawdbot-gateway.service

# Перезапустить сервис
systemctl --user restart clawdbot-gateway.service

# Включить автозапуск при старте системы
systemctl --user enable clawdbot-gateway.service

# Просмотреть логи сервиса
journalctl --user -u clawdbot-gateway -f

Шаг 6: Доступ к панели управления

UI управления Clawdbot доступен через браузер:

http://your_server_ip:18789/

Если вы настроили аутентификацию в мастере, для доступа потребуется токен шлюза.

Удалённый доступ через SSH-туннель

Для безопасного удалённого доступа:

# Настроить SSH-туннель с локальной машины
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Затем открыть локально
http://localhost:18789/

Шаг 7: Подключение первого канала

WhatsApp

Чтобы подключить WhatsApp:

# Сгенерировать и показать QR-код
clawdbot channels login

# Отсканируйте в WhatsApp:
# Настройки → Связанные устройства → Связать устройство

После сканирования WhatsApp подключится к Clawdbot.

Telegram

1. Создайте бота, написав @BotFather в Telegram
2. Следуйте инструкциям для создания нового бота
3. Скопируйте предоставленный токен бота
4. Добавьте бота в Clawdbot:

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. Перейдите в Discord Developer Portal
2. Создайте новое приложение
3. Включите бота во вкладке «Bot»
4. Скопируйте токен бота
5. Пригласите бота на ваш сервер Discord с нужными правами
6. Добавьте в Clawdbot:

clawdbot channels add --channel discord --token "your_discord_bot_token"

Шаг 8: Настройка безопасности личных сообщений (DM Safety)

По умолчанию Clawdbot использует режим спаривания для личных сообщений: неизвестные отправители получают код спаривания, и их сообщения не обрабатываются до одобрения.

# Просмотреть ожидающие запросы на спаривание
clawdbot pairing list whatsapp

# Одобрить запрос на спаривание
clawdbot pairing approve whatsapp <pairing_code>

# Просмотреть одобренные спаривания
clawdbot pairing list whatsapp --approved

Это поведение можно изменить в конфигурационном файле ~/.clawdbot/clawdbot.json.

Шаг 9: Тестирование настройки

Отправьте тестовое сообщение, чтобы проверить работу:

# Отправить тестовое сообщение
clawdbot message send --to +15555550123 --message "Привет от Clawdbot!"

# Или тест через Telegram
clawdbot message send --to @your_telegram_username --message "Привет!"

Или просто отправьте сообщение в ваш подключённый WhatsApp/Telegram/Discord — ваш Clawdbot должен ответить.

Шаг 10: Настройка Nginx (опционально)

Для продакшена рекомендуем настроить обратный прокси через Nginx для повышения безопасности и управления SSL-сертификатами.

Установка Nginx

sudo apt install -y nginx

Конфигурация Nginx

Отредактируйте конфигурационный файл:

sudo nano /etc/nginx/sites-available/clawdbot

Добавьте следующий конфиг:

server {
    listen 80;
    server_name your-domain.com;  # Замените на ваш домен

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Включение конфигурации

# Создать символическую ссылку
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Проверить конфигурацию Nginx
sudo nginx -t

# Перезапустить Nginx
sudo systemctl restart nginx

Добавление SSL с помощью Certbot (рекомендуется)

# Установить Certbot
sudo apt install -y certbot python3-certbot-nginx

# Получить SSL-сертификат
sudo certbot --nginx -d your-domain.com

# Certbot автоматически настроит Nginx с SSL

После этого Clawdbot будет доступен по адресу:

https://your-domain.com/

Устранение распространённых проблем

Шлюз не запускается

Если шлюз не запускается:

# Проверить ошибки конфигурации
clawdbot doctor

# Просмотреть подробные логи
journalctl --user -u clawdbot-gateway -n 50

Ошибки из-за нехватки памяти

На VPS с 2 ГБ ОЗУ могут возникать ошибки из-за нехватки памяти при обновлениях. Добавьте swap-файл:

# Создать swap-файл размером 2 ГБ
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Сделать swap постоянным
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Порт уже занят

Если порт 18789 уже используется:

# Узнать, что занимает порт
sudo lsof -i :18789

# Или использовать другой порт
clawdbot gateway --port 18889

Бот не отвечает

Если бот не отвечает:

1. Проверьте статус шлюза: clawdbot gateway status
2. Проверьте конфигурацию каналов: убедитесь, что токены верны и каналы активны
3. Проверьте аутентификацию: убедитесь, что API-ключи действительны
4. Просмотрите логи: clawdbot logs --follow для поиска ошибок

Обновление Clawdbot

Чтобы обновить до последней версии:

# Запустить установщик заново
curl -fsSL https://clawd.bot/install.sh | bash

# Или обновить через npm
npm update -g clawdbot@latest

# Перезапустить шлюз
clawdbot gateway restart

# Проверить состояние
clawdbot health

Заключение

Установка Clawdbot на VPS — простой процесс, который даёт вам мощного, самостоятельно размещаемого AI-ассистента, доступного в нескольких мессенджерах. Благодаря доступным тарифам LightNode, глобальному покрытию и высокопроизводительной инфраструктуре вы можете с уверенностью развернуть своего персонального AI-ассистента.

Следуя этому руководству, вы сможете запустить Clawdbot на VPS примерно за 20-30 минут, получив всегда доступного AI-компаньона, который уважает вашу приватность и даёт полный контроль над данными.

Для дальнейшей настройки и расширенных функций обращайтесь к официальной документации на странице Clawdbot на GitHub и изучайте обсуждения сообщества для дополнительных советов и идей.

Дополнительные ресурсы

• Официальная документация Clawdbot
• Репозиторий Clawdbot на GitHub
• LightNode VPS — рекомендуемый провайдер VPS
• Сообщество Clawdbot в Discord
• Маркетплейс навыков — расширьте вашего ассистента дополнительными навыками