GMI Cloud

GMI Cloud 是一个托管推理平台，为前沿模型和开放权重模型提供与 OpenAI 兼容的 API。在 OpenClaw 中，它是官方外部提供方插件：安装一次，通过常规模型认证存储凭据，即可使用类似 gmi/openai/gpt-5.6-sol 的模型引用。

当您希望通过一个 API 密钥使用多个托管模型系列（包括 GMI 目录中提供的 Anthropic、DeepSeek、Google、Moonshot、OpenAI 和 Z.AI 路由）时，可以使用 GMI。它可作为次要提供方用于模型回退、跨供应商比较托管路由，或在 GMI 比您的主要提供方更早提供某个模型时使用。OpenClaw 负责提供方 ID、认证配置文件、别名、模型目录初始列表和基础 URL；GMI 负责实时模型可用性、计费、速率限制以及任何提供方侧的路由策略。

Setup¶

安装插件，然后在 GMI Cloud（https://www.gmicloud.ai/）中创建 API 密钥：

openclaw plugins install @openclaw/gmi-provider

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。请参阅 应用更改并检查。

然后运行：

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

对于脚本化或 CI 安装，请在命令行中传入所有参数：

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice gmi-api-key \
  --gmi-api-key "$GMI_API_KEY"

或者改为在环境中设置密钥：

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：

该目录只是一个初始列表，并不保证每个账户随时都能调用每个模型。您可以在您的环境中列出已配置提供方报告的模型：

openclaw models list --provider gmi

Troubleshooting¶

• 401 或 403：请检查运行 OpenClaw 的进程是否设置了 GMI_API_KEY，或重新运行引导流程以将密钥存储在提供方认证配置文件中。
• 未知模型错误：请确认该模型存在于您的 GMI 账户中，并使用 openclaw models list --provider gmi 显示出的完整 gmi/<route-id> 引用。
• 提供方间歇性错误：请尝试其他 GMI 路由，或将 GMI 配置为回退提供方，而不是唯一的主要模型提供方。

Related¶

• 模型提供方
• 所有提供方