OpenClaw GMI Cloud 提供商插件接入指南OpenAI 兼容 API 一键托管多厂商模型【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawGMI Cloud 是一个托管推理平台以 OpenAI 兼容 API 提供前沿与开源权重模型的托管推理服务。本指南介绍如何在 OpenClaw 中安装官方openclaw/gmi-provider插件、配置 API Key并通过gmi/openai/gpt-5.6-sol这类模型引用直接使用 GMI Cloud 的路由读完你将掌握从安装、认证、选模型到故障排查的完整闭环并理解该插件在 OpenClaw 源码中的注册机制。GMI Cloud 与 OpenClaw 的集成方式GMI Cloud 在 OpenClaw 中属于官方外部提供商插件安装一次之后凭证通过常规的模型认证流程provider auth profile存储之后即可通过gmi/route-id形式的模型引用直接调用 GMI Cloud 暴露的模型路由。使用 GMI 的核心价值在于一个 API Key 访问多个托管模型家族包括 Anthropic、DeepSeek、Google、OpenAI、Z.AI 等由 GMI 目录暴露的路由。它适合作为次要提供商用于模型回退fallback、跨厂商对比托管路由或在你的主提供商尚未提供某个模型时先行使用。属性值Provider idgmi别名gmi-cloud、gmicloud包名openclaw/gmi-provider认证环境变量GMI_API_KEYAPI 类型OpenAI 兼容openai-completionsBase URLhttps://api.gmi-serving.com/v1默认模型gmi/openai/gpt-5.6-sol从插件清单docs/plugins/plugin-inventory.md可以看到GMI Cloud 与 DeepInfra、OpenRouter、Together 等一样属于发布自有模型目录行publish their own model catalog rows的官方提供商插件因此无需在models.providers下手写模型条目——启用插件、设置认证、挑选模型即可详见 docs/concepts/model-providers/official-provider-plugins.md。安装与启动在 OpenClaw 中通过插件命令安装然后重启网关使插件生效openclaw plugins install openclaw/gmi-provider openclaw gateway restart插件包同时支持 npm 与 ClawHub 两条分发渠道ClawHub 上的安装标识为clawhub:openclaw/gmi-provider见 docs/plugins/reference/gmi.md 与 extensions/gmi/package.json。插件的install配置声明了 npm 为默认安装选择并要求宿主版本2026.6.8插件 API 兼容版本2026.9.3。配置 API Key 与认证在 GMI Cloud 控制台https://www.gmicloud.ai/创建 API Key 之后推荐用交互式引导完成认证openclaw onboard --auth-choice gmi-api-key非交互式环境可以直接传参或通过环境变量注入openclaw onboard --gmi-api-key keyexport GMI_API_KEYyour-gmi-api-key # pragma: allowlist secret认证方式在插件清单中声明得很明确extensions/gmi/openclaw.plugin.json认证方法为api-key认证项 id 为gmi-api-key选项键为gmiApiKeyCLI 参数为--gmi-api-key key并启用了appGuidedSecret应用引导式密钥存储。setup.providers只声明了一个环境变量GMI_API_KEY这与官方文档表格一致。注意export方式适合临时验证长期使用建议通过openclaw onboard将密钥写入提供商认证配置文件provider auth profile这样密钥不会散落在 shell 历史中。选择模型模型引用与目录安装并完成认证后OpenClaw 中的模型引用统一采用gmi/route-id形式例如 README 中给出的gmi/openai/gpt-5.6-sol。插件目录中预置seed了 GMI Cloud 常用路由模型引用输入上下文窗口最大输出gmi/anthropic/claude-sonnet-5text image409,600128,000gmi/deepseek-ai/DeepSeek-V4-Protext1,048,576384,000gmi/google/gemini-3.5-flash-litetext image1,048,57665,536gmi/openai/gpt-5.6-soltext image1,050,000128,000gmi/zai-org/GLM-5.2-FP8text1,048,576128,000这是来自 docs/providers/gmi.md 的常用路由表。插件清单 extensions/gmi/openclaw.plugin.json 的modelCatalog中还维护了更完整的目录行包含每个模型的路由 id、reasoning是否推理模型、输入模态、上下文窗口、最大输出以及按 GMI Cloud 计费口径记录的costinput/output/cacheRead/cacheWrite。目录中同时保留了几条已标记deprecated的旧路由如zai-org/GLM-5.1-FP8、deepseek-ai/DeepSeek-V3.2、anthropic/claude-sonnet-4.6并各自通过replacedBy指向新路由部分模型还带compat.codeMode: capable标记表示可胜任代码模式任务。目录只是种子不承诺每个账号随时可调用每个模型。要查看你的环境即你配置的账号实际能用的模型执行openclaw models list --provider gmi该命令读取已发布的模型清单不会启动模型发现或改写models.json如需在列表面前抓取提供商最新目录可加--refresh详见 docs/cli/models.md 中models list一节。GMI 插件的目录发现模式为refreshable可刷新这也是它支持--refresh抓取在线路由的基础。源码视角插件如何注册 GMIGMI 插件的入口 extensions/gmi/index.ts 仅约 40 行通过 SDK 的defineSingleProviderPluginEntry声明一个单提供商插件id: gmi名称 GMI Cloud Provider同时注册别名gmi-cloud、gmicloud认证提示信息指向 GMI Cloud 官网管理 API KeymanifestAuth目录行为discoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true并通过readConfiguredProviderCatalogEntries合并用户在配置中显式声明的目录行请求侧行为继承openai-compatible家族的 replay 钩子dropReasoningFromHistory: false即不回放历史中的推理内容并复用openai的工具兼容钩子——这正是OpenAI 兼容 API在行为层面的落点。插件清单 extensions/gmi/openclaw.plugin.json 补充了运行时细节activation.onStartup: false按需加载、enabledByDefault: true、providerEndpoints将gmi-native端点类绑定到主机api.gmi-serving.com三个 provider 别名统一映射到family: gmi。插件测试 extensions/gmi/index.test.ts 给出了可验证的契约注册后provider.id gmi、别名[gmi-cloud, gmicloud]、认证环境变量[GMI_API_KEY]、认证方式[api-key]、starter 模型gmi/openai/gpt-5.6-sol、Base URL 为https://api.gmi-serving.com/v1且静态目录中包含openai/gpt-5.6-sol。何时选择 GMI何时不选按 docs/providers/gmi.md 的官方建议适合 GMI需要托管型 OpenAI 兼容端点而非本地模型服务器希望通过一个提供商账号试用多个商业与开源权重模型家族需要一个上游路由与 DeepInfra、OpenRouter、Together 或厂商直连 API 不同的回退提供商需要 GMI 特有的模型 id、定价或账号控制能力。不适合 GMI需要 GMI 的 OpenAI 兼容路由未暴露的厂商原生特性时应选择对应厂商的直接提供商插件当数据本地性或本地 GPU 控制比托管便利更重要时应选择 LM Studio、Ollama、SGLang、vLLM 等本地提供商。故障排查401/403确认运行 OpenClaw 的进程已设置GMI_API_KEY或重新执行openclaw onboard把密钥写入提供商认证配置文件。未知模型错误确认该模型存在于你的 GMI 账号中并使用openclaw models list --provider gmi显示出的完整gmi/route-id引用模型引用在第一个/处切分 provider 前缀含/的模型 id 必须带前缀。间歇性提供商错误尝试换一条 GMI 路由或将 GMI 配置为回退提供商而非唯一主模型提供商。相关文档提供商完整文档docs/providers/gmi.md插件参考页docs/plugins/reference/gmi.md插件清单docs/plugins/plugin-inventory.md官方提供商插件概念docs/concepts/model-providers/official-provider-plugins.mdopenclaw models命令行参考docs/cli/models.mdopenclaw onboard认证引导参考docs/cli/onboard.md【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考