ClawPort Центр управления
🚀
Начало работы
Установка, требования, переменные окружения

Начало работы

Это руководство поможет вам запустить ClawPort с вашим собственным экземпляром OpenClaw. ClawPort -- это панель управления на базе Next.js 16 для управления, мониторинга и прямого общения с вашими AI-агентами OpenClaw.

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

  • Node.js 22+ -- проверьте командой node -v
  • OpenClaw -- установлен и работает: openclaw --version
  • Запущен шлюз OpenClaw -- ClawPort взаимодействует со шлюзом по адресу localhost:18789 по умолчанию (настраивается через OPENCLAW_GATEWAY_PORT)

Быстрый старт (npm)

Примечание
npm-пакет называется clawport-ui. Команда CLI -- clawport. Не устанавливайте несвязанный пакет clawport.
terminal
# Установить глобально (пакет: clawport-ui, команда: clawport)
npm install -g clawport-ui

# Запустить мастер настройки (автоопределение конфигурации OpenClaw)
clawport setup

# Запустить сервер разработки
clawport dev
Внимание
Если вы получаете ошибку EACCES: permission denied или EEXIST при установке, у вашего кеша npm повреждены права доступа (обычно из-за предыдущего sudo npm install). Исправьте командой: sudo chown -R $(whoami) ~/.npm, затем повторите. Подробности в разделе «Устранение неполадок».

Быстрый старт (из исходников)

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

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

# Автоопределение конфигурации OpenClaw и запись .env.local
npm run setup

# Запустить сервер разработки
npm run dev

Откройте http://localhost:3000. При первом запуске появится мастер начальной настройки, который проведёт вас через именование портала, выбор темы и персонализацию аватаров агентов.

Переменные окружения

Самый быстрый способ настройки -- скрипт автоматической конфигурации: npm run setup. Он автоматически определяет WORKSPACE_PATH, OPENCLAW_BIN и токен шлюза из вашей локальной установки OpenClaw.

Для ручной настройки скопируйте шаблон и отредактируйте:

cp .env.example .env.local
ПеременнаяОбязательноОписание
WORKSPACE_PATHДаПуть к каталогу рабочего пространства OpenClaw (по умолчанию: ~/.openclaw/workspace)
OPENCLAW_BINДаАбсолютный путь к исполняемому файлу openclaw CLI
OPENCLAW_GATEWAY_TOKENДаТокен для аутентификации всех API-вызовов к шлюзу
ELEVENLABS_API_KEYНетAPI-ключ ElevenLabs для голосовых индикаторов в профилях агентов
Совет
Отдельные API-ключи для AI не нужны. Все AI-вызовы (чат, распознавание изображений, TTS, транскрипция) проходят через шлюз OpenClaw. Одна подписка, один токен.

Как найти значения

  1. WORKSPACE_PATH: Выполните ls ~/.openclaw/workspace для проверки. Вы должны увидеть файлы вроде SOUL.md, каталог agents/ и каталог memory/.
  2. OPENCLAW_BIN: Выполните which openclaw и используйте полный путь.
  3. OPENCLAW_GATEWAY_TOKEN: Выполните openclaw gateway status, чтобы увидеть конфигурацию шлюза, включая токен.

Запуск шлюза

ClawPort ожидает работающий шлюз OpenClaw по адресу localhost:18789 (или вашему пользовательскому порту). Запустите его в отдельном терминале:

openclaw gateway run
Внимание
HTTP-эндпоинт чат-завершений шлюза отключён по умолчанию. Команда clawport setup обнаружит это и предложит включить его автоматически. Если чат возвращает ошибку 405, смотрите раздел «Устранение неполадок».

Первоначальная настройка

При первом посещении ClawPort запускает мастер начальной настройки (5 шагов):

  1. Именование портала -- задайте собственное название и подзаголовок вашему командному центру
  2. Выбор темы -- выберите из Dark, Glass, Color, Light или System
  3. Установка цвета акцента -- персонализируйте цвет выделения интерфейса
  4. Голосовой чат -- опциональная проверка разрешения микрофона
  5. Обзор -- краткое описание функций всех страниц

Все эти настройки можно изменить позже на странице настроек.

Продакшн-сборка

terminal
npx next build
npm start

Продакшн-сервер работает на порту 3000 по умолчанию. Шлюз по-прежнему должен быть запущен.