Skip to main content
GMI Cloud is a hosted inference platform for frontier and open-weight models behind an OpenAI-compatible API. In OpenClaw it is an official external provider plugin: install it once, store credentials through normal model auth, and use model refs like gmi/openai/gpt-5.6-sol. 当你希望用一个 API 密钥访问多个托管模型系列时,可以使用 GMI,包括 Anthropic、DeepSeek、Google、Moonshot、OpenAI 和 Z.AI 等由 GMI 目录 暴露的路由。它可作为模型回退的次级提供方,用于比较 不同厂商之间的托管路由,或在 GMI 已提供某个模型而你的 主提供方尚未提供时使用。OpenClaw 负责提供方 id、认证配置文件、别名、 模型目录种子和基础 URL;GMI 负责实时模型可用性、计费、 速率限制以及任何提供方侧路由策略。

设置

安装插件,重启网关,然后在 GMI Cloud (https://www.gmicloud.ai/)中创建一个 API key:
然后运行:
非交互式设置可以传入 --gmi-api-key <key>,或设置:

何时选择 GMI

  • 你需要的是托管的 OpenAI 兼容端点,而不是本地模型服务器。
  • 你希望通过一个提供商账号尝试多个商业和开源权重模型系列。
  • 你需要一个备用提供商,其上游路由不同于 DeepInfra、OpenRouter、Together 或直接的供应商 API。
  • 你需要 GMI 特定的模型 ID、定价或账户控制。
当你需要 GMI 通过其 OpenAI 兼容路径无法提供的供应商原生功能时,请改为选择直接的供应商提供商。当数据本地性或本地 GPU 控制比托管带来的便利更重要时,请选择本地提供商,例如 LM Studio、Ollama、SGLang 或 vLLM。

模型

插件目录种子通常可用的 GMI Cloud 路由 ID: 目录只是一个种子,并不保证每个账号在任何时候都能调用每个模型。请列出你环境中配置的提供方所报告的内容:

故障排查

  • 401403:检查运行 OpenClaw 的进程是否设置了 GMI_API_KEY,或重新运行 onboarding 将密钥存入提供方认证配置文件。
  • 未知模型错误:确认该模型存在于你的 GMI 账户中,并使用 openclaw models list --provider gmi 显示的完整 gmi/<route-id> 引用。
  • 间歇性提供方错误:尝试不同的 GMI 路由,或将 GMI 配置为备用项,而不是唯一的主模型提供方。

相关内容