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

# Xiaomi MiMo

Xiaomi MiMo — это API-платформа для моделей **MiMo**. Встроенный плагин `xiaomi`
(`enabledByDefault: true`, установка не требуется) регистрирует двух текстовых
провайдеров и одного провайдера синтеза речи (TTS):

* `xiaomi` — ключи с оплатой по мере использования (`sk-...`)
* `xiaomi-token-plan` — ключи Token Plan (`tp-...`) с предустановленными региональными конечными точками

| Свойство | Значение |
| - | - |
| Идентификаторы провайдеров | `xiaomi` (оплата по мере использования), `xiaomi-token-plan` (Token Plan) |
| Переменные среды для аутентификации | `XIAOMI_API_KEY`, `XIAOMI_TOKEN_PLAN_API_KEY` |
| Флаги первоначальной настройки | `--auth-choice xiaomi-api-key`, `--auth-choice xiaomi-token-plan-cn`, `--auth-choice xiaomi-token-plan-sgp`, `--auth-choice xiaomi-token-plan-ams` |
| Прямые флаги CLI | `--xiaomi-api-key <key>`, `--xiaomi-token-plan-api-key <key>` |
| API | Совместимые с OpenAI завершения чата (`openai-completions`) |
| Контракт синтеза речи | `speechProviders: ["xiaomi"]` |
| Базовые URL-адреса | Оплата по мере использования: `https://api.xiaomimimo.com/v1`; Token Plan: `token-plan-{cn,sgp,ams}.xiaomimimo.com/v1` |
| Модели по умолчанию | `xiaomi/mimo-v2-flash`, `xiaomi-token-plan/mimo-v2.5-pro` |
| TTS по умолчанию | `mimo-v2.5-tts`, голос `mimo_default`; модель проектирования голоса `mimo-v2.5-tts-voicedesign` |

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

**1. Получите подходящий ключ**

