Providers
小米 MiMo
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 <key>、--xiaomi-token-plan-api-key <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 主控台中建立隨用隨付金鑰，或開啟你的 Token Plan 訂閱頁面，複製區域性的 OpenAI 相容基礎 URL，以及相符的 tp-... 金鑰。
執行引導設定
隨用隨付：
openclaw onboard --auth-choice xiaomi-api-keyToken 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"確認模型可用
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 | 是 | 多模態 |
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 指令，可用層級為 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 |
{ 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。
{ 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, }, ], }, }, },}定價與相容性旗標來自內建的外掛資訊清單，因此設定範例省略 cost 和 compat，以避免與執行階段行為產生差異。
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－支援推理，並提供 100 萬權杖的上下文視窗，適合長文件工作負載。
- mimo-v2-omni－支援推理的多模態模型，可接受文字與圖片輸入。
- mimo-v2.5-pro－Token Plan 預設模型，採用 Xiaomi 目前的 V2.5 推理技術堆疊。
- mimo-v2.5－Token Plan 的多模態 V2.5 路由。
疑難排解
- 如果模型未出現，請確認相關的金鑰環境變數或驗證設定檔存在且有效。
- 對於 Token Plan，請確認所選的引導設定區域與訂閱頁面的基礎 URL 相符，且金鑰以
tp-開頭。 - 當閘道以常駐程式執行時，請確保該處理程序可取得金鑰（例如放在
~/.openclaw/.env中，或透過env.shellEnv提供）。
