OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

快速开始

DeepInfra

DeepInfra 通过单个兼容 OpenAI 的端点和 API key，将请求路由到热门开源模型和前沿模型。大多数 OpenAI SDK 只需切换基础 URL 即可使用它。

安装插件

bash
openclaw plugins install @openclaw/deepinfra-provideropenclaw gateway restart

获取 API key

  1. 在 deepinfra.com 登录
  2. 前往 Dashboard / Keys 并生成一个 key，或使用自动创建的 key

CLI 设置

bash
openclaw onboard --deepinfra-api-key <key>

或者设置环境变量：

bash
export DEEPINFRA_API_KEY="<your-deepinfra-api-key>" # pragma: allowlist secret

配置片段

json5
{  env: { DEEPINFRA_API_KEY: "<your-deepinfra-api-key>" }, // pragma: allowlist secret  agents: {    defaults: {      model: { primary: "deepinfra/deepseek-ai/DeepSeek-V4-Flash" },    },  },}

支持的功能界面

配置 DEEPINFRA_API_KEY 后，聊天、图像生成和视频生成会从 https://api.deepinfra.com/v1/openai/models?sort_by=openclaw&filter=with_meta 实时刷新其模型目录。其他功能界面在迁移到同一个实时目录之前，会使用下方的静态默认值。

功能界面 默认模型 OpenClaw 配置/工具
聊天/模型提供商 实时目录中第一个带聊天标签的条目（静态回退为 deepseek-ai/DeepSeek-V4-Flash） agents.defaults.model
图像生成/编辑 实时目录中第一个带 image-gen 标签的条目（静态回退为 black-forest-labs/FLUX-1-schnell） image_generate, agents.defaults.imageGenerationModel
媒体理解 图像使用 moonshotai/Kimi-K2.5 入站图像理解
语音转文本 openai/whisper-large-v3-turbo 入站音频转录
文本转语音 hexgrad/Kokoro-82M messages.tts.provider: "deepinfra"
视频生成 静态回退为 Pixverse/Pixverse-T2V（目前 DeepInfra 没有实时的 video-gen 条目） video_generate, agents.defaults.videoGenerationModel
记忆嵌入 BAAI/bge-m3 agents.defaults.memorySearch.provider: "deepinfra"

DeepInfra 还提供重排序、分类、对象检测以及其他原生模型类型。OpenClaw 目前尚未为这些类别定义提供商契约，因此该插件不会注册它们。

可用模型

配置 key 后，OpenClaw 会动态发现 DeepInfra 模型。使用 /models deepinfra 或 openclaw models list --provider deepinfra 查看当前列表。

deepinfra.com 上的任何模型都可以使用 deepinfra/ 前缀：

text
deepinfra/deepseek-ai/DeepSeek-V4-Flashdeepinfra/deepseek-ai/DeepSeek-V3.2deepinfra/MiniMaxAI/MiniMax-M2.5deepinfra/moonshotai/Kimi-K2.5deepinfra/nvidia/NVIDIA-Nemotron-3-Super-120B-A12Bdeepinfra/zai-org/GLM-5.1……以及更多模型

说明

  • 模型引用格式为 deepinfra/<provider>/<model>（例如 deepinfra/Qwen/Qwen3-Max）。
  • 默认聊天模型：deepinfra/deepseek-ai/DeepSeek-V4-Flash
  • 基础 URL：https://api.deepinfra.com/v1/openai
  • 原生视频生成使用 https://api.deepinfra.com/v1/inference/<model>。

相关内容

Was this useful?
On this page

On this page