提供商
小米 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 |
| 直接使用的 CLI 标志 | --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 新手引导选项，或者显式配置
设置了 baseUrl 的 models.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 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 输出转码为 48 kHz 单声道 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 万 Token 的上下文窗口，适用于长文档工作负载。
- mimo-v2-omni——支持推理的多模态模型，可接受文本和图像输入。
- mimo-v2.5-pro——Token Plan 默认模型，使用 Xiaomi 当前的 V2.5 推理栈。
- mimo-v2.5——Token Plan 多模态 V2.5 路由。
故障排查
- 如果模型未显示，请确认相关的密钥环境变量或身份验证配置文件存在且有效。
- 对于 Token Plan，请确认所选的新手引导区域与订阅页面的基础 URL 匹配，并且密钥以
tp-开头。 - 当 Gateway 网关作为守护进程运行时，请确保该进程可以访问密钥（例如将其放在
~/.openclaw/.env中，或通过env.shellEnv提供）。
