Установка и настройка сервиса OpenClaw

OpenClaw — это инструмент с открытым исходным кодом для создания AI-агентов и приложений на базе LLM. Он также позволяет эффективно управлять такими агентами и приложениями. OpenClaw предоставляет интерфейс для настройки агентов, интеграции внешних инструментов и автоматизации задач.

Возможности OpenClaw:

• AI-агенты: создание умных помощников для анализа данных и взаимодействия с пользователями и внешними сервисами.
• Управление LLM: подключение и контроль моделей для генерации текста, анализа информации и автоматизации процессов.
• Интеграции с внешними сервисами: использование API для расширения функций агентов.
• Автоматизация задач: настройка сценариев, при помощи которых агенты будут самостоятельно выполнять задачи.
• Мониторинг: контроль конфигурации и отслеживание работы агентов.
• Кастомизация: расширение платформы собственными инструментами и плагинами.

Используя сервис OpenClaw, вы соглашаетесь с лицензионными соглашениями Marketplace VK Cloud и OpenClaw.

Чтобы развернуть сервис OpenClaw на ВМ в вашем проекте VK Cloud:

1. Зарегистрируйтесь в VK Cloud и перейдите в личный кабинет.

2. Определите, какой доступ должен быть у сервиса:

   • Внешний — к сервису OpenClaw, развернутому на ВМ, будет доступ из интернета. Может потребоваться настройка сети, если это еще не сделано.
   • Внутренний — сервис OpenClaw будет доступен только из сети проекта VK Cloud по внутреннему IP-адресу. В таком случае настройка внешней сети не потребуется.

3. Если вы хотите иметь доступ к сервису из интернета, дополнительно настройте сеть:

   1. Создайте сеть с доступом в интернет, если это еще не сделано.
   2. В настройках подсети, где будет размещена ВМ, отключите опцию Приватный DNS.

1. В личном кабинете VK Cloud перейдите в раздел Магазин приложений.

2. На карточке сервиса OpenClaw нажмите кнопку Подробнее.

3. На странице с описанием сервиса нажмите кнопку Подключить.

4. На странице Параметры сервера укажите настройки подключения к сервису OpenClaw.

   1. Укажите параметры OpenClaw:

      • Как будет размещен openclaw: выберите тип размещения сервиса.

        • external — с внешним IP-адресом и доменным именем, предоставленным VK Cloud. Так ВМ с развернутым сервисом OpenClaw будет доступна из интернета.
        • internal — с доступом только из сети проекта VK Cloud по внутреннему IP-адресу.

      • Включить резервное копирование на S3: включите опцию, чтобы ежедневно создавать резервные копии данных OpenClaw в объектном хранилище VK Cloud. Хранилище создается автоматически. Сохраняются последние 7 копий.

      • Включить мониторинг: включите опцию, чтобы автоматически отправлять в сервис Cloud Monitoring метрики виртуальной машины, на которой развернут OpenClaw. Эти метрики будут доступны в разделе Мониторинг личного кабинета.

   2. Укажите параметры виртуальной машины, на которой будет развернут инстанс сервиса:

      • Сеть: выберите сеть, где будет размещена ВМ с развернутым сервисом. Если вы указали тип размещения external, выберите ранее настроенную сеть с доступом в интернет и подсеть, для которой отключена опция Приватный DNS.
      • Зона доступности: выберите зону доступности, где будет запущена ВМ.
      • Тип виртуальной машины: выберите предустановленную конфигурацию ВМ в соответствии с вашей нагрузкой. Для пилотных сценариев достаточно минимальной конфигурации.

   3. Укажите параметры системного диска и диска с данными:

      • Размер диска: укажите нужный размер диска ВМ в гигабайтах.
      • Тип диска: выберите один из типов диска — HDD, SSD или High-IOPS SSD.

5. Нажмите кнопку Следующий шаг.

6. Ознакомьтесь со стоимостью инфраструктуры для развертывания сервиса и нажмите кнопку Подключить тариф.

   Начнется развертывание облачной инфраструктуры, и откроется страница свойств сервиса. Статус процесса будет отображаться также в разделе Магазин приложений → Мои сервисы.

   После успешного развертывания на почту, привязанную к вашему аккаунту в VK Cloud, придут сообщения:

   • уведомление со ссылкой на инстанс сервиса в личном кабинете VK Cloud;
   • письмо с одноразовой ссылкой на данные для доступа к сервису.

7. Перейдите по одноразовой ссылке из письма и сохраните данные для доступа к сервису:

   • openclaw_url — адрес веб-интерфейса OpenClaw;
   • openclaw_login_url — адрес веб-интерфейса с токеном доступа, который можно сразу открыть в браузере;
   • openclaw_gateway_token — токен доступа к OpenClaw;
   • os_user — имя системного пользователя для входа по SSH;
   • keypair — приватный ключ для подключения по SSH к виртуальной машине, где развернут сервис.

1. Перейдите в веб-интерфейс сервиса OpenClaw одним из способов:

   • По адресу, указанному в openclaw_login_url.
   • По адресу, указанному в openclaw_url. В этом случае на открывшейся странице в поле Gateway Token ведите значение параметра openclaw_gateway_token и нажмите кнопку Connect.

2. Создайте любой агент или проект в интерфейсе OpenClaw. Подробнее в официальной документации OpenClaw.

3. Укажите учетные данные вашего LLM-провайдера и настройте нужные инструменты для интеграции с внешними сервисами.

4. Запустите тестовую задачу, чтобы убедиться, что агент корректно выполняет сценарий.

1. В веб-интерфейсе сервиса OpenClaw перейдите в раздел Config.

2. Переключитесь в режим Raw и добавьте настройки нужной модели в JSON-конфигурацию, не удаляя существующие параметры.

    
   {  "gateway": {    "mode": "local",    "bind": "lan",    "controlUi": {      "dangerouslyDisableDeviceAuth": true,      "allowedOrigins": [        "http://127.0.0.1:18789",        "http://openclaw-XXXXXXXX.xaas.msk.bizmrg.com"      ]    }  },  "agents": {    "defaults": {      "model": {        "primary": "my-provider/my-model"      }    }  },  "models": {    "mode": "merge",    "providers": {      "my-provider": {        "baseUrl": "https://api.example.com/v1",        "apiKey": "${<API_KEY>}",        "api": "openai-completions",        "models": [          { "id": "my-model", "name": "My Model" }        ]      }    }  }}

   Здесь:

   • allowedOrigins — задает список URL, по которым разрешено подключение. Помимо стандартного http://127.0.0.1:18789 добавьте также значение из openclaw_url.
   • primary — LLM-модель из блока providers, которая будет использоваться по умолчанию. Указывается в формате <НАЗВАНИЕ_ПРОВАЙДЕРА>/<ID_МОДЕЛИ> или просто <ID_МОДЕЛИ>.
   • my-provider — блок с произвольным названием, который описывает параметры вашего провайдера и доступные модели:
     • baseUrl — URL-адрес эндпоинта вашего AI-провайдера. Например, https://api.openai.com/v1.
     • apiKey — API-ключ вашего провайдера для доступа к LLM-модели (если используется).
     • api — протокол, по которому OpenClaw обращается к API провайдера. В большинстве случаев используется openai-completions или openai-chat-completions, поддерживаемые множеством провайдеров.
     • models — массив объектов со значениями:
       • id — идентификатор модели, должен в точности соответствовать значению у AI-провайдера.
       • name — произвольное имя для модели.

   Больше информации в официальной документации OpenClaw.

3. Нажмите кнопку Apply, чтобы сохранить и применить конфигурацию.