> ## 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 là nền tảng API cho các mô hình **MiMo**. OpenClaw bao gồm một Plugin Xiaomi được tích hợp sẵn với hai cấu hình sẵn nhà cung cấp văn bản: * `xiaomi` cho khóa trả theo mức dùng (`sk-...`) * `xiaomi-token-plan` cho khóa Token Plan (`tp-...`) với các cấu hình sẵn điểm cuối theo khu vực Cùng Plugin đó cũng đăng ký nhà cung cấp giọng nói (TTS) `xiaomi`. | Thuộc tính | Giá trị | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | ID nhà cung cấp | `xiaomi` (trả theo mức dùng), `xiaomi-token-plan` (Token Plan) | | Plugin | tích hợp sẵn, `enabledByDefault: true` | | Biến môi trường xác thực | `XIAOMI_API_KEY`, `XIAOMI_TOKEN_PLAN_API_KEY` | | Cờ onboarding | `--auth-choice xiaomi-api-key`, `--auth-choice xiaomi-token-plan-cn`, `--auth-choice xiaomi-token-plan-sgp`, `--auth-choice xiaomi-token-plan-ams` | | Cờ CLI trực tiếp | `--xiaomi-api-key `, `--xiaomi-token-plan-api-key ` | | Hợp đồng | chat completions + `speechProviders` | | API | tương thích OpenAI (`openai-completions`) | | URL cơ sở | Trả theo mức dùng: `https://api.xiaomimimo.com/v1`; cấu hình sẵn Token Plan: `token-plan-{cn,sgp,ams}...` | | Mô hình mặc định | `xiaomi/mimo-v2-flash`, `xiaomi-token-plan/mimo-v2.5-pro` | | TTS mặc định | `mimo-v2.5-tts`, giọng `mimo_default`; mô hình voicedesign `mimo-v2.5-tts-voicedesign` | ## Bắt đầu Tạo một khóa trả theo mức dùng trong [bảng điều khiển Xiaomi MiMo](https://platform.xiaomimimo.com/#/console/api-keys), hoặc mở trang đăng ký Token Plan của bạn rồi sao chép URL cơ sở tương thích OpenAI theo khu vực cùng khóa `tp-...` tương ứng. Trả theo mức dùng: ```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 ``` Hoặc truyền khóa trực tiếp: ```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 ``` ## Danh mục trả theo mức dùng | Tham chiếu mô hình | Đầu vào | Ngữ cảnh | Đầu ra tối đa | Suy luận | Ghi chú | | ---------------------- | ----------- | --------- | ------------- | -------- | ---------------- | | `xiaomi/mimo-v2-flash` | text | 262,144 | 8,192 | Không | Mô hình mặc định | | `xiaomi/mimo-v2-pro` | text | 1,048,576 | 32,000 | Có | Ngữ cảnh lớn | | `xiaomi/mimo-v2-omni` | text, image | 262,144 | 32,000 | Có | Đa phương thức | Tham chiếu mô hình mặc định là `xiaomi/mimo-v2-flash`. Nhà cung cấp được chèn tự động khi `XIAOMI_API_KEY` được đặt hoặc khi có hồ sơ xác thực. ## Danh mục Token Plan Chọn tùy chọn xác thực Token Plan khớp với URL cơ sở theo khu vực được hiển thị trong giao diện đăng ký của Xiaomi: * `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` | Tham chiếu mô hình | Đầu vào | Ngữ cảnh | Đầu ra tối đa | Suy luận | Ghi chú | | --------------------------------- | ----------- | --------- | ------------- | -------- | ---------------- | | `xiaomi-token-plan/mimo-v2.5-pro` | text | 1,048,576 | 131,072 | Có | Mô hình mặc định | | `xiaomi-token-plan/mimo-v2.5` | text, image | 1,048,576 | 131,072 | Có | Đa phương thức | Onboarding Token Plan xác thực định dạng khóa và cảnh báo khi khóa `tp-...` được nhập vào đường dẫn trả theo mức dùng, hoặc khóa `sk-...` được nhập vào đường dẫn Token Plan. ## Chuyển văn bản thành giọng nói Plugin `xiaomi` được tích hợp sẵn cũng đăng ký Xiaomi MiMo làm nhà cung cấp giọng nói cho `messages.tts`. Nó gọi hợp đồng TTS chat-completions của Xiaomi với văn bản dưới dạng tin nhắn `assistant` và hướng dẫn phong cách tùy chọn dưới dạng tin nhắn `user`. | Thuộc tính | Giá trị | | ---------- | ---------------------------------------- | | ID TTS | `xiaomi` (bí danh `mimo`) | | Xác thực | `XIAOMI_API_KEY` | | API | `POST /v1/chat/completions` với `audio` | | Mặc định | `mimo-v2.5-tts`, giọng `mimo_default` | | Đầu ra | MP3 theo mặc định; WAV khi được cấu hình | ```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.", }, }, }, }, } ``` Các giọng tích hợp được hỗ trợ bao gồm `mimo_default`, `default_zh`, `default_en`, `Mia`, `Chloe`, `Milo` và `Dean`. Các mô hình giọng đặt sẵn dùng `audio.voice`, nên OpenClaw gửi `speakerVoice` cho `mimo-v2.5-tts` và `mimo-v2-tts`. Mô hình voicedesign của Xiaomi, `mimo-v2.5-tts-voicedesign`, tạo giọng nói từ lời nhắc phong cách bằng ngôn ngữ tự nhiên thay vì ID giọng đặt sẵn. Cấu hình `style` bằng mô tả giọng mong muốn; OpenClaw gửi nó dưới dạng tin nhắn `user`, gửi văn bản được đọc dưới dạng tin nhắn `assistant` và bỏ qua `audio.voice` cho mô hình này. ```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.", }, }, }, }, } ``` Đối với các mục tiêu ghi chú giọng nói như Feishu và Telegram, OpenClaw chuyển mã đầu ra Xiaomi sang Opus 48kHz bằng `ffmpeg` trước khi gửi. ## Ví dụ cấu hình ```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, }, ], }, }, }, } ``` Giá và cờ tương thích đến từ manifest Plugin được tích hợp sẵn, nên ví dụ cấu hình bỏ qua `cost` và `compat` để tránh lệch khỏi hành vi runtime. 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, }, ], }, }, }, } ``` Giá đến từ manifest được tích hợp sẵn (các mô hình Token Plan bao gồm giá đọc bộ nhớ đệm theo bậc), nên ví dụ cấu hình bỏ qua `cost`. Nhà cung cấp `xiaomi` được chèn tự động khi `XIAOMI_API_KEY` được đặt trong môi trường của bạn hoặc khi có hồ sơ xác thực. `xiaomi-token-plan` cần URL cơ sở theo khu vực, nên đường dẫn được hỗ trợ là tùy chọn onboarding Token Plan được tích hợp sẵn hoặc khối cấu hình `models.providers.xiaomi-token-plan` rõ ràng. * **mimo-v2-flash** — nhẹ và nhanh, lý tưởng cho các tác vụ văn bản đa dụng. Không hỗ trợ suy luận. * **mimo-v2-pro** — hỗ trợ suy luận với cửa sổ ngữ cảnh 1M token cho khối lượng công việc tài liệu dài. * **mimo-v2-omni** — mô hình đa phương thức có hỗ trợ suy luận, chấp nhận cả đầu vào văn bản và hình ảnh. * **mimo-v2.5-pro** — mặc định của Token Plan với stack suy luận V2.5 hiện tại của Xiaomi. * **mimo-v2.5** — tuyến V2.5 đa phương thức của Token Plan. Các mô hình trả theo mức dùng sử dụng tiền tố `xiaomi/`. Các mô hình Token Plan sử dụng tiền tố `xiaomi-token-plan/`. * Nếu mô hình không xuất hiện, hãy xác nhận biến môi trường khóa liên quan hoặc hồ sơ xác thực hiện diện và hợp lệ. * Với Token Plan, hãy xác nhận khu vực onboarding đã chọn khớp với URL cơ sở trên trang đăng ký và khóa bắt đầu bằng `tp-`. * Khi Gateway chạy dưới dạng daemon, hãy đảm bảo khóa có sẵn cho tiến trình đó (ví dụ trong `~/.openclaw/.env` hoặc qua `env.shellEnv`). Các khóa chỉ được đặt trong shell tương tác của bạn sẽ không hiển thị với các tiến trình Gateway do daemon quản lý. Dùng cấu hình `~/.openclaw/.env` hoặc `env.shellEnv` để đảm bảo khả dụng lâu dài. ## Liên quan Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển dự phòng. Tài liệu tham khảo cấu hình OpenClaw đầy đủ. Bảng điều khiển Xiaomi MiMo và quản lý khóa API.