> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Xiaomi 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 `, `--xiaomi-token-plan-api-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 控制台](https://platform.xiaomimimo.com/#/console/api-keys)创建按量付费密钥，或打开你的 Token Plan 订阅页面，并复制区域 OpenAI 兼容基础 URL 以及匹配的 `tp-...` 密钥。 按量付费： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice xiaomi-api-key ``` Token Plan： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice xiaomi-token-plan-sgp ``` 或直接传入密钥： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider xiaomi openclaw models list --provider xiaomi-token-plan ``` 新手引导会验证密钥格式，并在 `tp-...` 密钥输入到按量付费路径，或 `sk-...` 密钥输入到 Token Plan 路径时发出警告。 ## 按量付费目录 | 模型引用 | 输入 | 上下文 | 最大输出 | 推理 | 说明 | | ---------------------- | ----------- | --------- | ------ | -- | ---- | | `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` 指令](/zh-CN/tools/thinking)，级别包括 `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 | ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { messages: { tts: { auto: "always", provider: "xiaomi", providers: { xiaomi: { apiKey: "xiaomi_api_key", model: "mimo-v2.5-tts", speakerVoice: "mimo_default", format: "mp3", style: "Bright, natural, conversational tone.", }, }, }, }, } ``` 内置语音：`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`。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { messages: { tts: { provider: "xiaomi", providers: { xiaomi: { model: "mimo-v2.5-tts-voicedesign", format: "wav", style: "Warm, natural female voice with clear pronunciation.", }, }, }, }, } ``` 对于请求语音便签合成目标的渠道（Discord、Feishu、Matrix、Telegram 和 WhatsApp）， OpenClaw 会在交付前使用 `ffmpeg` 将 Xiaomi 输出转码为 48kHz 单声道 Opus。 ## 配置示例 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { env: { XIAOMI_API_KEY: "your-key" }, agents: { defaults: { model: { primary: "xiaomi/mimo-v2-flash" } } }, models: { mode: "merge", providers: { xiaomi: { baseUrl: "https://api.xiaomimimo.com/v1", api: "openai-completions", apiKey: "XIAOMI_API_KEY", models: [ { id: "mimo-v2-flash", name: "Xiaomi MiMo V2 Flash", reasoning: false, input: ["text"], contextWindow: 262144, maxTokens: 8192, }, { id: "mimo-v2-pro", name: "Xiaomi MiMo V2 Pro", reasoning: true, input: ["text"], contextWindow: 1048576, maxTokens: 32000, }, { id: "mimo-v2-omni", name: "Xiaomi MiMo V2 Omni", reasoning: true, input: ["text", "image"], contextWindow: 262144, maxTokens: 32000, }, ], }, }, }, } ``` 价格和兼容性标志来自内置插件清单，因此配置示例省略了 `cost` 和 `compat`，以避免与运行时行为产生偏差。 Token Plan： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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-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`）。 仅在交互式 shell 中设置的密钥对守护进程管理的 Gateway 网关 进程不可见。使用 `~/.openclaw/.env` 或 `env.shellEnv` 配置来保持持久可用。 ## 相关内容 选择提供商、模型引用和故障转移行为。 `/think` 指令语法和级别映射。 完整的 OpenClaw 配置参考。 Xiaomi MiMo 仪表板和 API 密钥管理。