小米 MiMo
通过 OpenClaw 使用小米 MiMo 按量付费和 Token Plan 模型
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 xiaomi
openclaw models list --provider xiaomi-token-plan新手引导会验证密钥格式,并在将 tp-... 密钥输入按量付费流程,或将 sk-... 密钥输入 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 默认模型。
按量付费模型使用 xiaomi/ 前缀。Token Plan 模型使用 xiaomi-token-plan/ 前缀。
故障排除
- 如果模型未显示,请确认相关密钥环境变量或身份验证配置文件存在且有效。
- 对于 Token Plan,请确认所选的新手引导区域与订阅页面的基础 URL 匹配,并且密钥以
tp-开头。 - 当 Gateway 网关以守护进程形式运行时,请确保该进程可以使用密钥(例如在
~/.openclaw/.env中或通过env.shellEnv)。
仅在交互式 shell 中设置的密钥对守护进程管理的 Gateway 网关进程不可见。使用 ~/.openclaw/.env 或 env.shellEnv 配置以确保密钥持久可用。
相关内容
- 模型选择:选择提供商、模型引用和故障转移行为。
- 思考级别:
/think指令语法和级别映射。 - 配置参考:完整的 OpenClaw 配置参考。
- Xiaomi MiMo 控制台:Xiaomi MiMo 仪表板和 API 密钥管理。