xiaomi用于按需付费密钥(sk-...)xiaomi-token-plan用于 Token Plan 密钥(tp-...),并带有区域端点预设
xiaomi 语音(TTS)提供方。
| Property | Value |
|---|---|
| Provider ids | xiaomi(按需付费),xiaomi-token-plan(Token Plan) |
| Plugin | 内置,enabledByDefault: true |
| Auth env vars | XIAOMI_API_KEY,XIAOMI_TOKEN_PLAN_API_KEY |
| Onboarding flags | --auth-choice xiaomi-api-key,--auth-choice xiaomi-token-plan-cn,--auth-choice xiaomi-token-plan-sgp,--auth-choice xiaomi-token-plan-ams |
| Direct CLI flags | --xiaomi-api-key <key>,--xiaomi-token-plan-api-key <key> |
| Contracts | chat completions + speechProviders |
| API | OpenAI 兼容(openai-completions) |
| Base URLs | 按需付费:https://api.xiaomimimo.com/v1;Token Plan 预设:token-plan-{cn,sgp,ams}... |
| Default models | xiaomi/mimo-v2-flash,xiaomi-token-plan/mimo-v2.5-pro |
| TTS default | mimo-v2.5-tts,voice mimo_default;voicedesign model mimo-v2.5-tts-voicedesign |
开始使用
获取正确的密钥
在 Xiaomi MiMo 控制台 中创建一个按需付费密钥,或者打开你的 Token Plan 订阅页面,复制对应区域的 OpenAI 兼容 base URL 以及匹配的
tp-... 密钥。按需付费目录
| Model ref | Input | Context | Max output | Reasoning | Notes |
|---|---|---|---|---|---|
xiaomi/mimo-v2-flash | text | 262,144 | 8,192 | No | 默认模型 |
xiaomi/mimo-v2-pro | text | 1,048,576 | 32,000 | Yes | 大上下文 |
xiaomi/mimo-v2-omni | text, image | 262,144 | 32,000 | Yes | 多模态 |
Token Plan 目录
选择与 Xiaomi 订阅界面中显示的区域 base URL 匹配的 Token Plan 认证选项:xiaomi-token-plan-cn->https://token-plan-cn.xiaomimimo.com/v1xiaomi-token-plan-sgp->https://token-plan-sgp.xiaomimimo.com/v1xiaomi-token-plan-ams->https://token-plan-ams.xiaomimimo.com/v1
| Model ref | Input | Context | Max output | Reasoning | Notes |
|---|---|---|---|---|---|
xiaomi-token-plan/mimo-v2.5-pro | text | 1,048,576 | 32,000 | Yes | 默认模型 |
xiaomi-token-plan/mimo-v2.5 | text, image | 1,048,576 | 32,000 | Yes | 多模态 |
文本转语音
捆绑的xiaomi 插件还会将 Xiaomi MiMo 注册为 messages.tts 的语音提供方。它会调用 Xiaomi 的 chat-completions TTS 协议,将文本作为
assistant 消息,并将可选的风格指导作为 user 消息。
| Property | Value |
|---|---|
| TTS id | xiaomi (mimo 别名) |
| Auth | XIAOMI_API_KEY |
| API | POST /v1/chat/completions with audio |
| Default | mimo-v2.5-tts,voice mimo_default |
| Output | 默认输出 MP3;配置后为 WAV |
mimo_default、default_zh、default_en、
Mia、Chloe、Milo 和 Dean。预设语音模型使用 audio.voice,因此
OpenClaw 会为 mimo-v2.5-tts 和 mimo-v2-tts 发送 speakerVoice。
Xiaomi 的 voicedesign 模型 mimo-v2.5-tts-voicedesign 会根据自然语言风格提示
生成语音,而不是使用预设语音 id。使用所需的语音描述来配置
style;OpenClaw 会将其作为 user
消息发送,将待播报文本作为 assistant 消息发送,并且对该模型省略
audio.voice。
ffmpeg
将 Xiaomi 输出转码为 48kHz Opus。
配置示例
cost 和 compat,以避免与运行时行为不一致。
Token Plan:
cost。
自动注入行为
自动注入行为
当
XIAOMI_API_KEY 设置在环境中,或者存在认证配置文件时,xiaomi 提供方会自动注入。xiaomi-token-plan 需要区域 base URL,因此支持的路径是捆绑的 Token Plan onboarding 选项,或者显式的 models.providers.xiaomi-token-plan 配置块。模型详情
模型详情
- mimo-v2-flash — 轻量且快速,适合通用文本任务。不支持推理。
- mimo-v2-pro — 支持推理,拥有 100 万 token 的上下文窗口,适合长文档工作负载。
- mimo-v2-omni — 支持推理的多模态模型,可接受文本和图像输入。
- mimo-v2.5-pro — Xiaomi 当前 V2.5 推理栈的 Token Plan 默认模型。
- mimo-v2.5 — Token Plan 多模态 V2.5 路由。
按需付费模型使用
xiaomi/ 前缀。Token Plan 模型使用 xiaomi-token-plan/ 前缀。故障排除
故障排除
- 如果模型没有出现,请确认相关的密钥环境变量或认证配置文件已存在且有效。
- 对于 Token Plan,请确认所选 onboarding 区域与订阅页面的 base URL 一致,并且密钥以
tp-开头。 - 当 Gateway 作为守护进程运行时,请确保该进程可以访问密钥(例如在
~/.openclaw/.env中或通过env.shellEnv)。
相关内容
模型选择
选择提供方、模型引用以及故障转移行为。
配置参考
完整的 OpenClaw 配置参考。
Xiaomi MiMo 控制台
Xiaomi MiMo 仪表盘和 API 密钥管理。