Vai al contenuto principale
Xiaomi MiMo è la piattaforma API per i modelli MiMo. OpenClaw include un Plugin Xiaomi integrato con due preset di provider di testo:
  • xiaomi per chiavi con pagamento a consumo (sk-...)
  • xiaomi-token-plan per chiavi Token Plan (tp-...) con preset di endpoint regionali
Lo stesso Plugin registra anche il provider vocale (TTS) xiaomi.
ProprietàValore
ID providerxiaomi (pagamento a consumo), xiaomi-token-plan (Token Plan)
Pluginintegrato, enabledByDefault: true
Variabili env di authXIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY
Flag di onboarding--auth-choice xiaomi-api-key, --auth-choice xiaomi-token-plan-cn, --auth-choice xiaomi-token-plan-sgp, --auth-choice xiaomi-token-plan-ams
Flag CLI diretti--xiaomi-api-key <key>, --xiaomi-token-plan-api-key <key>
Contratticompletamenti chat + speechProviders
APIcompatibile con OpenAI (openai-completions)
URL basePagamento a consumo: https://api.xiaomimimo.com/v1; preset Token Plan: token-plan-{cn,sgp,ams}...
Modelli predefinitixiaomi/mimo-v2-flash, xiaomi-token-plan/mimo-v2.5-pro
TTS predefinitomimo-v2.5-tts, voce mimo_default; modello voicedesign mimo-v2.5-tts-voicedesign

Per iniziare

1

Ottieni la chiave corretta

Crea una chiave con pagamento a consumo nella console Xiaomi MiMo, oppure apri la pagina del tuo abbonamento Token Plan e copia l’URL base regionale compatibile con OpenAI insieme alla chiave tp-... corrispondente.
2

Esegui l'onboarding

Pagamento a consumo:
openclaw onboard --auth-choice xiaomi-api-key
Token Plan:
openclaw onboard --auth-choice xiaomi-token-plan-sgp
Oppure passa direttamente le chiavi:
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

Verifica che il modello sia disponibile

openclaw models list --provider xiaomi
openclaw models list --provider xiaomi-token-plan

Catalogo con pagamento a consumo

Rif. modelloInputContestoOutput maxRagionamentoNote
xiaomi/mimo-v2-flashtext262,1448,192NoModello predefinito
xiaomi/mimo-v2-protext1,048,57632,000Contesto ampio
xiaomi/mimo-v2-omnitext, image262,14432,000Multimodale
Il riferimento del modello predefinito è xiaomi/mimo-v2-flash. Il provider viene iniettato automaticamente quando XIAOMI_API_KEY è impostata o quando esiste un profilo di auth.

Catalogo Token Plan

Scegli l’opzione di auth Token Plan che corrisponde all’URL base regionale mostrato nell’interfaccia di abbonamento di 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
Rif. modelloInputContestoOutput maxRagionamentoNote
xiaomi-token-plan/mimo-v2.5-protext1,048,576131,072Modello predefinito
xiaomi-token-plan/mimo-v2.5text, image1,048,576131,072Multimodale
L’onboarding Token Plan convalida il formato della chiave e avvisa quando una chiave tp-... viene inserita nel percorso con pagamento a consumo, oppure quando una chiave sk-... viene inserita nel percorso Token Plan.

Sintesi vocale

Il Plugin integrato xiaomi registra anche Xiaomi MiMo come provider vocale per messages.tts. Chiama il contratto TTS dei completamenti chat di Xiaomi con il testo come messaggio assistant e indicazioni di stile facoltative come messaggio user.
ProprietàValore
ID TTSxiaomi (alias mimo)
AuthXIAOMI_API_KEY
APIPOST /v1/chat/completions con audio
Predefinitomimo-v2.5-tts, voce mimo_default
OutputMP3 per impostazione predefinita; WAV quando configurato
{
  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.",
        },
      },
    },
  },
}
Le voci integrate supportate includono mimo_default, default_zh, default_en, Mia, Chloe, Milo e Dean. I modelli con voce preset usano audio.voice, quindi OpenClaw invia speakerVoice per mimo-v2.5-tts e mimo-v2-tts. Il modello voicedesign di Xiaomi, mimo-v2.5-tts-voicedesign, genera la voce da un prompt di stile in linguaggio naturale invece che da un ID voce preset. Configura style con la descrizione della voce desiderata; OpenClaw la invia come messaggio user, invia il testo parlato come messaggio assistant e omette audio.voice per questo modello.
{
  messages: {
    tts: {
      provider: "xiaomi",
      providers: {
        xiaomi: {
          model: "mimo-v2.5-tts-voicedesign",
          format: "wav",
          style: "Warm, natural female voice with clear pronunciation.",
        },
      },
    },
  },
}
Per destinazioni di note vocali come Feishu e Telegram, OpenClaw transcodifica l’output di Xiaomi in Opus a 48 kHz con ffmpeg prima della consegna.

Esempio di configurazione

{
  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,
          },
        ],
      },
    },
  },
}
I prezzi e i flag di compatibilità provengono dal manifest del Plugin integrato, quindi l’esempio di configurazione omette cost e compat per evitare divergenze dal comportamento runtime. Token Plan:
{
  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,
          },
        ],
      },
    },
  },
}
I prezzi provengono dal manifest integrato (i modelli Token Plan includono prezzi a livelli per la lettura dalla cache), quindi l’esempio di configurazione omette cost.
Il provider xiaomi viene iniettato automaticamente quando XIAOMI_API_KEY è impostata nel tuo ambiente o quando esiste un profilo di auth. xiaomi-token-plan richiede un URL base regionale, quindi il percorso supportato è l’opzione di onboarding Token Plan integrata o un blocco di configurazione models.providers.xiaomi-token-plan esplicito.
  • mimo-v2-flash — leggero e veloce, ideale per attività di testo generiche. Nessun supporto al ragionamento.
  • mimo-v2-pro — supporta il ragionamento con una finestra di contesto da 1M token per carichi di lavoro su documenti lunghi.
  • mimo-v2-omni — modello multimodale con ragionamento abilitato che accetta input sia di testo sia di immagini.
  • mimo-v2.5-pro — predefinito Token Plan con lo stack di ragionamento V2.5 attuale di Xiaomi.
  • mimo-v2.5 — route V2.5 multimodale Token Plan.
I modelli con pagamento a consumo usano il prefisso xiaomi/. I modelli Token Plan usano il prefisso xiaomi-token-plan/.
  • Se i modelli non vengono visualizzati, conferma che la variabile env della chiave pertinente o il profilo di auth sia presente e valido.
  • Per Token Plan, conferma che la regione di onboarding scelta corrisponda all’URL base della pagina di abbonamento e che la chiave inizi con tp-.
  • Quando il Gateway viene eseguito come daemon, assicurati che la chiave sia disponibile per quel processo (per esempio in ~/.openclaw/.env o tramite env.shellEnv).
Le chiavi impostate solo nella shell interattiva non sono visibili ai processi Gateway gestiti da daemon. Usa ~/.openclaw/.env o la configurazione env.shellEnv per la disponibilità persistente.

Correlati

Selezione del modello

Scelta di provider, riferimenti dei modelli e comportamento di failover.

Riferimento di configurazione

Riferimento completo della configurazione OpenClaw.

Console Xiaomi MiMo

Dashboard Xiaomi MiMo e gestione delle chiavi API.