Настройка OpenClaw

Это руководство объясняет, как установить и настроить агента OpenClaw на вашем сервере RoqueOS.

---

Предварительные требования

ТРЕБОВАНИЯ

• Установленный и запущенный RoqueOS Server (см. руководство по установке)
• Docker с доступом к сокету (/var/run/docker.sock)
• API ключ от ИИ-провайдера (OpenAI или Anthropic)
• Минимум 4 ГБ ОЗУ (RAM) на сервере (рекомендуется 8 ГБ)

---

1. Загрузка образа OpenClaw

OpenClaw работает как отдельный Docker-контейнер. Скачайте официальный образ:

docker pull roqueribeiro1988/roqueos-openclaw:latest

Образ включает в себя:

• Ubuntu 22.04
• Рабочий стол XFCE
• TigerVNC + noVNC
• Браузер Chromium
• Node.js 20
• Агент OpenClaw

---

2. Настройка API Ключа

В файле docker-compose.yml вашего сервера RoqueOS добавьте переменные окружения для вашего ИИ-ключа:

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Europe/Moscow
      - OPENAI_API_KEY=sk-ваш-ключ-здесь

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Europe/Moscow
      - ANTHROPIC_API_KEY=sk-ant-ваш-ключ-здесь

БЕЗОПАСНОСТЬ

Никогда не коммитьте свои API ключи в публичные репозитории. Используйте файл .env для хранения секретов и ссылайтесь на него с помощью env_file: .env в файле compose.

Пример с файлом .env:

# .env (не коммитить в git!)
OPENAI_API_KEY=sk-ваш-ключ-здесь

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. Проверка настройки

После перезапуска сервера с помощью команды docker compose down && docker compose up -d убедитесь, что модуль агента доступен:

curl http://localhost:27021/agent/sessions

Ожидаемый ответ:

[]

---

4. Доступ к агенту во фронтенде

1. Откройте RoqueOS и убедитесь, что вы подключены к серверу.
2. В Launchpad (Меню приложений) найдите приложение AI Agent (иконка OpenClaw).
3. Приложение откроется с интерфейсом чата и панелью предварительного просмотра рабочего стола.

---

Используемые порты

Порт	Протокол	Описание
27021	HTTP/WS	API и WebSocket сервера RoqueOS
5901	VNC	Desktop VNC контейнера OpenClaw
6080	HTTP	noVNC (веб-доступ к рабочему столу)

Порты 5901 и 6080 управляются сервером внутренне и не требуют открытия для внешнего доступа.

---

Доступные переменные окружения

Переменная	Описание	Значение по умолчанию
OPENAI_API_KEY	API Ключ OpenAI	—
ANTHROPIC_API_KEY	API Ключ Anthropic	—
AGENT_MAX_SESSIONS	Максимальное количество одновременных сессий	3
AGENT_TIMEOUT	Тайм-аут сессии в минутах	30

---

Следующие шаги

• Как использовать OpenClaw — Практическое руководство и примеры