快速开始

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-cloudgmicloud
软件包 @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(https://www.gmicloud.ai/)中创建 API key:

bash
openclaw plugins install @openclaw/gmi-provideropenclaw gateway restart

然后运行:

bash
openclaw onboard --auth-choice gmi-api-key

非交互式设置可以传入 --gmi-api-key <key>,或设置:

bash
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
openclaw models list --provider gmi

故障排查

  • 401403:检查运行 OpenClaw 的进程是否已设置 GMI_API_KEY,或重新运行新手引导,将密钥存储在提供商身份验证配置文件中。
  • 未知模型错误:确认该模型存在于你的 GMI 账户中,并使用 openclaw models list --provider gmi 显示的完整 gmi/<route-id> 引用。
  • 间歇性提供商错误:尝试其他 GMI 路由,或将 GMI 配置为回退提供商,而不是唯一的主要模型提供商。

相关内容

Was this useful?
On this page

On this page