Создайте ключ с оплатой по мере использования в [консоли Xiaomi MiMo](https://platform.xiaomimimo.com/#/console/api-keys) либо откройте страницу своей подписки Token Plan и скопируйте региональный базовый URL-адрес, совместимый с OpenAI, вместе с соответствующим ключом `tp-...`.

**2. Выполните первоначальную настройку**

Оплата по мере использования:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice xiaomi-api-key
```

Token Plan:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice xiaomi-token-plan-sgp
```

Либо передайте ключи напрямую:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice xiaomi-api-key --xiaomi-api-key "$XIAOMI_API_KEY"
openclaw onboard --auth-choice xiaomi-token-plan-sgp --xiaomi-token-plan-api-key "$XIAOMI_TOKEN_PLAN_API_KEY"
```

**3. Убедитесь, что модель доступна**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider xiaomi
openclaw models list --provider xiaomi-token-plan
```

> [!TIP]
>
> При первоначальной настройке проверяется формат ключа и выводится предупреждение, если ключ `tp-...` указан в сценарии с оплатой по мере использования или ключ `sk-...` — в сценарии Token Plan.

## Каталог с оплатой по мере использования

| Ссылка на модель | Входные данные | Контекст | Макс. вывод | Рассуждение | Примечания |
| - | - | - | - | - | - |
| `xiaomi/mimo-v2-flash` | текст | 262,144 | 8,192 | Нет | Модель по умолчанию |
| `xiaomi/mimo-v2-pro` | текст | 1,048,576 | 32,000 | Да | Большой контекст |
| `xiaomi/mimo-v2-omni` | текст, изображение | 262,144 | 32,000 | Да | Мультимодальная |

## Каталог Token Plan

Выберите вариант аутентификации Token Plan, соответствующий региональному базовому URL-адресу, указанному в интерфейсе подписки Xiaomi:

| Вариант аутентификации | Базовый URL-адрес |
| - | - |
| `xiaomi-token-plan-cn` | `https://token-plan-cn.xiaomimimo.com/v1` |
| `xiaomi-token-plan-sgp` | `https://token-plan-sgp.xiaomimimo.com/v1` |
| `xiaomi-token-plan-ams` | `https://token-plan-ams.xiaomimimo.com/v1` |

| Ссылка на модель | Входные данные | Контекст | Макс. вывод | Рассуждение | Примечания |
| - | - | - | - | - | - |
| `xiaomi-token-plan/mimo-v2.5-pro` | текст | 1,048,576 | 131,072 | Да | Модель по умолчанию |
| `xiaomi-token-plan/mimo-v2.5` | текст, изображение | 1,048,576 | 131,072 | Да | Мультимодальная |

Для разрешения `xiaomi-token-plan` требуется региональный базовый URL-адрес. Поддерживаемый
вариант — встроенный выбор первоначальной настройки Token Plan или явный
блок конфигурации `models.providers.xiaomi-token-plan` с заданным `baseUrl`; без
одного из этих вариантов провайдер не предлагается.

## Модели с рассуждением

`mimo-v2-pro`, `mimo-v2-omni`, `mimo-v2.5` и `mimo-v2.5-pro` поддерживают
[директиву `/think`](https://docs2.openclaw.ai/ru/tools/thinking) OpenClaw с уровнями `off`,
`minimal`, `low`, `medium`, `high`, `xhigh` и `max` (по умолчанию `high`).
`mimo-v2-flash` не поддерживает рассуждение.

## Синтез речи

Встроенный плагин `xiaomi` также регистрирует Xiaomi MiMo как провайдера синтеза речи
для `messages.tts`. Он вызывает контракт TTS завершений чата Xiaomi, передавая
текст как сообщение `assistant`, а необязательные указания по стилю — как сообщение `user`.

| Свойство | Значение |
| - | - |
| Идентификатор TTS | `xiaomi` (псевдоним `mimo`) |
| Аутентификация | `XIAOMI_API_KEY` |
| API | `POST /v1/chat/completions` с `audio` |
| По умолчанию | `mimo-v2.5-tts`, голос `mimo_default` |
| Выходной формат | MP3 по умолчанию; WAV при соответствующей настройке |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    tts: {
      auto: "always",
      provider: "xiaomi",
      providers: {
        xiaomi: {
          apiKey: "xiaomi_api_key",
          model: "mimo-v2.5-tts",
          speakerVoice: "mimo_default",
          format: "mp3",
          style: "Яркий, естественный, разговорный тон.",
        },
      },
    },
  },
}
```

Встроенные голоса: `mimo_default`, `default_zh`, `default_en`, `Mia`, `Chloe`,
`Milo`, `Dean`. Модели с предустановленными голосами (`mimo-v2.5-tts`, `mimo-v2-tts`) используют
`audio.voice`, поэтому OpenClaw отправляет `speakerVoice` для этих моделей.

Модель проектирования голоса `mimo-v2.5-tts-voicedesign` генерирует голос на основе
стилевого запроса на естественном языке вместо идентификатора предустановленного голоса. Задайте в `style`
нужное описание голоса; OpenClaw отправляет его как сообщение `user`,
произносимый текст — как сообщение `assistant`, а `audio.voice` для этой
модели не указывает.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    tts: {
      provider: "xiaomi",
      providers: {
        xiaomi: {
          model: "mimo-v2.5-tts-voicedesign",
          format: "wav",
          style: "Теплый, естественный женский голос с четким произношением.",
        },
      },
    },
  },
}
```

Для каналов, запрашивающих синтез с целевым форматом голосовой заметки (Discord, Feishu,
Matrix, Telegram и WhatsApp), OpenClaw перед доставкой транскодирует выходные данные Xiaomi в
монофонический Opus с частотой 48 кГц с помощью `ffmpeg`.

