# 小米 MiMo > 通过 OpenClaw 使用小米 MiMo 按量付费和 Token Plan 模型 - 网址：https://funcoding.ai/agents/openclaw/providers/xiaomi/ - 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11 - 官方原文：https://docs.openclaw.ai/zh-CN/providers/xiaomi --- 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 `、`--xiaomi-token-plan-api-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 控制台](https://platform.xiaomimimo.com/#/console/api-keys)中创建按量付费密钥，或打开 Token Plan 订阅页面，复制区域 OpenAI 兼容基础 URL 以及匹配的 `tp-...` 密钥。 **运行新手引导** 按量付费： ```bash openclaw onboard --auth-choice xiaomi-api-key ``` Token Plan： ```bash openclaw onboard --auth-choice xiaomi-token-plan-sgp ``` 或直接传入密钥： ```bash 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" ``` **验证模型是否可用** ```bash 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` 指令](https://funcoding.ai/agents/openclaw/tools/thinking/)，级别包括 `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 | ```json5 { 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`。 ```json5 { tts: { provider: "xiaomi", providers: { xiaomi: { model: "mimo-v2.5-tts-voicedesign", format: "wav", style: "温暖、自然、发音清晰的女性声音。", }, }, }, } ``` 对于请求语音消息合成目标的渠道（Discord、Feishu、 Matrix、Telegram 和 WhatsApp），OpenClaw 会在交付前使用 `ffmpeg` 将 Xiaomi 输出转码为 48kHz 单声道 Opus。 ## 配置示例 ```json5 { 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： ```json5 { 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` 配置以确保密钥持久可用。
## 相关内容 - [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。 - [思考级别](https://funcoding.ai/agents/openclaw/tools/thinking/)：`/think` 指令语法和级别映射。 - [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：完整的 OpenClaw 配置参考。 - [Xiaomi MiMo 控制台](https://platform.xiaomimimo.com)：Xiaomi MiMo 仪表板和 API 密钥管理。