--- read_when: - 你想在 OpenClaw 中使用小米 MiMo 模型 - 你需要設定小米 MiMo 驗證或 Token Plan summary: 在 OpenClaw 中使用 Xiaomi MiMo 隨用隨付與 Token Plan 模型 title: 小米 MiMo x-i18n: generated_at: "2026-07-11T21:46:48Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: e6b91ead3e4a32a93bca7e02476b8de11137e8a5b5fa434bad8187bc1b204856 source_path: providers/xiaomi.md workflow: 16 --- Xiaomi MiMo 是 **MiMo** 模型的 API 平台。內建的 `xiaomi` 外掛（`enabledByDefault: true`，無需安裝步驟）會註冊兩個文字 供應商，以及一個語音（TTS）供應商： - `xiaomi`－隨用隨付金鑰（`sk-...`） - `xiaomi-token-plan`－Token Plan 金鑰（`tp-...`），提供區域端點預設值 | 屬性 | 值 | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | 供應商 ID | `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` | | 直接命令列介面旗標 | `--xiaomi-api-key `、`--xiaomi-token-plan-api-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` | ## 開始使用 在 [Xiaomi MiMo 主控台](https://platform.xiaomimimo.com/#/console/api-keys)中建立隨用隨付金鑰，或開啟你的 Token Plan 訂閱頁面，複製區域性的 OpenAI 相容基礎 URL，以及相符的 `tp-...` 金鑰。 隨用隨付： ```bash openclaw onboard --auth-choice xiaomi-api-key ``` Token Plan： ```bash openclaw onboard --auth-choice xiaomi-token-plan-sgp ``` 或直接傳入金鑰： ```bash 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" ``` ```bash openclaw models list --provider xiaomi openclaw models list --provider xiaomi-token-plan ``` 引導設定會驗證金鑰格式，並在將 `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 目錄 選擇與 Xiaomi 訂閱介面中所顯示區域基礎 URL 相符的 Token Plan 驗證選項： | 驗證選項 | 基礎 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` 支援 OpenClaw 的 [`/think` 指令](/zh-TW/tools/thinking)，可用層級為 `off`、 `minimal`、`low`、`medium`、`high`、`xhigh` 和 `max`（預設為 `high`）。 `mimo-v2-flash` 不支援推理。 ## 文字轉語音 內建的 `xiaomi` 外掛也會將 Xiaomi MiMo 註冊為 `messages.tts` 的語音供應商。它會呼叫 Xiaomi 的聊天補全 TTS 合約，將文字作為 `assistant` 訊息，並將選用的風格指引作為 `user` 訊息。 | 屬性 | 值 | | -------- | ---------------------------------------- | | TTS ID | `xiaomi`（別名 `mimo`） | | 驗證 | `XIAOMI_API_KEY` | | API | 使用 `audio` 的 `POST /v1/chat/completions` | | 預設值 | `mimo-v2.5-tts`，語音 `mimo_default` | | 輸出 | 預設為 MP3；設定後可使用 WAV | ```json5 { 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` 會根據自然語言風格提示產生 語音，而不是使用預設語音 ID。請將 `style` 設為所需的語音描述； OpenClaw 會將其作為 `user` 訊息傳送、將要朗讀的文字作為 `assistant` 訊息傳送，並針對此模型省略 `audio.voice`。 ```json5 { 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。 ## 設定範例 ```json5 { 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 { 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**－支援推理，並提供 100 萬權杖的上下文視窗，適合長文件工作負載。 - **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/.env` 或 `env.shellEnv` 設定，確保持續可用。 ## 相關內容 選擇供應商、模型參照與容錯移轉行為。 `/think` 指令語法與層級對應關係。 完整的 OpenClaw 設定參考。 Xiaomi MiMo 儀表板與 API 金鑰管理。