Providers
Xiaomi MiMo
Xiaomi MiMo هي منصة API لنماذج MiMo. تسجّل إضافة xiaomi
المضمّنة (enabledByDefault: true، من دون خطوة تثبيت) موفّرَي نص
بالإضافة إلى موفّر تحويل النص إلى كلام (TTS):
xiaomi- مفاتيح الدفع حسب الاستخدام (sk-...)xiaomi-token-plan- مفاتيح خطة الرموز (tp-...) مع إعدادات مسبقة لنقاط النهاية الإقليمية
| الخاصية | القيمة |
|---|---|
| معرّفات الموفّرين | xiaomi (الدفع حسب الاستخدام)، xiaomi-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-{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 |
البدء
الحصول على المفتاح الصحيح
أنشئ مفتاح دفع حسب الاستخدام في وحدة تحكم Xiaomi MiMo، أو افتح صفحة اشتراك خطة الرموز وانسخ عنوان URL الأساسي الإقليمي المتوافق مع OpenAI مع مفتاح tp-... المطابق.
تشغيل الإعداد الأولي
الدفع حسب الاستخدام:
openclaw onboard --auth-choice xiaomi-api-keyخطة الرموز:
openclaw onboard --auth-choice xiaomi-token-plan-sgpأو مرّر المفاتيح مباشرةً:
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"التحقق من توفر النموذج
openclaw models list --provider xiaomiopenclaw models list --provider xiaomi-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 | نعم | متعدد الوسائط |
كتالوج خطة الرموز
اختر خيار مصادقة خطة الرموز المطابق لعنوان 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 أساسي إقليمي ليتمكّن من التحليل. المسار
المدعوم هو خيار إعداد أولي مضمن لخطة الرموز أو كتلة إعداد
models.providers.xiaomi-token-plan صريحة مع ضبط baseUrl؛ ولا يُعرض
الموفّر من دون أحد هذين الخيارين.
نماذج الاستدلال
تدعم mimo-v2-pro وmimo-v2-omni وmimo-v2.5 وmimo-v2.5-pro
توجيه /think في 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 عند ضبطه |
{ 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. تستخدم نماذج الأصوات المحددة مسبقًا (mimo-v2.5-tts وmimo-v2-tts)
audio.voice، لذلك يرسل OpenClaw القيمة speakerVoice لهذه النماذج.
ينشئ نموذج تصميم الصوت mimo-v2.5-tts-voicedesign الصوت من مطالبة أسلوب
بلغة طبيعية بدلًا من معرّف صوت محدد مسبقًا. اضبط style على
وصف الصوت المطلوب؛ يرسله OpenClaw كرسالة user، ويرسل
النص المنطوق كرسالة assistant، ويحذف audio.voice لهذا
النموذج.
{ messages: { tts: { provider: "xiaomi", providers: { xiaomi: { model: "mimo-v2.5-tts-voicedesign", format: "wav", style: "Warm, natural female voice with clear pronunciation.", }, }, }, },}بالنسبة إلى القنوات التي تطلب هدف توليف ملاحظة صوتية (Discord وFeishu
وMatrix وTelegram وWhatsApp)، يحوّل OpenClaw ترميز مخرجات Xiaomi إلى Opus
أحادي القناة بتردد 48 كيلوهرتز باستخدام ffmpeg قبل التسليم.
مثال على الإعداد
{ 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 لتجنّب الاختلاف عن سلوك وقت التشغيل.
خطة الرموز:
{ 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, }, ], }, }, },}يأتي التسعير من البيان المضمّن (تتضمن نماذج خطة الرموز تسعيرًا متدرجًا لقراءة ذاكرة التخزين المؤقت)، لذلك يحذف مثال الإعداد cost.
سلوك الحقن التلقائي
يُفعّل موفّر xiaomi تلقائيًا عند ضبط XIAOMI_API_KEY في بيئتك أو عند وجود ملف تعريف مصادقة. يحتاج xiaomi-token-plan إلى عنوان URL أساسي إقليمي، لذلك يكون المسار المدعوم هو خيار الإعداد الأولي المضمّن لخطة الرموز أو كتلة إعداد models.providers.xiaomi-token-plan صريحة.
تفاصيل النماذج
- mimo-v2-flash - خفيف وسريع، ومثالي لمهام النصوص ذات الأغراض العامة. لا يدعم الاستدلال.
- mimo-v2-pro - يدعم الاستدلال مع نافذة سياق بسعة مليون رمز لأعباء عمل المستندات الطويلة.
- mimo-v2-omni - نموذج متعدد الوسائط يدعم الاستدلال ويقبل إدخالات النصوص والصور.
- mimo-v2.5-pro - النموذج الافتراضي لخطة الرموز مع حزمة الاستدلال V2.5 الحالية من Xiaomi.
- mimo-v2.5 - مسار V2.5 متعدد الوسائط لخطة الرموز.
استكشاف الأخطاء وإصلاحها
- إذا لم تظهر النماذج، فتأكد من وجود متغير بيئة المفتاح ذي الصلة أو ملف تعريف المصادقة ومن صلاحيته.
- بالنسبة إلى خطة الرموز، تأكد من تطابق منطقة الإعداد الأولي المختارة مع عنوان URL الأساسي في صفحة الاشتراك، ومن أن المفتاح يبدأ بـ
tp-. - عندما يعمل Gateway كخدمة خفية، تأكد من توفر المفتاح لهذه العملية (على سبيل المثال في
~/.openclaw/.envأو عبرenv.shellEnv).
