---
title: Быстрый старт
description: Установите Klex и запустите своего первого бота Klex.
---

## Установка

Боты Klex являются самохостируемыми. Это означает, что вам нужно загрузить приложение Klex на машину, которая впоследствии будет действовать как хранилище памяти и среда выполнения для бота.

<Panel title="Полезно знать">
Бот **не** имеет автоматического доступа к файлам в вашей системе. Вместо этого хост выступает лишь как место, где происходит мышление бота, а также хранение и поиск памяти.

Любое взаимодействие с внешним миром, включая песочницы или полные машины для **использования компьютера** или разработки, явно требует подключения компьютера через MCP.
</Panel>

Чтобы установить Klex, выполните следующий скрипт в оболочке вашей системы：

**macOS**

`curl -fsSL https://klex.bot/install.sh | sh`

**Linux**

`curl -fsSL https://klex.bot/install.sh | sh`

**Windows**

`irm https://klex.bot/install.ps1 | iex`

**WSL**

`curl -fsSL https://klex.bot/install.sh | sh`

## Создание вашего бота

**С помощью облака (рекомендуется)**

1. **Зарегистрируйтесь в Klex Cloud**

    Перейдите на [Klex Cloud](https://cloud.klex.bot) и зарегистрируйтесь. На левой боковой панели выберите панель Bots и нажмите `Set up a Klex Bot`.

2. **Запустите Klex**

    Следуйте руководству в мастере, чтобы установить и запустить приложение Klex.

3. **Создайте нового бота**

    В приложении Klex выберите `Create a new Bot` в списке опций и нажмите Enter.

4. **Назовите вашего бота**

    Введите имя, которое этот бот должен использовать. Бот будет знать, что это его собственное имя.

5. **Зарегистрируйте бота в облаке**

    Следуйте инструкциям в мастере облака, чтобы подключить этого бота к вашей организации Klex Cloud.

6. **Настройте поставщиков моделей и выбор моделей**

    Мастер облака теперь предложит вам настроить поставщиков моделей и модели, которые бот должен использовать.
    <Panel title="Полезно знать">
      Учётные данные поставщика безопасно передаются и хранятся в собственной конфигурации бота на машине, которая хостит бота, **не** в облаке.
    </Panel>
    <Panel title="Полезно знать">
    Klex поддерживает различные подписки, поставщиков первой стороны, локальных LLM-поставщиков и универсальных API-поставщиков.

    Узнайте больше о [поставщиках моделей](/concepts/model-providers) и [выборе моделей](/concepts/model-selection)。
    </Panel>

7. **Дайте боту его душу**

    На следующем шаге мастер попросит вас создать душу бота. У вас есть два варианта：[Режим Создателя](/concepts/soul#creator-mode) (*рекомендуется!*) и [Режим Год-сообщений](/concepts/soul#god-message-mode)。

    [Узнайте больше о душе](/concepts/soul)。

8. **Подключите MCP**

    Дайте боту доступ к MCP. **Klex Cloud** помогает вам легко создавать выделенные аккаунты для бота в каждом интегрированном приложении, но вы, конечно, можете подключить любой другой MCP.

**Автономный**

<Panel title="Важно">
Если вы хотите использовать ботов Klex без Klex Cloud, вам необходимо убедиться, что хотя бы один подключённый MCP может проактивно инициировать бота.
Это означает, что MCP **должен** реализовать **одно из следующего**：

- Разговоры как отдельные MCP-ресурсы с уведомлениями об изменениях
- Push-уведомления согласно нашему [расширению MCP](https://github.com/stagewise-io/klex/tree/main/packages/mcp-extension-push-notifications)
</Panel>

1. **Запустите Klex**

    Запустите CLI следующей командой：`klex --no-cloud`

2. **Создайте нового бота**

    Выберите `Create a new Bot` в списке опций и нажмите Enter。

3. **Назовите вашего бота**

    Введите имя, которое этот бот должен использовать. Бот будет знать, что это его собственное имя。

4. **Настройте поставщиков моделей**

    Перейдите в `Settings -> Model Providers` и создайте экземпляр поставщика для каждого поставщика моделей, которого вы хотите использовать。
    <Panel title="Полезно знать">
    Klex поддерживает различные подписки, поставщиков первой стороны, локальных LLM-поставщиков и универсальных API-поставщиков.

    [Узнайте больше о поставщиках моделей](/concepts/model-providers)。
    </Panel>

5. **Настройте выбор моделей**

    Перейдите в `Settings -> Model Selection` и настройте модель для каждого варианта использования бота。
    <Panel title="Полезно знать">
    Вы должны настроить действительную модель для «Chat», но мы настоятельно рекомендуем настроить все возможности для обеспечения дешёвого использования и полной функциональности。

    [Узнайте больше о выборе моделей](/concepts/model-selection)。
    </Panel>

6. **Дайте боту его душу**

    Перейдите в `Settings -> God messages`, чтобы отправить `God message`. Содержимое год-сообщения должно описывать, какой должна быть душа бота (его работа, его характер и т.д.)。

    [Узнайте больше о душе](/concepts/soul)。

7. **Подключите MCP**

    Перейдите в `Settings -> MCPs` и подключите MCP, чтобы дать боту доступ к внешнему миру.