安装

方式一：通过 Agent 安装

如果你正在使用 Claude Code、OpenClaw、Cursor 等 AI Agent，可以直接让 Agent 帮你完成安装与配置。复制以下提示词发送给 Agent：

请帮我接入 MiMo CLI（`https://github.com/ljj6600/MIMO-CLI`），按以下三步完成安装与配置：

1. 全局安装 CLI：执行 `npm install -g mimo-cli`，完成后用 `mimo --version` 验证
2. 登录并配置 API Key：执行 `mimo auth login --api-key sk-xxxxx`
3. 安装官方 SKILL：执行 `npx skills add ljj6600/MIMO-CLI -y -g`

完成后请执行 `mimo chat -m "你好"` 查看 MiMo 的回复，确认整体配置生效。

方式二：npm 手动全局安装（需 Node.js 18+）

1. 安装 MiMo CLI

在终端运行以下命令完成全局安装：

npm install -g mimo-cli

2. 登录 API Key

使用 API Key 完成鉴权（请将 sk-xxxxx 替换为你的 Key）：

mimo auth login --api-key sk-xxxxx

最新版 mimo-cli 会根据 Key 前缀自动检测类型并配置对应的接口地址，无需手动设置。

前往 MiMo 平台 获取密钥，支持两种类型：

• TokenPlan Key（tp- 开头）→ 申请地址，自动匹配 https://token-plan-cn.xiaomimimo.com/v1
• 按量计费 Key（sk- 开头）→ 申请地址，自动匹配 https://api.xiaomimimo.com/v1

3. 安装 SKILL（可选，推荐 Agent 用户）

若你要在 Claude Code、OpenClaw、Cursor 等 AI Agent 中调用 MiMo，建议加装官方 SKILL，Agent 调用时决策更准、无需临时翻 --help：

npx skills add ljj6600/MIMO-CLI -y -g

SKILL 会自动 symlink 到 ~/.claude/skills/、~/.openclaw/skills/ 等目录，各 Agent 下次启动即可识别。仅在终端直接使用 mimo 命令的用户可以跳过此步。

方式三：Windows 独立安装包（快速使用）

无需安装 Node.js，下载即用。

1. 前往 Releases 页面 下载 mimo-windows-x64.exe
2. 双击运行，自动完成安装并加入系统 PATH
3. 打开新的 cmd 或 PowerShell，输入 mimo 即可使用

安装路径为 %LOCALAPPDATA%\mimo\，不修改系统文件。如需卸载，在终端执行 mimo uninstall 即可清除。

新用户福利

如果你是 3 天内 注册 Xiaomi MiMo 开放平台的新用户，可领取专属体验金：

🎁 使用邀请码注册，即得 ¥10 API 体验金（40 天有效）

三步领取：

1. 点此注册
2. 完成账号注册
3. 登录控制台，在左下角「邀请码」处输入：6MEWY6

体验金适用于 MiMo 全部模型，包括对话、多模态理解、语音识别与合成等。

快速上手

# 对话
mimo chat -m "你好，介绍一下你自己"

# 交互式多轮对话
mimo repl

# 深度思考
mimo chat -m "分析一下量子计算的前景" --thinking

# 联网搜索
mimo chat -m "今天北京天气怎么样" --search

# 图片理解
mimo vision --image photo.jpg -p "描述这张图片"

# 视频理解（URL 模式，最大 300MB）
mimo vision --video https://example.com/video.mp4 -p "描述这个视频"

# 语音识别
mimo asr recording.wav

# 语音合成
mimo tts synthesize -t "你好世界" --voice 茉莉 --format mp3

# 声音克隆
mimo tts clone --sample voice.wav -t "这是克隆语音"

# 音色设计
mimo tts design --prompt "温柔的女声，语速较慢" -t "你好世界"

# 切换界面语言
mimo language en
mimo language zh

功能特性

