> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt > Use this file to discover all available pages before exploring further. # Xiaomi MiMo Xiaomi MiMo 是 **MiMo** 模型的 API 平台。官方外部 `xiaomi` 插件注册了两个文本提供商和一个语音（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`；voicedesign 模型 `mimo-v2.5-tts-voicedesign` | ## 开始使用 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/xiaomi-provider openclaw gateway restart ``` 在 [小米 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 ``` Onboarding 会验证密钥格式，并在将 `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 订阅界面中显示的区域 base URL 匹配的 Token Plan 认证选项： | 认证选项 | Base 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` 需要区域 base URL 才能解析。支持的方式是选择 Token Plan 开通选项，或使用将 `baseUrl` 设置为相应值的显式 `models.providers.xiaomi-token-plan` 配置块；若不采用上述任一方式，则不会提供该提供商。 ## 推理模型 `mimo-v2.5` 和 `mimo-v2.5-pro` 支持 OpenClaw 的 [`/think 指令`](/tools/thinking)，其级别包括 `off`、 `minimal`、`low`、`medium`、`high`、`xhigh` 和 `max`（默认 `high`）。 ## 文本转语音 `xiaomi` 插件还会将 Xiaomi MiMo 注册为 `tts` 的语音提供商。 它会调用小米的聊天补全 TTS 接口契约，将文本作为 `assistant` 消息发送，并将可选的风格指导作为 `user` 消息发送。 | 属性 | 值 | | ------ | --------------------------------------- | | TTS 标识 | `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"}} { 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`。 voicedesign 模型 `mimo-v2.5-tts-voicedesign` 会根据自然语言风格提示词生成语音，而不是使用预设语音 id。将 `style` 设为所需的语音描述；OpenClaw 会将其作为 `user` 消息发送，将朗读文本作为 `assistant` 消息发送，并且对该模型省略 `audio.voice`。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { env: { vars: { 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: "小米 MiMo V2.5", reasoning: true, input: ["text", "image"], contextWindow: 1048576, maxTokens: 131072, }, { id: "mimo-v2.5-pro", name: "小米 MiMo V2.5 Pro", reasoning: true, input: ["text"], contextWindow: 1048576, maxTokens: 131072, }, ], }, }, }, } ``` 定价和兼容性标志来自插件清单，因此配置示例省略了 `cost` 和 `compat`，以避免与运行时行为不一致。 Token Plan： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { env: { vars: { 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: "小米 MiMo V2.5 Pro", reasoning: true, input: ["text"], contextWindow: 1048576, maxTokens: 131072, }, { id: "mimo-v2.5", name: "小米 MiMo V2.5", reasoning: true, input: ["text", "image"], contextWindow: 1048576, maxTokens: 131072, }, ], }, }, }, } ``` Token Plan 按固定订阅的 Credits 额度计费，而不是按每个 Token 的美元价格计费，因此其目录条目使用零美元成本，配置示例省略了 `cost`。 当环境中设置了 `XIAOMI_API_KEY` 或存在认证配置文件时，会自动启用 `xiaomi` 提供商。`xiaomi-token-plan` 需要区域专用的 base URL，因此支持的方式是选择 Token Plan onboarding，或显式配置 `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，请确认所选 onboarding 区域与订阅页面的 base URL 一致，并且密钥以 `tp-` 开头。 * 当 Gateway 作为守护进程运行时，请确保该进程可以访问密钥（例如在 `~/.openclaw/.env` 中或通过 `env.shellEnv`）。 仅在交互式 shell 中设置的密钥对由守护进程管理的 Gateway 进程不可见。请使用 `~/.openclaw/.env` 或 `env.shellEnv` 配置以实现持久可用。 ## 相关内容 选择提供方、模型引用以及故障转移行为。 `/think` 指令语法和层级映射。 OpenClaw 完整配置参考。 Xiaomi MiMo 仪表盘和 API 密钥管理。