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 兼容的 chat completions(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;voicedesign 模型 mimo-v2.5-tts-voicedesign |
入门指南
获取正确的密钥
在 Xiaomi MiMo 控制台创建按量付费密钥,或打开你的 Token Plan 订阅页面,并复制区域 OpenAI 兼容基础 URL 以及匹配的
tp-... 密钥。按量付费目录
| 模型引用 | 输入 | 上下文 | 最大输出 | 推理 | 说明 |
|---|---|---|---|---|---|
xiaomi/mimo-v2-flash | text | 262,144 | 8,192 | 否 | 默认模型 |
xiaomi/mimo-v2-pro | text | 1,048,576 | 32,000 | 是 | 大上下文 |
xiaomi/mimo-v2-omni | text, image | 262,144 | 32,000 | 是 | 多模态 |
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 | text | 1,048,576 | 131,072 | 是 | 默认模型 |
xiaomi-token-plan/mimo-v2.5 | text, image | 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 的 chat-completions TTS 合约,将文本作为 assistant 消息,
并将可选风格指导作为 user 消息。
| 属性 | 值 |
|---|---|
| TTS ID | xiaomi(mimo 别名) |
| 认证 | XIAOMI_API_KEY |
| API | 带 audio 的 POST /v1/chat/completions |
| 默认值 | mimo-v2.5-tts,语音 mimo_default |
| 输出 | 默认 MP3;配置后为 WAV |
mimo_default, default_zh, default_en, Mia, Chloe,
Milo, Dean。预设语音模型(mimo-v2.5-tts, mimo-v2-tts)使用
audio.voice,因此 OpenClaw 会为这些模型发送 speakerVoice。
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 需要区域基础 URL,因此受支持的路径是内置 Token Plan 新手引导选项,或显式的 models.providers.xiaomi-token-plan 配置块。模型详情
模型详情
- mimo-v2-flash - 轻量且快速,适合通用文本任务。不支持推理。
- mimo-v2-pro - 支持推理,并提供 1M token 上下文窗口,适合长文档工作负载。
- mimo-v2-omni - 启用推理的多模态模型,同时接受文本和图像输入。
- mimo-v2.5-pro - Token Plan 默认模型,使用 Xiaomi 当前的 V2.5 推理栈。
- mimo-v2.5 - Token Plan 多模态 V2.5 路由。
按量付费模型使用
xiaomi/ 前缀。Token Plan 模型使用 xiaomi-token-plan/ 前缀。故障排查
故障排查
- 如果模型没有出现,请确认相关密钥环境变量或认证配置文件存在且有效。
- 对于 Token Plan,请确认选择的新手引导区域与订阅页面基础 URL 匹配,并且密钥以
tp-开头。 - 当 Gateway 网关 作为守护进程运行时,请确保该进程可以访问密钥(例如通过
~/.openclaw/.env或env.shellEnv)。
相关内容
模型选择
选择提供商、模型引用和故障转移行为。
Thinking 级别
/think 指令语法和级别映射。配置参考
完整的 OpenClaw 配置参考。
Xiaomi MiMo 控制台
Xiaomi MiMo 仪表板和 API 密钥管理。