## Пример конфигурации

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { XIAOMI_API_KEY: "your-key" },
  agents: { defaults: { model: { primary: "xiaomi/mimo-v2-flash" } } },
  models: {
    mode: "merge",
    providers: {
      xiaomi: {
        baseUrl: "https://api.xiaomimimo.com/v1",
        api: "openai-completions",
        apiKey: "XIAOMI_API_KEY",
        models: [
          {
            id: "mimo-v2-flash",
            name: "Xiaomi MiMo V2 Flash",
            reasoning: false,
            input: ["text"],
            contextWindow: 262144,
            maxTokens: 8192,
          },
          {
            id: "mimo-v2-pro",
            name: "Xiaomi MiMo V2 Pro",
            reasoning: true,
            input: ["text"],
            contextWindow: 1048576,
            maxTokens: 32000,
          },
          {
            id: "mimo-v2-omni",
            name: "Xiaomi MiMo V2 Omni",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 262144,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}
```

Данные о ценах и флаги совместимости берутся из манифеста встроенного плагина, поэтому в примере конфигурации опущены `cost` и `compat`, чтобы избежать расхождений с поведением среды выполнения.

Token Plan:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { XIAOMI_TOKEN_PLAN_API_KEY: "tp-your-key" },
  agents: { defaults: { model: { primary: "xiaomi-token-plan/mimo-v2.5-pro" } } },
  models: {
    mode: "merge",
    providers: {
      "xiaomi-token-plan": {
        baseUrl: "https://token-plan-sgp.xiaomimimo.com/v1",
        api: "openai-completions",
        apiKey: "XIAOMI_TOKEN_PLAN_API_KEY",
        models: [
          {
            id: "mimo-v2.5-pro",
            name: "Xiaomi MiMo V2.5 Pro",
            reasoning: true,
            input: ["text"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
          {
            id: "mimo-v2.5",
            name: "Xiaomi MiMo V2.5",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}
```

Данные о ценах берутся из встроенного манифеста (модели Token Plan предусматривают многоуровневую тарификацию чтения из кэша), поэтому в примере конфигурации опущен `cost`.

> [accordion] Поведение автоматического внедрения
>
> Провайдер `xiaomi` автоматически включается, когда в среде задан `XIAOMI_API_KEY` или существует профиль аутентификации. Для `xiaomi-token-plan` требуется региональный базовый URL-адрес, поэтому поддерживаемый вариант — встроенный выбор первоначальной настройки Token Plan или явный блок конфигурации `models.providers.xiaomi-token-plan`.

> [accordion] Сведения о моделях
>
> * **mimo-v2-flash** — легкая и быстрая модель, идеально подходящая для текстовых задач общего назначения. Рассуждение не поддерживается.
>
> * **mimo-v2-pro** — поддерживает рассуждение и имеет контекстное окно размером 1M токенов для обработки длинных документов.
>
> * **mimo-v2-omni** — мультимодальная модель с поддержкой рассуждения, принимающая на вход текст и изображения.
>
> * **mimo-v2.5-pro** — модель Token Plan по умолчанию с актуальным стеком рассуждения V2.5 от Xiaomi.
>
> * **mimo-v2.5** — мультимодальный маршрут V2.5 для Token Plan.
>
> > [!NOTE]
> >
> > Модели с оплатой по мере использования применяют префикс `xiaomi/`. Модели Token Plan применяют префикс `xiaomi-token-plan/`.

> [accordion] Устранение неполадок
>
> * Если модели не отображаются, убедитесь, что соответствующая переменная среды с ключом или профиль аутентификации существует и действителен.
>
> * Для Token Plan убедитесь, что регион, выбранный при первоначальной настройке, соответствует базовому URL-адресу на странице подписки, а ключ начинается с `tp-`.
>
> * Если Gateway работает как демон, убедитесь, что ключ доступен этому процессу (например, в `~/.openclaw/.env` или через `env.shellEnv`).
>
> > [!WARNING]
> >
> > Ключи, заданные только в интерактивной оболочке, недоступны процессам Gateway, управляемым как демоны. Для постоянной доступности используйте конфигурацию `~/.openclaw/.env` или `env.shellEnv`.

## Связанные материалы

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Уровни рассуждения](https://docs2.openclaw.ai/ru/tools/thinking.md)
>
> Синтаксис директивы `/think` и сопоставление уровней.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полный справочник по конфигурации OpenClaw.

> [card] [Консоль Xiaomi MiMo](https://platform.xiaomimimo.com)
>
> Панель управления Xiaomi MiMo и управление ключами API.