Личный кабинет
На сайт
← База знаний

OpenClaw на VPS: личный ИИ-помощник для работы

OpenClaw — среда для ИИ-агента, которая связывает модель с инструментами и диалогами. На отдельном VPS можно попробовать рабочего помощника, не предоставляя ему файлы ноутбука и доступ к корпоративной инфраструктуре. Начнём с приватного помощника с ограниченными инструментами; почта, браузер и команды подключаются отдельно.

Среда: Ubuntu Server 24.04 LTS, x86-64, SSH и учётная запись с sudo. Проверено по документации 15 ноября 2026 года. Команды не проходили сквозное испытание на Ubuntu.

Что подготовить

Для готового образа шлюза с внешним API ориентируйтесь на 2 vCPU, 4 ГБ RAM и 20 ГБ свободного диска. Браузерные задачи потребуют больше. Локальная модель требует дополнительной памяти; подписка и расходы на API не включены в хостинг VPS.

Приведённые ресурсы — ориентир для небольшого теста, а не гарантия производительности или описание тарифов. VPS/VDS не означает наличие GPU. Проверьте память, диск и доступные ресурсы перед заказом.

На чистой Ubuntu установите пакеты ниже. Если Docker уже установлен из другого репозитория, сохраните текущую установку и сначала проверьте совместимость: не смешивайте пакеты Docker CE и docker.io. Нужен Compose v2; при отсутствии пакета проверьте включение репозитория Ubuntu Universe.

sudo apt update
sudo apt install -y docker.io docker-compose-v2 curl openssl
sudo systemctl enable --now docker
sudo docker compose version

Все примеры публикуют порты только на 127.0.0.1 сервера. Для доступа с компьютера используйте SSH-туннель; домен для этого не нужен. Не открывайте эти порты в интернете. Внутренний адрес 0.0.0.0 в контейнере не отменяет привязку опубликованного порта к loopback хоста.

Каждый проект ниже — новая установка. Не повторяйте генерацию секретов поверх уже работающего экземпляра.

1. Подготовьте отдельный проект

Сохраните токен шлюза в закрытом файле окружения. Именованные тома сохраняют состояние и отдельный каталог секретов профилей. Docker socket и домашний каталог пользователя не подключаются. Сохраните конфигурацию в compose.yaml.

umask 077
mkdir -p ~/ai-openclaw
cd ~/ai-openclaw
printf 'OPENCLAW_GATEWAY_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
services:
  gateway:
    image: ghcr.io/openclaw/openclaw:latest
    init: true
    restart: unless-stopped
    env_file: .env
    environment:
      HOME: /home/node
    ports:
      - "127.0.0.1:18789:18789"
    volumes:
      - state:/home/node/.openclaw
      - auth:/home/node/.config/openclaw
    cap_drop: [NET_RAW, NET_ADMIN]
    security_opt: [no-new-privileges:true]
    command: ["node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789"]
volumes:
  state:
  auth:

2. Настройте помощника до запуска шлюза

Запустите интерактивный мастер. Выберите доступного провайдера и модель, введите собственные данные API, сохраните аутентификацию по токену и пока пропустите каналы. Для токена шлюза используйте значение из закрытого .env. Не устанавливайте системную службу внутри контейнера. Затем ограничьте инструменты и разрешите только два локальных адреса браузера для SSH-туннеля.

sudo docker compose pull
sudo docker compose run --rm --no-deps --entrypoint node gateway dist/index.js onboard --mode local --no-install-daemon
sudo docker compose run --rm --no-deps --entrypoint node gateway dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789"]},{"path":"tools.profile","value":"minimal"}]'
sudo docker compose up -d gateway
sudo docker compose exec gateway node dist/index.js security audit --deep

3. Подключитесь и проверьте простую задачу

На своём компьютере замените YOUR_USER и YOUR_SERVER_IP и оставьте SSH-сеанс открытым. Откройте http://127.0.0.1:18789, введите токен шлюза и при запросе сопряжения подтвердите только своё устройство. Попросите кратко изложить тестовый текст без конфиденциальных данных. Ответ модели проверяет чат, но не разрешает выполнение команд.

ssh -N -L 127.0.0.1:18789:127.0.0.1:18789 YOUR_USER@YOUR_SERVER_IP

4. Подключайте рабочие интеграции осознанно

Профиль minimal намеренно ограничен: изучите аудит перед добавлением нужной возможности. Используйте отдельные ключи с узкими правами и подтверждение значимых действий. Текст из писем и сайтов не должен задавать разрешения. Сам контейнер не является песочницей для агента. Не подключайте Docker socket ради удобства. Сохраняйте оба именованных тома и .env: для восстановления нужны и состояние авторизации, и его ключи.

Обновления и восстановление

Перед обновлением остановите приложение на время согласованного резервного копирования, сохраните данные и секреты за пределами VPS и проверьте восстановление на отдельном экземпляре. Изменяемые теги образов в примерах нужны для первоначальной оценки; перед постоянной эксплуатацией зафиксируйте проверенный тег выпуска или digest. Запишите текущий digest командой sudo docker image inspect ИМЯ_ОБРАЗА --format '{{json .RepoDigests}}'. Не запускайте автоматические обновления без проверки совместимости и не удаляйте тома командой down -v.

Если приложение не запускается, проверьте sudo docker compose ps, последние журналы, свободное место и память. Не публикуйте журналы с ключами, содержимым запросов или персональными данными. При ошибке доступа к каталогу проверьте UID/GID и владельца, а не назначайте права 777. Для совместного доступа сначала настройте HTTPS, аутентификацию и ограничения запросов.

Другие сценарии