> ## 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.

# GMI Cloud

GMI Cloud 是一個託管式推論平台，透過相容 OpenAI 的 API 提供前沿與開放權重模型。
在 OpenClaw 中，它是官方的外部供應商外掛：只需安裝一次、透過一般模型驗證儲存認證資訊，
即可使用像 `gmi/google/gemini-3.1-flash-lite` 這樣的模型參照。

當你想以一組 API 金鑰使用多個託管模型系列時，可使用 GMI，其中包括 GMI
目錄所提供的 Anthropic、DeepSeek、Google、Moonshot、OpenAI 與 Z.AI 路由。
它可作為模型備援的次要供應商、用於比較不同廠商的託管路由，或在 GMI
比主要供應商更早提供某個模型時使用。OpenClaw 負責供應商 ID、驗證設定檔、別名、
模型目錄種子與基礎 URL；GMI 則負責即時模型可用性、計費、速率限制，以及任何供應商端的路由政策。

| 屬性     | 值                                  |
| ------ | ---------------------------------- |
| 供應商 ID | `gmi`（別名：`gmi-cloud`、`gmicloud`）   |
| 套件     | `@openclaw/gmi-provider`           |
| 驗證環境變數 | `GMI_API_KEY`                      |
| API    | 相容 OpenAI（`openai-completions`）    |
| 基礎 URL | `https://api.gmi-serving.com/v1`   |
| 預設模型   | `gmi/google/gemini-3.1-flash-lite` |

## 設定

安裝外掛、重新啟動閘道，然後在 GMI Cloud
（`https://www.gmicloud.ai/`）中建立 API 金鑰：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/gmi-provider
openclaw gateway restart
```

接著執行：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice gmi-api-key
```

非互動式設定可傳入 `--gmi-api-key <key>`，或設定：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export GMI_API_KEY="<your-gmi-api-key>" # pragma: allowlist secret
```

## 何時選擇 GMI

* 你想使用託管式且相容 OpenAI 的端點，而非本機模型伺服器。
* 你想透過單一供應商帳戶嘗試多個商業與開放權重模型系列。
* 你想要一個上游路由不同於 DeepInfra、OpenRouter、Together
  或廠商直接 API 的備援供應商。
* 你需要 GMI 專屬的模型 ID、定價或帳戶控制功能。

如果你需要 GMI 未透過其相容 OpenAI 路由公開的廠商原生功能，
請改選廠商的直接供應商。若資料在地性或本機 GPU 控制比託管便利性更重要，
請選擇 LM Studio、Ollama、SGLang 或 vLLM 等本機供應商。

## 模型

外掛目錄預先提供常見的 GMI Cloud 路由 ID：

| 模型參照                               | 輸入      | 上下文       | 最大輸出    |
| ---------------------------------- | ------- | --------- | ------- |
| `gmi/anthropic/claude-sonnet-4.6`  | 文字 + 圖片 | 200,000   | 64,000  |
| `gmi/deepseek-ai/DeepSeek-V3.2`    | 文字      | 163,840   | 65,536  |
| `gmi/google/gemini-3.1-flash-lite` | 文字 + 圖片 | 1,048,576 | 65,536  |
| `gmi/moonshotai/Kimi-K2.5`         | 文字 + 圖片 | 262,144   | 65,536  |
| `gmi/openai/gpt-5.4`               | 文字 + 圖片 | 400,000   | 128,000 |
| `gmi/zai-org/GLM-5.1-FP8`          | 文字      | 202,752   | 65,536  |

此目錄只是種子資料，並不保證每個帳戶都能隨時呼叫所有模型。
請列出已設定供應商在你的環境中回報的模型：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider gmi
```

## 疑難排解

* `401` 或 `403`：確認執行 OpenClaw 的程序已設定
  `GMI_API_KEY`，或重新執行初始設定，將金鑰儲存在供應商驗證設定檔中。
* 未知模型錯誤：確認你的 GMI 帳戶中存在該模型，並使用
  `openclaw models list --provider gmi` 顯示的完整 `gmi/<route-id>` 參照。
* 間歇性供應商錯誤：嘗試其他 GMI 路由，或將 GMI 設定為備援，
  而非唯一的主要模型供應商。

## 相關內容

* [模型供應商](/zh-TW/concepts/model-providers)
* [所有供應商](/zh-TW/providers/index)