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.5、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.5 |
文字、影像 | 1,048,576 | 131,072 | 是 | 預設模型 |
xiaomi/mimo-v2.5-pro |
文字 | 1,048,576 | 131,072 | 是 | 旗艦模型 |
Token Plan 目錄
請選擇與 Xiaomi 訂閱 UI 所顯示區域基礎 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.5 和 mimo-v2.5-pro 支援
OpenClaw 的 /think 指令,層級包括 off、
minimal、low、medium、high、xhigh 和 max(預設為 high)。
文字轉語音
隨附的 xiaomi 外掛也會將 Xiaomi MiMo 註冊為
tts 的語音供應商。它會呼叫 Xiaomi 的聊天補全 TTS 合約,
將文字作為 assistant 訊息,並將選用的風格指引作為 user
訊息。
| 屬性 | 值 |
|---|---|
| TTS ID | xiaomi(mimo 別名) |
| 驗證 | XIAOMI_API_KEY |
| API | POST /v1/chat/completions 搭配 audio |
| 預設值 | mimo-v2.5-tts,語音 mimo_default |
| 輸出 | 預設為 MP3;設定時則為 WAV |
{ 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 使用 audio.voice,因此
OpenClaw 會為該模型傳送 speakerVoice。
語音設計模型 mimo-v2.5-tts-voicedesign 會根據
自然語言風格提示產生語音,而非使用預設語音 ID。將 style 設定為
所需的語音描述;OpenClaw 會將其作為 user 訊息傳送,將
要朗讀的文字作為 assistant 訊息傳送,並在此模型中省略 audio.voice。
{ 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.5" } } }, models: { mode: "merge", providers: { xiaomi: { baseUrl: "https://api.xiaomimimo.com/v1", api: "openai-completions", apiKey: "XIAOMI_API_KEY", models: [ { id: "mimo-v2.5", name: "Xiaomi MiMo V2.5", reasoning: true, input: ["text", "image"], contextWindow: 1048576, maxTokens: 131072, }, { id: "mimo-v2.5-pro", name: "Xiaomi MiMo V2.5 Pro", reasoning: true, input: ["text"], contextWindow: 1048576, maxTokens: 131072, }, ], }, }, },}定價與相容性旗標來自隨附的外掛資訊清單,因此設定範例省略 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.5 - 隨用隨付的預設模型,以及 Token Plan 的多模態 V2.5 路由。
- mimo-v2.5-pro - 旗艦推理模型,以及 Token Plan 的預設模型。
疑難排解
- 如果模型未出現,請確認相關的金鑰環境變數或驗證設定檔存在且有效。
- 對於 Token Plan,請確認所選的初始設定區域與訂閱頁面的基礎 URL 相符,且金鑰以
tp-開頭。 - 當閘道以常駐程式執行時,請確保該程序可以使用金鑰(例如放在
~/.openclaw/.env中,或透過env.shellEnv)。