跳转至

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 <key>, --xiaomi-token-plan-api-key <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.6-pro, xiaomi-token-plan/mimo-v2.6-pro
TTS 默认 mimo-v2.5-tts,音色 mimo_default;voicedesign 模型 mimo-v2.5-tts-voicedesign

快速开始

1. 安装插件

openclaw plugins install @openclaw/xiaomi-provider

安装会自动应用到正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。

2. 获取正确的密钥

在 Xiaomi MiMo 控制台 中创建按量付费密钥,或打开你的 Token Plan 订阅页面,复制区域 OpenAI 兼容基础 URL 以及对应的 tp-... 密钥。

3. 运行入门配置

按量付费:

openclaw onboard --auth-choice xiaomi-api-key

Token Plan:

openclaw onboard --auth-choice xiaomi-token-plan-sgp

或直接传入密钥:

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"

4. 验证模型可用

openclaw models list --provider xiaomi
openclaw models list --provider xiaomi-token-plan

Tip

入门配置会验证密钥格式,并在将 tp-... 密钥输入到按量付费路径,或将 sk-... 密钥输入到 Token Plan 路径时发出警告。

按量付费目录

模型引用 输入 上下文 最大输出 推理 备注
xiaomi/mimo-v2.6-pro 文本、图像 1,048,576 131,072 是 默认旗舰
xiaomi/mimo-v2.6-flash 文本、图像 1,048,576 131,072 是 高效模型
xiaomi/mimo-v2.6-pro-ultraspeed 文本、图像 1,048,576 131,072 是 输出速度最高 20 倍
xiaomi/mimo-v2.5 文本、图像 1,048,576 131,072 是 上一代
xiaomi/mimo-v2.5-pro 文本 1,048,576 131,072 是 上一代

Token Plan 目录

Token Plan 设置会保存连接设置和别名,而不会将生成的目录行复制到你的配置中。 显式 models.mode: "replace" 会保持目录填充启用;自定义模型行保持不变。

选择与 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.6-pro 文本、图像 1,048,576 131,072 是 默认模型
xiaomi-token-plan/mimo-v2.6-flash 文本、图像 1,048,576 131,072 是 高效模型
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.5 和 V2.6 文本模型支持 OpenClaw 的 /think 指令,级别包括 off、 minimal、low、medium、high、xhigh 和 max(默认 high)。

文本转语音

xiaomi 插件还会将 Xiaomi MiMo 注册为 tts 的语音提供程序。它调用小米的 chat-completions TTS 接口契约,将文本作为 assistant 消息,将可选的风格指导作为 user 消息。

属性 值
TTS ID xiaomi(mimo 别名)
认证 XIAOMI_API_KEY
API POST /v1/chat/completions 带 audio
默认 mimo-v2.5-tts,语音 mimo_default
输出 默认 MP3;配置后为 WAV
{
  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 使用 audio.voice,因此 OpenClaw 会为该模型发送 speakerVoice。

语音设计模型 mimo-v2.5-tts-voicedesign 会根据自然语言风格提示生成语音,而不是使用预设语音 ID。将 style 设置为所需的语音描述;OpenClaw 会将其作为 user 消息发送,将朗读文本作为 assistant 消息发送,并在此模型中省略 audio.voice。

{
  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 将小米输出转码为 48kHz 单声道 Opus。

配置示例

{
  env: { vars: { XIAOMI_API_KEY: "your-key" } },
  agents: { defaults: { model: { primary: "xiaomi/mimo-v2.6-pro" } } },
  models: {
    mode: "merge",
    providers: {
      xiaomi: {
        baseUrl: "https://api.xiaomimimo.com/v1",
        api: "openai-completions",
        apiKey: "XIAOMI_API_KEY",
        models: [
          {
            id: "mimo-v2.6-pro",
            name: "Xiaomi MiMo V2.6 Pro",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
          {
            id: "mimo-v2.6-flash",
            name: "Xiaomi MiMo V2.6 Flash",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

价格和兼容标志来自插件清单,因此配置示例省略 cost 和 compat,以避免与运行时行为不一致。

Token Plan:

{
  env: { vars: { XIAOMI_TOKEN_PLAN_API_KEY: "tp-your-key" } },
  agents: { defaults: { model: { primary: "xiaomi-token-plan/mimo-v2.6-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.6-pro",
            name: "Xiaomi MiMo V2.6 Pro",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
          {
            id: "mimo-v2.6-flash",
            name: "Xiaomi MiMo V2.6 Flash",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

Token Plan 按固定订阅的 Credits 计费,而不是按 token 的 USD 定价,因此其目录行使用零 USD 成本,并且配置示例省略 cost。

自动注入行为

当环境中设置了 XIAOMI_API_KEY 或存在认证配置文件时,xiaomi 提供程序会自动启用。xiaomi-token-plan 需要区域性基础 URL,因此受支持的路径是 Token Plan 入门选择或显式的 models.providers.xiaomi-token-plan 配置块。

模型详情
- **mimo-v2.6-pro** - 旗舰推理模型,也是两个提供程序的默认模型。
- **mimo-v2.6-flash** - 高效的按量付费和 Token Plan 路由。
- **mimo-v2.6-pro-ultraspeed** - 按量付费旗舰路由,输出速度最高可达 20 倍。
- **mimo-v2.5** 和 **mimo-v2.5-pro** - 上一代兼容路由。

Note

按量付费模型使用 xiaomi/ 前缀。Token Plan 模型使用 xiaomi-token-plan/ 前缀。

故障排查
- 如果模型未出现,请确认相关密钥环境变量或认证配置文件存在且有效。
- 对于 Token Plan,请确认所选入门区域与订阅页面基础 URL 匹配,并且密钥以 `tp-` 开头。
- 当 Gateway 作为守护进程运行时,请确保密钥对该进程可用(例如在 `~/.openclaw/.env` 中或通过 `env.shellEnv`)。

Warning

仅在交互式 shell 中设置的密钥对守护进程管理的 Gateway 进程不可见。请使用 ~/.openclaw/.env 或 env.shellEnv 配置以实现持久可用。

模型选择

选择提供程序、模型引用和故障转移行为。

思考级别

/think 指令语法和级别映射。

配置参考

完整的 OpenClaw 配置参考。

Xiaomi MiMo 控制台

Xiaomi MiMo 仪表板和 API 密钥管理。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw