提供商
小米 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.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: "明亮、自然、对话式的语调。", }, }, },}内置语音: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: "温暖、自然、发音清晰的女性声音。", }, }, },}对于请求语音消息合成目标的渠道(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-开头。 - 当 Gateway 网关以守护进程形式运行时,请确保该进程可以使用密钥(例如在
~/.openclaw/.env中或通过env.shellEnv)。