• 对话补全 — 单轮与多轮对话，支持思维链推理与联网搜索（含地理位置）
• 多模态理解 — 图片、音频、视频内容理解（URL 模式最大 300MB）
• 语音识别 (ASR) — wav/mp3 音频转文字，支持流式输出
• 语音合成 (TTS) — 预设音色、声音克隆、自定义音色设计
• 深度思考 — --thinking 参数展示推理过程
• 联网搜索 — --search 参数，支持位置感知与关键词控制
• 流式输出 — 逐 token 实时输出，所见即所得
• 双 Key 管理 — 按量计费与 TokenPlan Key 一键切换
• 用量查询 — 套餐用量、账户余额、详细用量、月度账单、累计充值，一键掌握
• Cookie 自动获取 — 通过 CDP 协议从 Edge 浏览器自动获取平台 Cookie，无需手动操作
• 中英文界面 — 通过 mimo language en 自由切换
• 安全防护 — API Key 仅存本地、输出自动脱敏、路径遍历防护

命令参考

mimo chat

单轮对话，支持深度思考与联网搜索。

mimo chat -m "你好"                                 # 基础对话
mimo chat -m "分析量子计算" --thinking                # 深度思考
mimo chat -m "今天天气" --search --user-city 武汉      # 联网搜索
mimo chat -m "返回 JSON" --json --no-stream           # 结构化输出
mimo chat -m "写代码" --system "你是 Go 专家"          # 指定系统提示词

mimo repl

交互式多轮对话，自动维护对话上下文。

mimo repl                                           # 启动交互式对话
mimo repl --thinking --system "你是编程助手"          # 带系统提示词
mimo repl --search                                  # 联网搜索模式

mimo vision

多模态理解 — 图片、音频、视频。

mimo vision --image photo.jpg -p "描述这张图片"                # 图片理解
mimo vision --audio speech.mp3 -p "转述这段音频"               # 音频理解
mimo vision --video clip.mp4 -p "总结视频内容" --fps 1         # 视频理解（本地文件）
mimo vision --video https://example.com/v.mp4 -p "描述"       # 视频理解（URL 模式）
mimo vision --image a.jpg --audio b.mp3 -p "比较两者"         # 多模态组合

mimo asr

语音识别 — 将音频转为文字。

mimo asr recording.wav                                # 基础语音识别
mimo asr audio.mp3 --language zh                      # 指定语言
mimo asr --file recording.wav --language en            # 使用 --file 参数
mimo asr speech.wav --stream                          # 流式输出

mimo tts

语音合成 — 生成自然语音。

mimo tts synthesize -t "你好世界"                                 # 基础合成
mimo tts synthesize -t "Hello" --voice Mia --format mp3           # 指定音色和格式
mimo tts synthesize -t "温柔地说" --style "温柔、缓慢" --voice 茉莉 # 风格控制
mimo tts synthesize -t "文本" --out output.mp3                    # 指定输出路径
mimo tts voices                                                    # 查看可用音色
mimo tts clone --sample reference.wav -t "克隆语音"                # 声音克隆
mimo tts design --prompt "温柔的女声" -t "你好世界"                # 音色设计

mimo auth · mimo config

mimo auth login                    # 登录（保存 API Key）
mimo auth login --api-key sk-xxx   # 非交互式登录
mimo auth status                   # 查看认证状态
mimo auth logout                   # 登出
mimo auth cookie                   # 手动设置平台 Cookie（用于 quota 查询）

mimo config show                   # 查看当前配置
mimo config set --key timeout --value 600        # 设置超时时间
mimo config set --key active_key --value sk      # 切换使用的 Key

mimo quota

查询套餐用量与账户余额。自动根据当前 Key 类型选择查询内容：TokenPlan Key 查套餐用量，按量计费 Key 查账户余额。

mimo quota                         # 查询套餐用量（tp Key）或账户余额（sk Key）
mimo quota --cookie "serviceToken=...; userId=..."   # 指定 Cookie
mimo quota usage                   # 详细用量：Token 消耗、费用、插件调用、速率限制
mimo quota bill                    # 月度账单
mimo quota recharge                # 累计充值金额

