OpenClaw 接入 NovitaAI基于 OpenAI 兼容 API 的官方 Provider 插件完整指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本指南围绕 OpenClaw 官方外部插件openclaw/novita-provider展开讲解如何将 NovitaAI 的 OpenAI 兼容托管推理服务接入 OpenClaw Gateway涵盖插件安装、API Key 认证、novita/route-id模型引用格式、内置模型目录与选型建议以及 401/403 与未知模型等常见问题的排查方法。读完本文你将能够独立完成 NovitaAI 提供商的启用、认证、默认模型设置与故障诊断。NovitaAI 与 OpenClaw 的集成方式NovitaAI 是一个托管的 AI 基础设施提供商对外提供 OpenAI 兼容的 API。OpenClaw 通过官方外部插件openclaw/novita-provider提供对 NovitaAI 的支持插件入口位于 extensions/novita/index.ts其注册信息定义在 extensions/novita/openclaw.plugin.json。从源码结构看该插件使用 Plugin SDK 的defineSingleProviderPluginEntry完成注册extensions/novita/index.ts并声明了以下关键属性Provider idnovita别名novita-ai、novitaai在模型引用与 CLI 中均可使用文档路径/providers/novita即仓库中的 docs/providers/novita.md模型目录行为discoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true允许显式指定 Base URL并支持实时模型发现请求兼容层通过buildProviderReplayFamilyHooks以openai-compatible家族接入并用buildProviderToolCompatFamilyHooks(openai)复用 OpenAI 的工具调用兼容逻辑插件配置extensions/novita/openclaw.plugin.json进一步声明了它归属于models类别、默认启用enabledByDefault: true、在启动时不主动激活onStartup: false即按需加载并将api.novita.ai主机映射到novita-native端点类别。安装插件NovitaAI 通过外部插件提供需要显式安装后重启 Gateway 才能生效openclaw plugins install openclaw/novita-provider openclaw gateway restart根据 extensions/novita/package.json 中的发布声明该插件同时发布到 NPMnpmSpec: openclaw/novita-provider与 ClawHubclawhubSpec: clawhub:openclaw/novita-provider默认安装源为 NPM并要求宿主版本不低于2026.7.2、Plugin API 不低于2026.9.3。插件自述文件见 extensions/novita/README.md。认证创建 API Key 并写入 OpenClawNovitaAI 使用 API Key 认证。首先在 Novita 的密钥管理页面创建 API Key然后在 OpenClaw 中完成认证openclaw onboard --auth-choice novita-api-key也可以直接通过环境变量注入export NOVITA_API_KEYyour-novita-api-key # pragma: allowlist secret认证选项novita-api-key在插件清单的providerAuthChoices中定义extensions/novita/openclaw.plugin.json认证方式为api-key对应 CLI 参数为--novita-api-key key配置选项键为novitaApiKey并标记为appGuidedSecret应用引导式密钥可在控制界面安全录入。插件在setup.providers中声明其唯一需要的环境变量就是NOVITA_API_KEY。插件测试用例extensions/novita/index.test.ts验证了认证配置的完整性注册后的 provider 环境变量为[NOVITA_API_KEY]认证方式仅含api-key且推荐的起始模型为novita/deepseek/deepseek-v4-pro。核心参数一览以下是 OpenClaw 官方文档 docs/providers/novita.md 给出的 NovitaAI 默认参数与插件清单中的声明一致设置项值插件名openclaw/novita-providerProvider idnovita别名novita-ai、novitaaiBase URLhttps://api.novita.ai/openai/v1环境变量NOVITA_API_KEY默认模型novita/deepseek/deepseek-v4-pro其中 Base URL 与默认模型在插件清单的modelCatalog.providers.novita节点中定义extensions/novita/openclaw.plugin.jsonAPI 形态为openai-completions即走 OpenAI 兼容的 Completions 协议。模型目录的发现策略标记为refreshable可通过 CLI 刷新获取 Novita 当前实际可用的模型列表。模型引用格式与默认模型设置OpenClaw 的模型引用统一使用provider/model形式参见 docs/concepts/model-providers/quick-rules.md 中的 Model refs 规则。NovitaAI 的模型引用采用novita/route-id形式例如novita/deepseek/deepseek-v4-pronovita/moonshotai/kimi-k3要将 Novita 模型设为默认模型可以在配置中写入agents.defaults.model.primary{ agents: { defaults: { model: { primary: novita/deepseek/deepseek-v4-pro } } }, }更推荐使用 CLI 完成选择并可随时核对当前生效的模型与认证状态命令参考 docs/cli/models.mdopenclaw models list --provider novita openclaw models set novita/deepseek/deepseek-v4-pro openclaw models status需要注意models list --provider novita返回的是 Novita 当前实际可用的路由应以它返回的精确novita/route-id为准。另外为其他提供商添加认证并不会改变你已配置的 primary 模型如需主动切换默认模型请使用openclaw models set provider/model或openclaw models auth login --provider id --set-default。内置模型目录详解插件内置的静态模型目录定义在 extensions/novita/openclaw.plugin.json。官方文档 docs/providers/novita.md 将其作为出发点列出以下表格在此基础上补充了上下文窗口、输出上限、成本字段与输入模态等源码细节模型引用novita/前缀后名称推理输入上下文窗口最大输出成本input/output/cacheRead/cacheWrite备注moonshotai/kimi-k3Kimi K3是文本图像104857610485763 / 15 / 0.3 / 0codeMode: capablemoonshotai/kimi-k2.7-codeKimi K2.7 Code是文本图像2621442621440.95 / 4 / 0.19 / 0—minimax/minimax-m3MiniMax M3是文本图像10000001310720.3 / 1.2 / 0.06 / 0—zai-org/glm-5.2GLM-5.2是文本10485761310721.4 / 4.4 / 0.26 / 0codeMode: capabledeepseek/deepseek-v4-proDeepSeek V4 Pro是文本10485763932161.6 / 3.2 / 0.135 / 0codeMode: capable默认模型deepseek/deepseek-v4-flashDeepSeek V4 Flash是文本10485763932160.14 / 0.28 / 0.028 / 0codeMode: capableqwen/qwen3.7-maxQwen3.7-Max是文本1000000655361.25 / 3.75 / 0.25 / 0—minimax/minimax-m2.7MiniMax M2.7是文本2048001310720.3 / 1.2 / 0.06 / 0已弃用由 minimax-m3 取代关于上表的几点说明上下文窗口与输出上限contextWindow声明模型的原生上下文长度maxTokens声明该模型的最大输出 token 容量单位均为 token。成本字段input、output、cacheRead、cacheWrite为目录中记录的计价数字供 OpenClaw 内部成本核算使用具体计费口径以 NovitaAI 平台为准。弃用兼容项minimax/minimax-m2.7在目录中标记为status: deprecated并被replacedBy: minimax/minimax-m3取代仍然可被选择以兼容旧配置但会从模型选择器中隐藏。Code 模式标记了compat.codeMode: capable的模型Kimi K3、GLM-5.2、DeepSeek V4 Pro/Flash声明了对编码模式的兼容能力。官方文档同时强调这个目录只是起始参考不是实时目录。你的账号、所在区域或 Novita 当前的供给可能增删或限制某些路由。在设置长期默认模型之前请先运行openclaw models list --provider novita核对。何时选择 NovitaAI根据 docs/providers/novita.md 的建议以下场景适合选用 NovitaAI需要托管式开源权重模型的访问且希望使用 OpenAI 兼容 API 接入希望用一个提供商账号同时路由DeepSeek、Kimi、MiniMax、GLM、Qwen家族的模型需要一个除 DeepInfra、GMI、OpenRouter 或各家厂商直连 API 之外的托管回退路径fallback希望由提供商侧托管模型而非自行维护 LM Studio、Ollama、SGLang 或 vLLM 这类本地推理基础设施。反之当你需要厂商原生请求参数或签订支持合同、需要将模型运行在自有硬件或网络边界内时应分别选择厂商直连提供商或本地推理提供商。作为回退路径使用时可将 Novita 模型加入agents.defaults.model.fallbacks链。OpenClaw 的模型回退机制会按配置依次尝试候选模型认证失败、限流、超载、计费禁用、model_not_found含符合条件的 HTTP 404等错误都会推进回退链且回退仅作用于当前回合不会覆盖会话原本选定的模型详见 docs/concepts/model-failover.md。故障排查针对 NovitaAI 接入的常见问题官方文档给出了以下排查路径docs/providers/novita.md401/403错误在 Novita 的密钥管理页面核对 API Key 是否有效如果本地存储的认证档案已过期重新运行openclaw onboard --auth-choice novita-api-key。未知模型错误使用openclaw models list --provider novita返回的精确novita/route-id不要凭记忆手写模型名。路由缓慢或失败换用其他 Novita 模型路由对于可以容忍提供商间差异的工作负载可将 Novita 配置为回退提供商。此外openclaw models status可用于查看默认模型、回退链与认证概况含不可用认证档案的冷却状态帮助快速定位认证或路由层面的问题。从源码理解插件的注册与行为对于想深入了解插件机制的读者建议对照以下三份文件阅读extensions/novita/index.ts插件入口通过defineSingleProviderPluginEntry一次性完成 provider id、别名、认证说明、模型目录增强逻辑、OpenAI 兼容回放钩子与工具兼容钩子的注册extensions/novita/openclaw.plugin.json插件的声明式清单承载端点映射novita-native/api.novita.ai、认证选项、环境变量、静态模型目录与发现策略extensions/novita/index.test.ts用registerSingleProviderPlugin在测试运行时加载插件断言 provider id、别名、环境变量、认证方式、起始模型、Base URL 与目录内容是理解插件契约与行为预期的最直接样例。关于“实时模型发现”插件在 extensions/novita/index.ts 中设置了liveModelDiscovery: true配合清单中的discovery: { novita: refreshable }可以推断 OpenClaw 会定期或按需向 Novita 拉取最新模型列表这也是官方文档建议以openclaw models list --provider novita输出为准的原因——静态目录之外账户级与区域级的模型可用性以平台实时返回为准。相关资源Model providers 概念文档模型提供商的索引与选择规则Provider directory 索引OpenClaw 支持的全部模型提供商列表openclaw modelsCLI 参考模型发现、选择与认证的命令详解Model failover 概念文档回退链、冷却与认证档案轮换机制【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenClaw 接入 NovitaAI：基于 OpenAI 兼容 API 的官方 Provider 插件完整指南
OpenClaw 接入 NovitaAI基于 OpenAI 兼容 API 的官方 Provider 插件完整指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本指南围绕 OpenClaw 官方外部插件openclaw/novita-provider展开讲解如何将 NovitaAI 的 OpenAI 兼容托管推理服务接入 OpenClaw Gateway涵盖插件安装、API Key 认证、novita/route-id模型引用格式、内置模型目录与选型建议以及 401/403 与未知模型等常见问题的排查方法。读完本文你将能够独立完成 NovitaAI 提供商的启用、认证、默认模型设置与故障诊断。NovitaAI 与 OpenClaw 的集成方式NovitaAI 是一个托管的 AI 基础设施提供商对外提供 OpenAI 兼容的 API。OpenClaw 通过官方外部插件openclaw/novita-provider提供对 NovitaAI 的支持插件入口位于 extensions/novita/index.ts其注册信息定义在 extensions/novita/openclaw.plugin.json。从源码结构看该插件使用 Plugin SDK 的defineSingleProviderPluginEntry完成注册extensions/novita/index.ts并声明了以下关键属性Provider idnovita别名novita-ai、novitaai在模型引用与 CLI 中均可使用文档路径/providers/novita即仓库中的 docs/providers/novita.md模型目录行为discoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true允许显式指定 Base URL并支持实时模型发现请求兼容层通过buildProviderReplayFamilyHooks以openai-compatible家族接入并用buildProviderToolCompatFamilyHooks(openai)复用 OpenAI 的工具调用兼容逻辑插件配置extensions/novita/openclaw.plugin.json进一步声明了它归属于models类别、默认启用enabledByDefault: true、在启动时不主动激活onStartup: false即按需加载并将api.novita.ai主机映射到novita-native端点类别。安装插件NovitaAI 通过外部插件提供需要显式安装后重启 Gateway 才能生效openclaw plugins install openclaw/novita-provider openclaw gateway restart根据 extensions/novita/package.json 中的发布声明该插件同时发布到 NPMnpmSpec: openclaw/novita-provider与 ClawHubclawhubSpec: clawhub:openclaw/novita-provider默认安装源为 NPM并要求宿主版本不低于2026.7.2、Plugin API 不低于2026.9.3。插件自述文件见 extensions/novita/README.md。认证创建 API Key 并写入 OpenClawNovitaAI 使用 API Key 认证。首先在 Novita 的密钥管理页面创建 API Key然后在 OpenClaw 中完成认证openclaw onboard --auth-choice novita-api-key也可以直接通过环境变量注入export NOVITA_API_KEYyour-novita-api-key # pragma: allowlist secret认证选项novita-api-key在插件清单的providerAuthChoices中定义extensions/novita/openclaw.plugin.json认证方式为api-key对应 CLI 参数为--novita-api-key key配置选项键为novitaApiKey并标记为appGuidedSecret应用引导式密钥可在控制界面安全录入。插件在setup.providers中声明其唯一需要的环境变量就是NOVITA_API_KEY。插件测试用例extensions/novita/index.test.ts验证了认证配置的完整性注册后的 provider 环境变量为[NOVITA_API_KEY]认证方式仅含api-key且推荐的起始模型为novita/deepseek/deepseek-v4-pro。核心参数一览以下是 OpenClaw 官方文档 docs/providers/novita.md 给出的 NovitaAI 默认参数与插件清单中的声明一致设置项值插件名openclaw/novita-providerProvider idnovita别名novita-ai、novitaaiBase URLhttps://api.novita.ai/openai/v1环境变量NOVITA_API_KEY默认模型novita/deepseek/deepseek-v4-pro其中 Base URL 与默认模型在插件清单的modelCatalog.providers.novita节点中定义extensions/novita/openclaw.plugin.jsonAPI 形态为openai-completions即走 OpenAI 兼容的 Completions 协议。模型目录的发现策略标记为refreshable可通过 CLI 刷新获取 Novita 当前实际可用的模型列表。模型引用格式与默认模型设置OpenClaw 的模型引用统一使用provider/model形式参见 docs/concepts/model-providers/quick-rules.md 中的 Model refs 规则。NovitaAI 的模型引用采用novita/route-id形式例如novita/deepseek/deepseek-v4-pronovita/moonshotai/kimi-k3要将 Novita 模型设为默认模型可以在配置中写入agents.defaults.model.primary{ agents: { defaults: { model: { primary: novita/deepseek/deepseek-v4-pro } } }, }更推荐使用 CLI 完成选择并可随时核对当前生效的模型与认证状态命令参考 docs/cli/models.mdopenclaw models list --provider novita openclaw models set novita/deepseek/deepseek-v4-pro openclaw models status需要注意models list --provider novita返回的是 Novita 当前实际可用的路由应以它返回的精确novita/route-id为准。另外为其他提供商添加认证并不会改变你已配置的 primary 模型如需主动切换默认模型请使用openclaw models set provider/model或openclaw models auth login --provider id --set-default。内置模型目录详解插件内置的静态模型目录定义在 extensions/novita/openclaw.plugin.json。官方文档 docs/providers/novita.md 将其作为出发点列出以下表格在此基础上补充了上下文窗口、输出上限、成本字段与输入模态等源码细节模型引用novita/前缀后名称推理输入上下文窗口最大输出成本input/output/cacheRead/cacheWrite备注moonshotai/kimi-k3Kimi K3是文本图像104857610485763 / 15 / 0.3 / 0codeMode: capablemoonshotai/kimi-k2.7-codeKimi K2.7 Code是文本图像2621442621440.95 / 4 / 0.19 / 0—minimax/minimax-m3MiniMax M3是文本图像10000001310720.3 / 1.2 / 0.06 / 0—zai-org/glm-5.2GLM-5.2是文本10485761310721.4 / 4.4 / 0.26 / 0codeMode: capabledeepseek/deepseek-v4-proDeepSeek V4 Pro是文本10485763932161.6 / 3.2 / 0.135 / 0codeMode: capable默认模型deepseek/deepseek-v4-flashDeepSeek V4 Flash是文本10485763932160.14 / 0.28 / 0.028 / 0codeMode: capableqwen/qwen3.7-maxQwen3.7-Max是文本1000000655361.25 / 3.75 / 0.25 / 0—minimax/minimax-m2.7MiniMax M2.7是文本2048001310720.3 / 1.2 / 0.06 / 0已弃用由 minimax-m3 取代关于上表的几点说明上下文窗口与输出上限contextWindow声明模型的原生上下文长度maxTokens声明该模型的最大输出 token 容量单位均为 token。成本字段input、output、cacheRead、cacheWrite为目录中记录的计价数字供 OpenClaw 内部成本核算使用具体计费口径以 NovitaAI 平台为准。弃用兼容项minimax/minimax-m2.7在目录中标记为status: deprecated并被replacedBy: minimax/minimax-m3取代仍然可被选择以兼容旧配置但会从模型选择器中隐藏。Code 模式标记了compat.codeMode: capable的模型Kimi K3、GLM-5.2、DeepSeek V4 Pro/Flash声明了对编码模式的兼容能力。官方文档同时强调这个目录只是起始参考不是实时目录。你的账号、所在区域或 Novita 当前的供给可能增删或限制某些路由。在设置长期默认模型之前请先运行openclaw models list --provider novita核对。何时选择 NovitaAI根据 docs/providers/novita.md 的建议以下场景适合选用 NovitaAI需要托管式开源权重模型的访问且希望使用 OpenAI 兼容 API 接入希望用一个提供商账号同时路由DeepSeek、Kimi、MiniMax、GLM、Qwen家族的模型需要一个除 DeepInfra、GMI、OpenRouter 或各家厂商直连 API 之外的托管回退路径fallback希望由提供商侧托管模型而非自行维护 LM Studio、Ollama、SGLang 或 vLLM 这类本地推理基础设施。反之当你需要厂商原生请求参数或签订支持合同、需要将模型运行在自有硬件或网络边界内时应分别选择厂商直连提供商或本地推理提供商。作为回退路径使用时可将 Novita 模型加入agents.defaults.model.fallbacks链。OpenClaw 的模型回退机制会按配置依次尝试候选模型认证失败、限流、超载、计费禁用、model_not_found含符合条件的 HTTP 404等错误都会推进回退链且回退仅作用于当前回合不会覆盖会话原本选定的模型详见 docs/concepts/model-failover.md。故障排查针对 NovitaAI 接入的常见问题官方文档给出了以下排查路径docs/providers/novita.md401/403错误在 Novita 的密钥管理页面核对 API Key 是否有效如果本地存储的认证档案已过期重新运行openclaw onboard --auth-choice novita-api-key。未知模型错误使用openclaw models list --provider novita返回的精确novita/route-id不要凭记忆手写模型名。路由缓慢或失败换用其他 Novita 模型路由对于可以容忍提供商间差异的工作负载可将 Novita 配置为回退提供商。此外openclaw models status可用于查看默认模型、回退链与认证概况含不可用认证档案的冷却状态帮助快速定位认证或路由层面的问题。从源码理解插件的注册与行为对于想深入了解插件机制的读者建议对照以下三份文件阅读extensions/novita/index.ts插件入口通过defineSingleProviderPluginEntry一次性完成 provider id、别名、认证说明、模型目录增强逻辑、OpenAI 兼容回放钩子与工具兼容钩子的注册extensions/novita/openclaw.plugin.json插件的声明式清单承载端点映射novita-native/api.novita.ai、认证选项、环境变量、静态模型目录与发现策略extensions/novita/index.test.ts用registerSingleProviderPlugin在测试运行时加载插件断言 provider id、别名、环境变量、认证方式、起始模型、Base URL 与目录内容是理解插件契约与行为预期的最直接样例。关于“实时模型发现”插件在 extensions/novita/index.ts 中设置了liveModelDiscovery: true配合清单中的discovery: { novita: refreshable }可以推断 OpenClaw 会定期或按需向 Novita 拉取最新模型列表这也是官方文档建议以openclaw models list --provider novita输出为准的原因——静态目录之外账户级与区域级的模型可用性以平台实时返回为准。相关资源Model providers 概念文档模型提供商的索引与选择规则Provider directory 索引OpenClaw 支持的全部模型提供商列表openclaw modelsCLI 参考模型发现、选择与认证的命令详解Model failover 概念文档回退链、冷却与认证档案轮换机制【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考