跳轉到主要內容
Xiaomi MiMo 是 MiMo 模型的 API 平台。內建的 xiaomi 外掛(enabledByDefault: true,無需安裝步驟)會註冊兩個文字 提供者以及一個語音(TTS)提供者:
  • xiaomi - 即用即付金鑰(sk-...
  • xiaomi-token-plan - Token Plan 金鑰(tp-...),含區域端點預設值
屬性
提供者 IDxiaomi(即用即付)、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
直接命令列介面旗標--xiaomi-api-key <key>, --xiaomi-token-plan-api-key <key>
APIOpenAI 相容的聊天補全(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;voicedesign 模型 mimo-v2.5-tts-voicedesign

開始使用

1

Get the right key

Xiaomi MiMo 主控台建立即用即付金鑰,或開啟你的 Token Plan 訂閱頁面,複製區域 OpenAI 相容基礎 URL 以及對應的 tp-... 金鑰。
2

Run onboarding

即用即付:
openclaw onboard --auth-choice xiaomi-api-key
Token Plan:
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"
3

Verify the model is available

openclaw models list --provider xiaomi
openclaw models list --provider xiaomi-token-plan
初始設定會驗證金鑰格式,並在 tp-... 金鑰被輸入到即用即付路徑,或 sk-... 金鑰被輸入到 Token Plan 路徑時發出警告。

即用即付目錄

模型參照輸入脈絡最大輸出推理備註
xiaomi/mimo-v2-flashtext262,1448,192預設模型
xiaomi/mimo-v2-protext1,048,57632,000大型脈絡
xiaomi/mimo-v2-omnitext, image262,14432,000多模態

Token Plan 目錄

選擇與 Xiaomi 訂閱 UI 中顯示的區域基礎 URL 相符的 Token Plan 驗證選項:
驗證選項基礎 URL
xiaomi-token-plan-cnhttps://token-plan-cn.xiaomimimo.com/v1
xiaomi-token-plan-sgphttps://token-plan-sgp.xiaomimimo.com/v1
xiaomi-token-plan-amshttps://token-plan-ams.xiaomimimo.com/v1
模型參照輸入脈絡最大輸出推理備註
xiaomi-token-plan/mimo-v2.5-protext1,048,576131,072預設模型
xiaomi-token-plan/mimo-v2.5text, image1,048,576131,072多模態
xiaomi-token-plan 需要區域基礎 URL 才能解析。支援的路徑是 內建 Token Plan 初始設定選項,或明確設定了 baseUrlmodels.providers.xiaomi-token-plan 設定區塊;若沒有其中一項, 就不會提供該提供者。

推理模型

mimo-v2-pro, mimo-v2-omni, mimo-v2.5, 和 mimo-v2.5-pro 支援 OpenClaw 的 /think 指令,層級包含 off, minimal, low, medium, high, xhigh, 和 max(預設為 high)。 mimo-v2-flash 不支援推理。

文字轉語音

內建的 xiaomi 外掛也會將 Xiaomi MiMo 註冊為 messages.tts 的語音提供者。它會呼叫 Xiaomi 的聊天補全 TTS 合約,將文字作為 assistant 訊息,並將選用的風格指引作為 user 訊息。
屬性
TTS IDxiaomimimo 別名)
驗證XIAOMI_API_KEY
APIPOST /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 voicedesign 模型 mimo-v2.5-tts-voicedesign 會從自然語言風格提示產生語音, 而不是使用預設語音 ID。將 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 會先使用 ffmpeg 將 Xiaomi 輸出轉碼為 48kHz 單聲道 Opus,再進行傳遞。

設定範例

{
  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,
          },
        ],
      },
    },
  },
}
定價和相容性旗標來自內建外掛資訊清單,因此設定範例省略 costcompat,以避免與執行階段行為產生差異。 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,
          },
        ],
      },
    },
  },
}
定價來自內建資訊清單(Token Plan 模型包含階梯式快取讀取定價),因此設定範例省略 cost
當你的環境中設定了 XIAOMI_API_KEY 或存在驗證設定檔時,xiaomi 提供者會自動啟用。xiaomi-token-plan 需要區域基礎 URL,因此支援的路徑是內建 Token Plan 初始設定選項,或明確的 models.providers.xiaomi-token-plan 設定區塊。
  • mimo-v2-flash - 輕量且快速,適合一般用途文字任務。不支援推理。
  • mimo-v2-pro - 支援推理,並提供 1M token 脈絡視窗,適合長文件工作負載。
  • mimo-v2-omni - 啟用推理的多模態模型,可接受文字和影像輸入。
  • mimo-v2.5-pro - Token Plan 預設模型,使用 Xiaomi 目前的 V2.5 推理堆疊。
  • mimo-v2.5 - Token Plan 多模態 V2.5 路由。
即用即付模型使用 xiaomi/ 前綴。Token Plan 模型使用 xiaomi-token-plan/ 前綴。
  • 如果模型沒有出現,請確認相關金鑰環境變數或驗證設定檔存在且有效。
  • 對於 Token Plan,請確認選擇的初始設定區域符合訂閱頁面的基礎 URL,且金鑰以 tp- 開頭。
  • 當閘道以守護程序執行時,請確保該程序可存取金鑰(例如位於 ~/.openclaw/.env,或透過 env.shellEnv)。
只在互動式 shell 中設定的金鑰,對守護程序管理的閘道程序不可見。請使用 ~/.openclaw/.envenv.shellEnv 設定,確保可持續存取。

相關

Model selection

選擇提供者、模型參照和容錯移轉行為。

Thinking levels

/think 指令語法與層級對應。

Configuration reference

完整的 OpenClaw 設定參考。

Xiaomi MiMo console

Xiaomi MiMo 儀表板與 API 金鑰管理。