> ## 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**. يتضمن OpenClaw Plugin مضمّنًا من Xiaomi بإعدادين مسبقين لمزوّد النصوص:

* `xiaomi` لمفاتيح الدفع حسب الاستخدام (`sk-...`)
* `xiaomi-token-plan` لمفاتيح Token Plan (`tp-...`) مع إعدادات مسبقة لنقاط النهاية الإقليمية

يسجّل Plugin نفسه أيضًا مزوّد الكلام (TTS) `xiaomi`.

| الخاصية               | القيمة                                                                                                                                             |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| معرّفات المزوّد       | `xiaomi` (الدفع حسب الاستخدام)، `xiaomi-token-plan` (Token Plan)                                                                                   |
| Plugin                | مضمّن، `enabledByDefault: true`                                                                                                                    |
| متغيرات بيئة المصادقة | `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>`                                                                                      |
| العقود                | إكمالات الدردشة + `speechProviders`                                                                                                                |
| API                   | متوافقة مع OpenAI (`openai-completions`)                                                                                                           |
| عناوين URL الأساسية   | الدفع حسب الاستخدام: `https://api.xiaomimimo.com/v1`؛ إعدادات Token Plan المسبقة: `token-plan-{cn,sgp,ams}...`                                     |
| النماذج الافتراضية    | `xiaomi/mimo-v2-flash`، `xiaomi-token-plan/mimo-v2.5-pro`                                                                                          |
| إعداد TTS الافتراضي   | `mimo-v2.5-tts`، الصوت `mimo_default`؛ نموذج تصميم الصوت `mimo-v2.5-tts-voicedesign`                                                               |

## البدء

<Steps>
  <Step title="Get the right key">
    أنشئ مفتاح دفع حسب الاستخدام في [وحدة تحكم Xiaomi MiMo](https://platform.xiaomimimo.com/#/console/api-keys)، أو افتح صفحة اشتراك Token Plan لديك وانسخ عنوان URL الأساسي الإقليمي المتوافق مع OpenAI مع مفتاح `tp-...` المطابق.
  </Step>

  <Step title="Run onboarding">
    الدفع حسب الاستخدام:

    ```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"
    ```
  </Step>

  <Step title="Verify the model is available">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider xiaomi
    openclaw models list --provider xiaomi-token-plan
    ```
  </Step>
</Steps>

## كتالوج الدفع حسب الاستخدام

| مرجع النموذج           | الإدخال  | السياق    | الحد الأقصى للمخرجات | الاستدلال | ملاحظات           |
| ---------------------- | -------- | --------- | -------------------- | --------- | ----------------- |
| `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               | نعم       | متعدد الوسائط     |

<Tip>
  مرجع النموذج الافتراضي هو `xiaomi/mimo-v2-flash`. يُحقن المزوّد تلقائيًا عند تعيين `XIAOMI_API_KEY` أو وجود ملف تعريف مصادقة.
</Tip>

## كتالوج Token Plan

اختر خيار مصادقة Token Plan الذي يطابق عنوان URL الأساسي الإقليمي المعروض في واجهة اشتراك Xiaomi:

* `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              | نعم       | متعدد الوسائط     |

<Tip>
  يتحقق إعداد Token Plan الأولي من شكل المفتاح وينبّه عند إدخال مفتاح `tp-...` في مسار الدفع حسب الاستخدام، أو إدخال مفتاح `sk-...` في مسار Token Plan.
</Tip>

## تحويل النص إلى كلام

يسجّل Plugin `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: "Bright, natural, conversational tone.",
        },
      },
    },
  },
}
```

تشمل الأصوات المدمجة المدعومة `mimo_default` و`default_zh` و`default_en`
و`Mia` و`Chloe` و`Milo` و`Dean`. تستخدم نماذج الأصوات المسبقة `audio.voice`، لذلك
يرسل OpenClaw `speakerVoice` لـ `mimo-v2.5-tts` و`mimo-v2-tts`.

ينشئ نموذج تصميم الصوت من Xiaomi، `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: "Warm, natural female voice with clear pronunciation.",
        },
      },
    },
  },
}
```

بالنسبة إلى أهداف الملاحظات الصوتية مثل Feishu وTelegram، يحوّل 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,
          },
        ],
      },
    },
  },
}
```

تأتي أعلام التسعير والتوافق من بيان Plugin المضمّن، لذلك يحذف مثال التهيئة `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`.

<AccordionGroup>
  <Accordion title="Auto-injection behavior">
    يُحقن مزوّد `xiaomi` تلقائيًا عند تعيين `XIAOMI_API_KEY` في بيئتك أو وجود ملف تعريف مصادقة. يحتاج `xiaomi-token-plan` إلى عنوان URL أساسي إقليمي، لذلك المسار المدعوم هو خيار إعداد Token Plan الأولي المضمّن أو كتلة تهيئة `models.providers.xiaomi-token-plan` صريحة.
  </Accordion>

  <Accordion title="Model details">
    * **mimo-v2-flash** — خفيف وسريع، ومثالي لمهام النصوص العامة. لا يدعم الاستدلال.
    * **mimo-v2-pro** — يدعم الاستدلال مع نافذة سياق قدرها مليون رمز لأعباء عمل المستندات الطويلة.
    * **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/`.
    </Note>
  </Accordion>

  <Accordion title="Troubleshooting">
    * إذا لم تظهر النماذج، فتأكد من وجود متغير بيئة المفتاح المعني أو ملف تعريف المصادقة وأنه صالح.
    * بالنسبة إلى Token Plan، تأكد من أن منطقة الإعداد الأولي المختارة تطابق عنوان URL الأساسي في صفحة الاشتراك وأن المفتاح يبدأ بـ `tp-`.
    * عند تشغيل Gateway كبرنامج خفي، تأكد من أن المفتاح متاح لتلك العملية (مثلًا في `~/.openclaw/.env` أو عبر `env.shellEnv`).

    <Warning>
      المفاتيح المعيّنة فقط في الصدفة التفاعلية لديك لا تكون مرئية لعمليات Gateway المُدارة كبرامج خفية. استخدم تهيئة `~/.openclaw/.env` أو `env.shellEnv` للتوافر المستمر.
    </Warning>
  </Accordion>
</AccordionGroup>

## ذات صلة

<CardGroup cols={2}>
  <Card title="Model selection" href="/ar/concepts/model-providers" icon="layers">
    اختيار المزوّدين ومراجع النماذج وسلوك تجاوز الفشل.
  </Card>

  <Card title="Configuration reference" href="/ar/gateway/configuration-reference" icon="gear">
    مرجع تهيئة OpenClaw الكامل.
  </Card>

  <Card title="Xiaomi MiMo console" href="https://platform.xiaomimimo.com" icon="arrow-up-right-from-square">
    لوحة تحكم Xiaomi MiMo وإدارة مفاتيح API.
  </Card>
</CardGroup>