> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Визуальный инструмент для развёртывания и управления шлюзами AI-ботов OpenClaw одним кликом, поддерживает платформы Telegram, Feishu и Discord, работает на базе GPT-5, Claude, Gemini и других AI-моделей через API APIMart.

## Введение

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

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

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

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

1. **Получен API-ключ APIMart**
   Войдите в [консоль APIMart](https://apimart.ai/keys), чтобы получить API-ключ (начинается с `sk-`)

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

<Note>
  **Совет:** если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на [APIMart](https://apimart.ai) и получите API-ключ.
</Note>

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

Загрузите исполняемый файл для вашей платформы со страницы [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-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. Запуск

<Tabs>
  <Tab title="Windows">
    ### Развёртывание на Windows

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

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

    #### Запуск

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

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

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

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

  <Tab title="Linux">
    ### Развёртывание на Linux

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

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

    #### Запуск

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

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

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

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

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

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

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

    ```bash theme={null}
    # Запуск в фоновом режиме
    ./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
    ```

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

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

    ```bash theme={null}
    # Web UI Manager
    ufw allow 51942/tcp

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

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

  <Tab title="macOS">
    ### Развёртывание на macOS

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

    * macOS 12+ (Apple Silicon или Intel)

    #### Запуск

    1. Распакуйте загруженный zip-файл, чтобы получить `OpenClaw Manager.app`

    2. Дважды щёлкните для запуска `OpenClaw Manager.app`

    3. При первом запуске могут потребоваться настройки безопасности:

    ```
    System Settings → Privacy & Security → Allow Anyway
    ```

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

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

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

```
http://127.0.0.1:51942
```

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

## Шаг 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 | Высокая производительность |

<Tip>
  **Рекомендации по моделям:**

  * 💰 **Выгодно по цене:** `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`
</Tip>

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

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

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

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/ru/integrations/platform/openclaw-manager-telegram">
    Создание Telegram-бота через BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/ru/integrations/platform/openclaw-manager-feishu">
    Создание корпоративного бота Feishu
  </Card>

  <Card title="Discord" icon="discord" href="/ru/integrations/platform/openclaw-manager-discord">
    Создание Discord-бота для сервера
  </Card>
</CardGroup>

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

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

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

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

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

В 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 не отвечает?

**Решения:**

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

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

**Решения:**

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

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

Войдите в [консоль APIMart](https://apimart.ai/overview), чтобы посмотреть:

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

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

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

* 📚 [Документация APIMart](https://docs.apimart.ai)
* 📚 [OpenClaw Manager на GitHub](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Сообщество в Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Техническая поддержка: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Начните работу с APIMart" icon="rocket" href="https://apimart.ai">
  Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и разверните вашего AI-бота!
</Card>