--- read_when: - 你想在 OpenClaw 中使用小米 MiMo 模型 - 你需要设置 Xiaomi MiMo 身份验证或 Token Plan summary: 在 OpenClaw 中使用 Xiaomi MiMo 按量付费和 Token Plan 模型 title: 小米 MiMo x-i18n: generated_at: "2026-07-11T20:54:32Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: e6b91ead3e4a32a93bca7e02476b8de11137e8a5b5fa434bad8187bc1b204856 source_path: providers/xiaomi.md workflow: 16 --- 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-flash`、`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-...` 密钥，或在 Token Plan 流程中输入 `sk-...` 密钥，则会发出警告。 ## 按量付费模型目录 | 模型引用 | 输入 | 上下文 | 最大输出 | 推理 | 备注 | | ---------------------- | ----------- | --------- | ---------- | --------- | ------------- | | `xiaomi/mimo-v2-flash` | 文本 | 262,144 | 8,192 | 否 | 默认模型 | | `xiaomi/mimo-v2-pro` | 文本 | 1,048,576 | 32,000 | 是 | 大上下文 | | `xiaomi/mimo-v2-omni` | 文本、图像 | 262,144 | 32,000 | 是 | 多模态 | ## Token Plan 模型目录 选择与 Xiaomi 订阅界面中所示区域基础 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 新手引导选项，或者显式配置 设置了 `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 的聊天补全 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 { 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`。 语音设计模型 `mimo-v2.5-tts-voicedesign` 根据自然语言风格提示 生成语音，而不是使用预设语音 ID。将 `style` 设置为所需的语音描述； OpenClaw 会将其作为 `user` 消息发送，将要朗读的文本作为 `assistant` 消息发送，并为此模型省略 `audio.voice`。 ```json5 { 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 输出转码为 48 kHz 单声道 Opus。 ## 配置示例 ```json5 { 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 { 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**——支持推理，并提供 100 万 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 密钥管理。