> ## 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 key 访问多个托管模型系列时，可以使用 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` |

## 设置

安装插件，重启 Gateway 网关，然后在 GMI Cloud 中创建 API key（`https://www.gmicloud.ai/`）：

```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 等本地提供商。

## Models

插件目录会预置常用的 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`，或重新运行新手引导，将 key 存储到提供商凭证配置中。
* 未知模型错误：确认该模型存在于你的 GMI 账户中，并使用 `openclaw models list --provider gmi` 显示的完整 `gmi/<route-id>` 引用。
* 间歇性提供商错误：尝试不同的 GMI 路由，或将 GMI 配置为回退提供商，而不是唯一的主要模型提供商。

## 相关

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