Руководство по развёртыванию OpenClaw Manager

Введение

OpenClaw Manager — кроссплатформенный визуальный инструмент управления, который помогает быстро развернуть и управлять шлюзами AI-ботов OpenClaw.

Развёртывание без настройки — единый исполняемый файл, автоматически устанавливает все зависимости
Веб-интерфейс управления — создание, запуск/остановка, удаление экземпляров и переключение моделей через браузер
Поддержка нескольких каналов — Telegram / Feishu / Discord
Поддержка нескольких моделей — серии GPT-5, Claude 4.5/4.6, Gemini с автоматическим переключением при сбое
Фоновый режим — поддерживает режим --daemon, не зависит от разрыва SSH-соединения
Многоязычный UI — китайский / английский / японский

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

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

Получен API-ключ APIMart Войдите в консоль APIMart, чтобы получить API-ключ (начинается с sk-)
Создан бот платформы обмена сообщениями Подготовьте учётные данные бота на основе платформы, которую вы хотите использовать (см. раздел настройки каналов ниже)

Совет: если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на APIMart и получите API-ключ.

Шаг 1. Загрузка

Загрузите исполняемый файл для вашей платформы со страницы GitHub Releases:

Платформа	Имя файла
Windows x64	`openclaw-manager-win-x64.exe`
macOS ARM (Apple Silicon)	`openclaw-manager-macos-arm64.zip`
macOS Intel	`openclaw-manager-macos-x64.zip`
Linux x64	`openclaw-manager-linux-x64`
Linux ARM64	`openclaw-manager-linux-arm64`

Шаг 2. Запуск

Windows
Linux
macOS

Развёртывание на Windows

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

Windows 10/11 (64-bit)
Права администратора (требуются для создания запланированных задач Windows для управления Gateway)

Запуск

Правый клик по openclaw-manager-win-x64.exe → Запустить от имени администратора

При первом запуске автоматически будут выполнены:

Проверка и установка Node.js v22 (автоматическая загрузка MSI и тихая установка при отсутствии)
Установка OpenClaw CLI (через npm install -g openclaw)
Автоматическое открытие браузера на странице UI управления

Необходимо запускать от имени администратора, иначе невозможно будет создать запланированные задачи Windows для управления процессами Gateway.

Развёртывание на Linux

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

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 или ARM64)
Права root (рекомендуется)

Запуск

Загрузите и выдайте права на выполнение:

chmod +x ./openclaw-manager-linux-x64

Режим переднего плана (для тестирования):

./openclaw-manager-linux-x64

Фоновый режим (рекомендуется для production):

./openclaw-manager-linux-x64 --daemon

Управление daemon

# Запуск в фоновом режиме
./openclaw-manager-linux-x64 --daemon
# Или сокращённая форма
./openclaw-manager-linux-x64 -d

# Проверка статуса
./openclaw-manager-linux-x64 --status

# Остановка
./openclaw-manager-linux-x64 --stop
# Или сокращённая форма
./openclaw-manager-linux-x64 -s

Настройка брандмауэра

Если требуется удалённый доступ, откройте следующие порты:

# Web UI Manager
ufw allow 51942/tcp

# Порты Gateway (по одному на экземпляр, начиная с 18789)
ufw allow 18789/tcp

Совет: на Linux Manager автоматически привязывается к 0.0.0.0, позволяя удалённый доступ. Файл логов находится в ~/openclaw-manager.log.

Развёртывание на macOS

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

macOS 12+ (Apple Silicon или Intel)

Запуск

Распакуйте загруженный zip-файл, чтобы получить OpenClaw Manager.app
Дважды щёлкните для запуска OpenClaw Manager.app
При первом запуске могут потребоваться настройки безопасности:

System Settings → Privacy & Security → Allow Anyway

Совет: на macOS Manager привязывается к 127.0.0.1 (только локальный доступ). Команды daemon такие же, как на Linux.

Шаг 3. Доступ к UI управления

После запуска программы получите доступ к Web UI управления:

http://127.0.0.1:51942

Удалённый доступ на Linux: замените 127.0.0.1 на IP-адрес вашего сервера, например http://your-server-ip:51942

Шаг 4. Создание экземпляра

В Web UI управления нажмите + New Instance, чтобы начать:

4.1 Задание названия экземпляра

Введите название экземпляра (только буквы, цифры, нижние подчёркивания и дефисы, от 1 до 64 символов).

4.2 Выбор AI-модели

Выберите AI-модель для использования и введите ваш API Key APIMart (начинается с sk-). Поддерживаемые модели:

ID модели	Название	Особенности
`gpt-5`	GPT-5	Самая новая и мощная
`gpt-5.1`	GPT-5.1	Улучшенная версия
`gpt-5.2-codex`	GPT-5.2 Codex	Специализирована для кода
`gpt-5.2-pro`	GPT-5.2 Pro	Профессиональная версия
`claude-opus-4-6-20260320`	Claude Opus 4.6	Сильнейшие рассуждения
`claude-sonnet-4-6-20260320`	Claude Sonnet 4.6	Сбалансированный выбор
`claude-opus-4-5-20251101`	Claude Opus 4.5	Продвинутые рассуждения
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	Превосходна для кода
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	Быстрый ответ
`gemini-2.5-flash`	Gemini 2.5 Flash	Быстрая мультимодальная
`gemini-3-pro-preview`	Gemini 3 Pro Preview	Высокая производительность

Рекомендации по моделям:

💰 Выгодно по цене: claude-haiku-4-5-20251001, gemini-2.5-flash
🚀 Высокая производительность: gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
⚡ Быстрый ответ: gemini-2.5-flash, claude-haiku-4-5-20251001

