OpenClaw 接入 NovitaAIOpenAI 兼容托管推理提供商的安装、配置与故障排查指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawNovitaAI 是提供 OpenAI 兼容 API 的托管 AI 基础设施服务商OpenClaw 通过官方外部插件openclaw/novita-provider将其接入模型引用采用novita/组织/模型三段式 ref例如novita/deepseek/deepseek-v4-pro。本文以 docs/providers/novita.md 为主体结合插件源码 extensions/novita/index.ts 与插件清单 extensions/novita/openclaw.plugin.json完整讲解安装步骤、认证方式、默认参数、模型目录与排障流程帮助你在一台服务器上同时获得 DeepSeek、Kimi、MiniMax、GLM、Qwen 等多个开源权重模型系列的托管路由。为什么选择 NovitaAI在接入之前先明确 NovitaAI 在 OpenClaw 生态中的定位托管开源权重模型通过一个 OpenAI 兼容 API 即可访问 DeepSeek、KimiMoonshot、MiniMax、GLMZ.AI、Qwen 等模型系列无需分别向多家厂商申请账号与密钥免自建推理基础设施模型托管在 Novita 侧省去维护 LM Studio、Ollama、SGLang 或 vLLM 推理服务的工作量作为托管回退路径可作为 DeepInfra、GMI、OpenRouter 或各厂商直连 API 之外的又一托管兜底提供商。同时文档也给出了取舍边界需要厂商原生请求参数或支持合同support contract时应选择直连厂商的 provider要求模型运行在自己的硬件或网络边界内时应选择本地推理提供商。NovitaAI 属于托管 OpenAI 兼容这一类适合对基础设施成本敏感、且能接受提供商侧差异的负载。安装与首次设置安装插件并重启 GatewayOpenClaw 通过官方外部插件提供 NovitaAI安装与激活分两步openclaw plugins install openclaw/novita-provider openclaw gateway restart从插件的 package.json 可以看到该插件的发布信息包名为openclaw/novita-providerClawHub 与 npm 双渠道发布publishToClawHub、publishToNpm均为 true安装时默认选择 npm 渠道defaultChoice: npm并要求宿主机版本不低于2026.7.2插件 API 兼容要求为2026.9.4。插件入口 index.ts 通过defineSingleProviderPluginEntry注册单个提供商activation.onStartup为false、enabledByDefault为true即默认随 Gateway 启用但不在启动时强制加载。创建 API Key 与写入凭据在 Novita 后台的 key management 页面创建 API Key 后有两种方式提供凭据方式一引导式 onboard推荐openclaw onboard --auth-choice novita-api-key该方式会走插件清单中声明的认证引导流程。查看 openclaw.plugin.json 的providerAuthChoices可以看到novita-api-key选项的完整定义认证方法为api-keyCLI 旗标为--novita-api-key key并带有appGuidedSecret: true应用引导式密钥存储。方式二环境变量export NOVITA_API_KEYyour-novita-api-key环境变量名同样由插件声明setup.providers[].envVars为[NOVITA_API_KEY]OpenClaw 会将该变量识别为 Novita 提供商的认证来源。插件默认参数一览以下默认值同时写于 docs/providers/novita.md 与插件清单的modelCatalog段SettingValuePluginopenclaw/novita-providerProvider idnovitaAliasesnovita-ai,novitaaiBase URLhttps://api.novita.ai/openai/v1Env varNOVITA_API_KEYDefault modelnovita/deepseek/deepseek-v4-pro注意三个别名novita、novita-ai、novitaai在插件清单中被统一映射到novita并在providerAuthAliases中归一化因此无论你在配置中写哪个 id底层都落到同一提供商。providerEndpoints声明了novita-native端点类主机为api.novita.aiproviderRequest.providers将三个 id 全部映射到family: novita请求族。模型目录内置模型清单插件清单 openclaw.plugin.json 的modelCatalog.providers.novita.models内置了以下模型条目即文档中的目录novita/moonshotai/kimi-k3novita/moonshotai/kimi-k2.7-codenovita/minimax/minimax-m3novita/zai-org/glm-5.2novita/deepseek/deepseek-v4-pronovita/deepseek/deepseek-v4-flashnovita/qwen/qwen3.7-maxnovita/minimax/minimax-m2.7仍可作为已弃用deprecated兼容条目被选中但不会出现在模型选择器中清单中它带有status: deprecated与replacedBy: minimax/minimax-m3标记。模型 ref 的完整形式是novita/route-idroute-id 即模型 id如deepseek/deepseek-v4-pro最终拼成novita/deepseek/deepseek-v4-pro。这与源码测试 extensions/novita/index.test.ts 的断言一致默认模型为novita/deepseek/deepseek-v4-proBase URL 为https://api.novita.ai/openai/v1。目录是起点而非实时快照文档明确提醒这是 starting point起点不是 live catalog。你的账号、区域或 Novita 当前上架情况可能增删或限制某些路由。因此在把某个模型设为长期默认值之前先执行openclaw models list --provider novita该命令列出该提供商可用的模型清单。若想了解更丰富的目录管理操作models set、models scan、models aliases、models fallbacks等可参考 docs/cli/models.md其中openclaw models set model-or-alias写入agents.defaults.model.primaryopenclaw models fallbacks add model-or-alias管理回退链。从源码看目录的模型元数据内置模型条目不只是 id 列表还包含可用于容量规划的元数据详见 openclaw.plugin.json模型推理输入上下文窗口最大输出输入价/输出价/缓存读每 M tokenmoonshotai/kimi-k3是文本图片1,048,5761,048,5763 / 15 / 0.3moonshotai/kimi-k2.7-code是文本图片262,144262,1440.95 / 4 / 0.19minimax/minimax-m3是文本图片1,000,000131,0720.3 / 1.2 / 0.06zai-org/glm-5.2是文本1,048,576131,0721.4 / 4.4 / 0.26deepseek/deepseek-v4-pro是文本1,048,576393,2161.6 / 3.2 / 0.135deepseek/deepseek-v4-flash是文本1,048,576393,2160.14 / 0.28 / 0.028qwen/qwen3.7-max是文本1,000,00065,5361.25 / 3.75 / 0.25值得注意的细节kimi-k3、minimax-m3、glm-5.2、两个 deepseek 型号均声明了compat.codeMode: capable即具备代码模式能力标记Kimi 与 MiniMax 系列支持图片输入input: [text, image]GLM 与 DeepSeek、Qwen 系列当前仅文本。这些字段来自当前仓库快照实际价格与能力以 Novita 官方为准仅作选型参考。插件实现机制源码级解读入口注册extensions/novita/index.ts 是整个插件的核心入口它做了四件事以defineSingleProviderPluginEntry注册单一提供商id为novitadocsPath指向/providers/novita声明manifestAuth在 UI 中提示用户前往 Novita 密钥管理页配置catalogdiscoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true——即允许显式覆盖 Base URL并支持在线发现模型通过augmentModelCatalog调用readConfiguredProviderCatalogEntries读取配置中的提供商目录条目并挂载 OpenAI 兼容家族的 replay hooksbuildProviderReplayFamilyHooks({ family: openai-compatible, dropReasoningFromHistory: false })与 OpenAI 工具兼容 hooksbuildProviderToolCompatFamilyHooks(openai)。从dropReasoningFromHistory: false可以推断回放历史时不会丢弃推理内容适合依赖思维链输出的推理模型。这些 hooks 意味着 Novita 走的是 OpenAI 兼容请求格式工具调用、历史回放等行为按 OpenAI 兼容协议处理。测试佐证extensions/novita/index.test.ts 用registerSingleProviderPlugin注册插件并断言provider id 为novita、别名为[novita-ai, novitaai]、环境变量为[NOVITA_API_KEY]、认证方法仅api-key、起始模型为novita/deepseek/deepseek-v4-pro并验证静态目录的 Base URL 与模型包含关系。这些断言与文档表格一一对应可作为排障时的期望行为基线。在 OpenClaw 中配置与使用 Novita 模型插件注册后无需在models.providers中手写模型条目——按 docs/concepts/model-providers/official-provider-plugins.md 的说明官方提供商插件自带模型目录行只需启用插件、配置认证并选择模型。设置默认模型的两种方式# 方式一CLI 设置默认模型写入 agents.defaults.model.primary openclaw models set novita/deepseek/deepseek-v4-pro # 方式二配置文件直接声明 # openclaw.json / openclaw.json5 { agents: { defaults: { model: { primary: novita/deepseek/deepseek-v4-pro } } }, }如果你希望 Novita 作为兜底提供商可以在agents.defaults.model.fallbacks中加入 Novita 模型对应 docs/concepts/model-failover.md 描述的模型回退机制例如{ agents: { defaults: { model: { primary: openai/gpt-5.6-sol, fallbacks: [novita/deepseek/deepseek-v4-pro, novita/qwen/qwen3.7-max], }, }, }, }回退机制的工作方式OpenClaw 先做提供商内部的认证 profile 轮换再按fallbacks列表尝试下一个模型回退只在当前回合生效不会改写会话的已选模型。详细的失败分类如rate_limit、overloaded、model_not_found、billing disable 等与冷却时间策略参见 docs/concepts/model-failover.md。由于 Novita 单账户即可承载多个模型系列把它放进回退链可以在主提供商故障时提供跨系列冗余。故障排查401 / 403 认证错误先在 Novita 的 key management 页面核对密钥是否有效、是否被轮换或撤销若存储的 profile 已过期重新执行openclaw onboard --auth-choice novita-api-key这会重写凭据 profile。若仍失败确认环境变量NOVITA_API_KEY未被其它同名变量覆盖。未知模型错误Unknown modelopenclaw models list --provider novita返回的是你账号下实际可用的路由务必使用该命令输出的精确novita/route-id。文档特别强调内置目录是起点账号或区域差异可能导致某些路由不可用不要凭记忆拼写 route-id。路由慢或失败换一条 Novita 模型路由再试例如从deepseek-v4-pro切到deepseek-v4-flash或qwen3.7-max对于能容忍提供商差异的工作负载把 Novita 配置为回退提供商见上文fallbacks配置利用 模型回退机制 自动切换。其它排查建议插件安装后必须openclaw gateway restart否则新注册的提供商不会在运行中的 Gateway 里生效使用openclaw models status查看已解析的默认模型、回退列表与认证概览详见 docs/cli/models.md若配置了models.providers.novita自定义条目注意插件的catalog.discoveryMode为strict、且allowExplicitBaseUrl为true显式 Base URL 覆盖是允许的但模型条目仍以插件目录为准。参考文档模型提供商总览提供商索引与 CLI 示例官方提供商插件内置提供商对照表其中 NovitaAI 的 id、认证环境变量、示例模型模型回退机制回退链、认证轮换与冷却策略openclaw modelsCLI 参考models list / set / scan / fallbacks等命令详解提供商目录全部 per-provider 配置指南入口插件源码与测试extensions/novita/index.ts、extensions/novita/openclaw.plugin.json、extensions/novita/index.test.ts【免费下载链接】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 兼容托管推理提供商的安装、配置与故障排查指南
OpenClaw 接入 NovitaAIOpenAI 兼容托管推理提供商的安装、配置与故障排查指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawNovitaAI 是提供 OpenAI 兼容 API 的托管 AI 基础设施服务商OpenClaw 通过官方外部插件openclaw/novita-provider将其接入模型引用采用novita/组织/模型三段式 ref例如novita/deepseek/deepseek-v4-pro。本文以 docs/providers/novita.md 为主体结合插件源码 extensions/novita/index.ts 与插件清单 extensions/novita/openclaw.plugin.json完整讲解安装步骤、认证方式、默认参数、模型目录与排障流程帮助你在一台服务器上同时获得 DeepSeek、Kimi、MiniMax、GLM、Qwen 等多个开源权重模型系列的托管路由。为什么选择 NovitaAI在接入之前先明确 NovitaAI 在 OpenClaw 生态中的定位托管开源权重模型通过一个 OpenAI 兼容 API 即可访问 DeepSeek、KimiMoonshot、MiniMax、GLMZ.AI、Qwen 等模型系列无需分别向多家厂商申请账号与密钥免自建推理基础设施模型托管在 Novita 侧省去维护 LM Studio、Ollama、SGLang 或 vLLM 推理服务的工作量作为托管回退路径可作为 DeepInfra、GMI、OpenRouter 或各厂商直连 API 之外的又一托管兜底提供商。同时文档也给出了取舍边界需要厂商原生请求参数或支持合同support contract时应选择直连厂商的 provider要求模型运行在自己的硬件或网络边界内时应选择本地推理提供商。NovitaAI 属于托管 OpenAI 兼容这一类适合对基础设施成本敏感、且能接受提供商侧差异的负载。安装与首次设置安装插件并重启 GatewayOpenClaw 通过官方外部插件提供 NovitaAI安装与激活分两步openclaw plugins install openclaw/novita-provider openclaw gateway restart从插件的 package.json 可以看到该插件的发布信息包名为openclaw/novita-providerClawHub 与 npm 双渠道发布publishToClawHub、publishToNpm均为 true安装时默认选择 npm 渠道defaultChoice: npm并要求宿主机版本不低于2026.7.2插件 API 兼容要求为2026.9.4。插件入口 index.ts 通过defineSingleProviderPluginEntry注册单个提供商activation.onStartup为false、enabledByDefault为true即默认随 Gateway 启用但不在启动时强制加载。创建 API Key 与写入凭据在 Novita 后台的 key management 页面创建 API Key 后有两种方式提供凭据方式一引导式 onboard推荐openclaw onboard --auth-choice novita-api-key该方式会走插件清单中声明的认证引导流程。查看 openclaw.plugin.json 的providerAuthChoices可以看到novita-api-key选项的完整定义认证方法为api-keyCLI 旗标为--novita-api-key key并带有appGuidedSecret: true应用引导式密钥存储。方式二环境变量export NOVITA_API_KEYyour-novita-api-key环境变量名同样由插件声明setup.providers[].envVars为[NOVITA_API_KEY]OpenClaw 会将该变量识别为 Novita 提供商的认证来源。插件默认参数一览以下默认值同时写于 docs/providers/novita.md 与插件清单的modelCatalog段SettingValuePluginopenclaw/novita-providerProvider idnovitaAliasesnovita-ai,novitaaiBase URLhttps://api.novita.ai/openai/v1Env varNOVITA_API_KEYDefault modelnovita/deepseek/deepseek-v4-pro注意三个别名novita、novita-ai、novitaai在插件清单中被统一映射到novita并在providerAuthAliases中归一化因此无论你在配置中写哪个 id底层都落到同一提供商。providerEndpoints声明了novita-native端点类主机为api.novita.aiproviderRequest.providers将三个 id 全部映射到family: novita请求族。模型目录内置模型清单插件清单 openclaw.plugin.json 的modelCatalog.providers.novita.models内置了以下模型条目即文档中的目录novita/moonshotai/kimi-k3novita/moonshotai/kimi-k2.7-codenovita/minimax/minimax-m3novita/zai-org/glm-5.2novita/deepseek/deepseek-v4-pronovita/deepseek/deepseek-v4-flashnovita/qwen/qwen3.7-maxnovita/minimax/minimax-m2.7仍可作为已弃用deprecated兼容条目被选中但不会出现在模型选择器中清单中它带有status: deprecated与replacedBy: minimax/minimax-m3标记。模型 ref 的完整形式是novita/route-idroute-id 即模型 id如deepseek/deepseek-v4-pro最终拼成novita/deepseek/deepseek-v4-pro。这与源码测试 extensions/novita/index.test.ts 的断言一致默认模型为novita/deepseek/deepseek-v4-proBase URL 为https://api.novita.ai/openai/v1。目录是起点而非实时快照文档明确提醒这是 starting point起点不是 live catalog。你的账号、区域或 Novita 当前上架情况可能增删或限制某些路由。因此在把某个模型设为长期默认值之前先执行openclaw models list --provider novita该命令列出该提供商可用的模型清单。若想了解更丰富的目录管理操作models set、models scan、models aliases、models fallbacks等可参考 docs/cli/models.md其中openclaw models set model-or-alias写入agents.defaults.model.primaryopenclaw models fallbacks add model-or-alias管理回退链。从源码看目录的模型元数据内置模型条目不只是 id 列表还包含可用于容量规划的元数据详见 openclaw.plugin.json模型推理输入上下文窗口最大输出输入价/输出价/缓存读每 M tokenmoonshotai/kimi-k3是文本图片1,048,5761,048,5763 / 15 / 0.3moonshotai/kimi-k2.7-code是文本图片262,144262,1440.95 / 4 / 0.19minimax/minimax-m3是文本图片1,000,000131,0720.3 / 1.2 / 0.06zai-org/glm-5.2是文本1,048,576131,0721.4 / 4.4 / 0.26deepseek/deepseek-v4-pro是文本1,048,576393,2161.6 / 3.2 / 0.135deepseek/deepseek-v4-flash是文本1,048,576393,2160.14 / 0.28 / 0.028qwen/qwen3.7-max是文本1,000,00065,5361.25 / 3.75 / 0.25值得注意的细节kimi-k3、minimax-m3、glm-5.2、两个 deepseek 型号均声明了compat.codeMode: capable即具备代码模式能力标记Kimi 与 MiniMax 系列支持图片输入input: [text, image]GLM 与 DeepSeek、Qwen 系列当前仅文本。这些字段来自当前仓库快照实际价格与能力以 Novita 官方为准仅作选型参考。插件实现机制源码级解读入口注册extensions/novita/index.ts 是整个插件的核心入口它做了四件事以defineSingleProviderPluginEntry注册单一提供商id为novitadocsPath指向/providers/novita声明manifestAuth在 UI 中提示用户前往 Novita 密钥管理页配置catalogdiscoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true——即允许显式覆盖 Base URL并支持在线发现模型通过augmentModelCatalog调用readConfiguredProviderCatalogEntries读取配置中的提供商目录条目并挂载 OpenAI 兼容家族的 replay hooksbuildProviderReplayFamilyHooks({ family: openai-compatible, dropReasoningFromHistory: false })与 OpenAI 工具兼容 hooksbuildProviderToolCompatFamilyHooks(openai)。从dropReasoningFromHistory: false可以推断回放历史时不会丢弃推理内容适合依赖思维链输出的推理模型。这些 hooks 意味着 Novita 走的是 OpenAI 兼容请求格式工具调用、历史回放等行为按 OpenAI 兼容协议处理。测试佐证extensions/novita/index.test.ts 用registerSingleProviderPlugin注册插件并断言provider id 为novita、别名为[novita-ai, novitaai]、环境变量为[NOVITA_API_KEY]、认证方法仅api-key、起始模型为novita/deepseek/deepseek-v4-pro并验证静态目录的 Base URL 与模型包含关系。这些断言与文档表格一一对应可作为排障时的期望行为基线。在 OpenClaw 中配置与使用 Novita 模型插件注册后无需在models.providers中手写模型条目——按 docs/concepts/model-providers/official-provider-plugins.md 的说明官方提供商插件自带模型目录行只需启用插件、配置认证并选择模型。设置默认模型的两种方式# 方式一CLI 设置默认模型写入 agents.defaults.model.primary openclaw models set novita/deepseek/deepseek-v4-pro # 方式二配置文件直接声明 # openclaw.json / openclaw.json5 { agents: { defaults: { model: { primary: novita/deepseek/deepseek-v4-pro } } }, }如果你希望 Novita 作为兜底提供商可以在agents.defaults.model.fallbacks中加入 Novita 模型对应 docs/concepts/model-failover.md 描述的模型回退机制例如{ agents: { defaults: { model: { primary: openai/gpt-5.6-sol, fallbacks: [novita/deepseek/deepseek-v4-pro, novita/qwen/qwen3.7-max], }, }, }, }回退机制的工作方式OpenClaw 先做提供商内部的认证 profile 轮换再按fallbacks列表尝试下一个模型回退只在当前回合生效不会改写会话的已选模型。详细的失败分类如rate_limit、overloaded、model_not_found、billing disable 等与冷却时间策略参见 docs/concepts/model-failover.md。由于 Novita 单账户即可承载多个模型系列把它放进回退链可以在主提供商故障时提供跨系列冗余。故障排查401 / 403 认证错误先在 Novita 的 key management 页面核对密钥是否有效、是否被轮换或撤销若存储的 profile 已过期重新执行openclaw onboard --auth-choice novita-api-key这会重写凭据 profile。若仍失败确认环境变量NOVITA_API_KEY未被其它同名变量覆盖。未知模型错误Unknown modelopenclaw models list --provider novita返回的是你账号下实际可用的路由务必使用该命令输出的精确novita/route-id。文档特别强调内置目录是起点账号或区域差异可能导致某些路由不可用不要凭记忆拼写 route-id。路由慢或失败换一条 Novita 模型路由再试例如从deepseek-v4-pro切到deepseek-v4-flash或qwen3.7-max对于能容忍提供商差异的工作负载把 Novita 配置为回退提供商见上文fallbacks配置利用 模型回退机制 自动切换。其它排查建议插件安装后必须openclaw gateway restart否则新注册的提供商不会在运行中的 Gateway 里生效使用openclaw models status查看已解析的默认模型、回退列表与认证概览详见 docs/cli/models.md若配置了models.providers.novita自定义条目注意插件的catalog.discoveryMode为strict、且allowExplicitBaseUrl为true显式 Base URL 覆盖是允许的但模型条目仍以插件目录为准。参考文档模型提供商总览提供商索引与 CLI 示例官方提供商插件内置提供商对照表其中 NovitaAI 的 id、认证环境变量、示例模型模型回退机制回退链、认证轮换与冷却策略openclaw modelsCLI 参考models list / set / scan / fallbacks等命令详解提供商目录全部 per-provider 配置指南入口插件源码与测试extensions/novita/index.ts、extensions/novita/openclaw.plugin.json、extensions/novita/index.test.ts【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