Cookie 会通过 CDP 协议从 Edge 浏览器自动获取，无需手动复制粘贴。首次运行时自动启动 Edge 调试模式，检测并等待 platform.xiaomimimo.com 页面登录。Cookie 失效时自动清除并重新获取。也可通过 mimo auth cookie 手动设置。

mimo language · mimo update · mimo uninstall

mimo language zh                   # 切换为中文界面
mimo language en                   # 切换为英文界面
mimo update                        # 检查并更新到最新版本
mimo uninstall                     # 卸载 exe 安装版本（仅限 exe 安装方式）

SDK 编程接口

mimo-cli 也提供了完整的 TypeScript/JavaScript SDK，方便你将 MiMo 能力集成到自己的项目中。

import { MiMoSDK } from 'mimo-cli/sdk';

const sdk = new MiMoSDK({ apiKey: 'sk-xxx' });

// 对话
const result = await sdk.chat.chat({
  messages: [{ role: 'user', content: 'Hello' }],
  stream: false,
});

// 多模态理解
const vision = await sdk.vision.describe({
  image: 'https://example.com/photo.jpg',
  prompt: '描述这张图片',
});

// 语音识别
const asr = await sdk.asr.transcribe({
  file: 'data:audio/wav;base64,...',
  language: 'zh',
});

// 语音合成
const tts = await sdk.tts.synthesize({
  text: '你好世界',
  voice: '茉莉',
  format: 'mp3',
});

SDK 与 CLI 使用同一套底层 API 客户端，调用方式完全一致。

默认模型

| 能力 | 模型 | 说明 | |------|------|------| | 对话 | mimo-v2.5-pro | 常规对话、复杂推理、深度分析、长文档处理 | | 多模态 | mimo-v2.5 | 图片/音频/视频内容理解 | | 语音识别 | mimo-v2.5-asr | 语音转文字 | | 语音合成 | mimo-v2.5-tts | 文字转语音 | | 声音克隆 | mimo-v2.5-tts-voiceclone | 基于参考音频克隆声音 | | 音色设计 | mimo-v2.5-tts-voicedesign | 通过自然语言描述生成音色 |

配置

配置文件路径：~/.mimo/config.json

{
  "api_key": "sk-xxxxxxxx",
  "base_url": "https://api.xiaomimimo.com/v1",
  "output": "text",
  "timeout": 300,
  "default_model": "mimo-v2.5-pro",
  "language": "zh"
}

优先级顺序：命令行参数 > 环境变量 > 配置文件 > 内置默认值

环境变量

| 变量 | 说明 | |------|------| | MIMO_API_KEY | API 密钥 | | MIMO_BASE_URL | API 接口地址 | | MIMO_CONFIG_DIR | 配置目录（默认 ~/.mimo） | | MIMO_OUTPUT | 输出格式 (text/json) | | MIMO_TIMEOUT | 请求超时秒数 | | HTTPS_PROXY | 代理设置 |

安全

• API Key 仅存储在本地 ~/.mimo/config.json，权限 0o600
• 输出内容自动脱敏，防止 API Key 意外泄露
• 文件路径遍历防护
• 视频文件大小限制检测（Base64 ≤ 37.5MB / URL ≤ 300MB）

开发

# 安装依赖
bun install

# 开发模式（直接执行 TypeScript，无需构建）
bun run dev

# 构建（输出到 dist/）
bun run build

# 构建 Windows 独立可执行文件
bun run build:exe

# 类型检查
bun run typecheck

# 代码检查
bun run lint

架构

CLI 层 (Commands)         ← 你执行的 mimo xxx 命令
SDK 层 (编程接口)          ← 也可以通过 TypeScript 调用
API 客户端层 (Client)      ← OpenAI 兼容协议，便于切换
MiMo AI Platform API      ← 小米大模型能力

License

MIT