Вы также можете выбрать режим failover, чтобы добавить несколько резервных моделей. Когда основная модель недоступна, система автоматически переключается на резервные.

4.3 Настройка канала обмена сообщениями

Выберите вашу платформу обмена сообщениями и следуйте соответствующему руководству:

Создание Telegram-бота через BotFather

Feishu

Создание корпоративного бота Feishu

Discord

Создание Discord-бота для сервера

Шаг 5. Привязка через код сопряжения

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

Пользователь отправляет любое сообщение боту на платформе обмена сообщениями
Бот отвечает 8-значным кодом сопряжения (например, DFE62DTD)
Администратор нажимает кнопку «Pairing Code» для этого экземпляра в Web UI
Введите код сопряжения и нажмите «Approve»
Пользователь теперь может нормально использовать бота

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

Управление экземплярами

В UI управления вы можете выполнять следующие операции:

Действие	Описание
Запуск	Запуск процесса Gateway, бот начинает принимать сообщения
Остановка	Остановка процесса Gateway
Переключение модели	Переключение AI-модели в реальном времени без перезапуска Gateway
Код сопряжения	Одобрение кодов сопряжения новых пользователей для авторизации использования бота
Удаление	Остановка и удаление экземпляра со всеми данными (необратимо)

Порты и данные

Порты

Назначение	Порт	Адрес привязки
Web UI Manager	`51942`	Windows/macOS: `127.0.0.1`, Linux: `0.0.0.0`
Экземпляр Gateway	Начиная с `18789`	Каждый экземпляр получает уникальный порт

Каталоги данных

Содержимое	Путь
Конфигурация экземпляра	`~/.openclaw-<instance-name>/openclaw.json`
Логи Gateway	`~/.openclaw-<instance-name>/logs/gateway.log`
Логи Manager	`~/openclaw-manager.log` (режим daemon)
PID Manager	`~/.openclaw-manager.pid`

Часто задаваемые вопросы

В1. Manager не запускается?

Решения:

Платформа	Проверка
Windows	Убедитесь, что запущено от имени администратора
Linux	Убедитесь, что порт 51942 не занят (`lsof -i :51942`)
macOS	Убедитесь, что настройки безопасности разрешают запуск или снят карантин
Все	Проверьте логи в `~/openclaw-manager.log`

В2. Команда openclaw не найдена?

Решения:

Программа автоматически определяет и устанавливает openclaw CLI при запуске
Если версия слишком старая (< 0.1.0), она автоматически обновится
Ручная установка: npm install -g openclaw@latest

В3. Экземпляр показывает «stopped» после запуска?

Решения:

Gateway занимает несколько секунд для привязки порта, статус может временно выглядеть несогласованным
Обновите страницу, чтобы проверить актуальный статус
Проверьте логи Gateway: ~/.openclaw-<instance-name>/logs/gateway.log

В4. Бот Feishu не отвечает?

Решения:

Убедитесь, что в подписке на события добавлено im.message.receive_v1
Убедитесь, что способ подписки — «Long Connection»
Убедитесь, что создана и опубликована новая версия (требуется после каждого изменения прав/событий)

В5. Не удалось одобрить код сопряжения?

Решения:

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

В6. Как просмотреть использование API и затраты?

Войдите в консоль APIMart, чтобы посмотреть:

📊 Статистику вызовов API
💰 Детали затрат
📈 Графики тенденций использования

Поддержка и помощь

Если у вас возникли проблемы:

📚 Документация APIMart
📚 OpenClaw Manager на GitHub
💬 Сообщество в Discord
🐦 Twitter @APIMart_
📧 Техническая поддержка: zhihong@apimart.ai

Начните работу с APIMart

Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и разверните вашего AI-бота!

​Введение

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

​Шаг 1. Загрузка

​Шаг 2. Запуск

​Развёртывание на Windows

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

​Запуск

​Развёртывание на Linux

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

​Запуск

​Управление daemon

​Настройка брандмауэра

​Развёртывание на macOS

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

​Запуск

​Шаг 3. Доступ к UI управления

​Шаг 4. Создание экземпляра

​4.1 Задание названия экземпляра

​4.2 Выбор AI-модели

​4.3 Настройка канала обмена сообщениями

Telegram

Feishu

Discord

​Шаг 5. Привязка через код сопряжения

​Управление экземплярами

​Порты и данные

​Порты

​Каталоги данных

​Часто задаваемые вопросы

​В1. Manager не запускается?

​В2. Команда openclaw не найдена?

​В3. Экземпляр показывает «stopped» после запуска?

​В4. Бот Feishu не отвечает?

​В5. Не удалось одобрить код сопряжения?

​В6. Как просмотреть использование API и затраты?

​Поддержка и помощь

Начните работу с APIMart

Введение

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

Шаг 1. Загрузка

Шаг 2. Запуск

Развёртывание на Windows

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

Запуск

Развёртывание на Linux

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

Запуск

Управление daemon

Настройка брандмауэра

Развёртывание на macOS

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

Запуск

Шаг 3. Доступ к UI управления

Шаг 4. Создание экземпляра

4.1 Задание названия экземпляра

4.2 Выбор AI-модели

4.3 Настройка канала обмена сообщениями

Шаг 5. Привязка через код сопряжения

Управление экземплярами

Порты и данные

Порты

Каталоги данных

Часто задаваемые вопросы

В1. Manager не запускается?

В2. Команда openclaw не найдена?

В3. Экземпляр показывает «stopped» после запуска?

В4. Бот Feishu не отвечает?

В5. Не удалось одобрить код сопряжения?

В6. Как просмотреть использование API и затраты?

Поддержка и помощь