OpenClaw 可以把 RunAPI 当作自定义模型 provider 吗？

可以。OpenClaw 通过 models.providers 支持自定义 OpenAI 兼容 provider。为 RunAPI 配置 /v1 base URL，把 api 设为 openai-completions，并在 agents.defaults.model.primary 中选择带 provider 前缀的模型引用。

models.providers 里的模型 ID 要带 provider 前缀吗？

不要。在 models.providers.runapi.models 内使用 provider 内部 ID，例如 gpt-5.2。只有在 OpenClaw 默认模型或命令里选择模型时，才使用 runapi/gpt-5.2 这种带 provider 前缀的引用。

RunAPI API key 应该存在哪里？

把 key 存在 RUNAPI_API_KEY，并在 OpenClaw 配置里读取它。这样凭证不会进入版本控制，也能让同一份配置用于本地 shell、服务器和自动化环境。

还能保留现有 OpenClaw 模型作为 fallback 吗？

可以。保持 models.mode 为 merge，并把 RunAPI 作为其中一个 provider 加进去。现有 provider 仍可用；需要恢复链路时，把 fallback 放进 agents.defaults.model.fallbacks。

OPENCLAW 指南

在 OpenClaw 中使用 RunAPI。

RunAPI 可以作为 OpenClaw 的 OpenAI 兼容端点使用。把 prompt 复制进 OpenClaw，让它添加 provider；需要核对字段时再看配置 tab。

免费获取 API Key 阅读文档

复制 prompt · 一把 RunAPI key · 模型目录链接

Configure this OpenClaw workspace to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

{
  agents: {
    defaults: {
      model: { primary: "runapi/gpt-5.5" },
      models: {
        "runapi/gpt-5.5": { alias: "RunAPI GPT 5.5" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      runapi: {
        baseUrl: "https://runapi.ai/v1",
        apiKey: "${RUNAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.5",
            name: "RunAPI GPT 5.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.5
openclaw

Copy prompt first /v1

配置步骤

用 prompt 在 OpenClaw 中安装 RunAPI

粘贴 setup prompt

复制第一个 tab 里的 prompt 给 OpenClaw。它会要求 OpenClaw 读取 RUNAPI_API_KEY、添加 runapi provider，并保留现有 provider。

复制 prompt

核对生成的配置

OpenClaw 应该把 gpt-5.2 加为 provider 内部模型 ID，再通过带 provider 前缀的 runapi/gpt-5.2 选择模型。

runapi/gpt-5.2

验证选择

运行 openclaw models status，切换到 RunAPI 模型，然后启动 OpenClaw 会话。如果模型没有出现，检查 allowlist 是否包含 runapi/gpt-5.2。

openclaw models status

参考

配置字段

字段	值	作用
`baseUrl`	`https://runapi.ai/v1`	让 OpenClaw 指向 RunAPI 的 OpenAI 兼容 API 接口。
`apiKey`	`${RUNAPI_API_KEY}`	从环境变量读取 RunAPI API key。
`api`	`openai-completions`	使用 OpenAI 兼容端点需要的 Chat Completions 适配方式。
`agents.defaults.model.primary`	`runapi/gpt-5.2`	把 RunAPI 模型设为新 OpenClaw 会话的默认模型。

不止大模型

一把 key，图像、视频、音乐全搞定。

大多数 OpenClaw 用户要为每种媒体类型单独安装 GitHub skill——图像一个、视频一个、音乐一个。用 RunAPI，你为聊天配置的同一把 RUNAPI_API_KEY，同样可以调用 113+ 个图像、视频、音乐模型。无需额外安装任何 skill。

图像生成

通过 Flux Kontext、Imagen 4、Seedream、GPT Image 和 Nano Banana 生成并编辑图像。把提示词发到同一个 /v1 端点，RunAPI 会路由到你指定的模型。

浏览图像模型

视频生成

用 Kling 3.0、Seedance 2.0、Veo 3 和 Wan 2.7 从文字或图像生成视频。任务生命周期相同、回调格式相同、API key 相同。

浏览视频模型

音乐生成

通过 Suno v4 到 v5.5 生成歌曲。传入歌词、风格和时长，RunAPI 通过标准任务轮询流程返回音频 URL。

浏览音乐模型

模型指南

在龙虾中使用任何模型

每份指南包含在 OpenClaw 中通过 RunAPI 调用特定模型所需的提示词、curl 命令、参数说明和常见问题。

OpenClaw 配置问题

在 OpenClaw 中用一把 RunAPI key。

浏览模型目录，选择模型 ID，然后加入你的 OpenClaw provider 配置。

浏览模型 →

在 OpenClaw 中使用 RunAPI。

用 prompt 在 OpenClaw 中安装 RunAPI

粘贴 setup prompt

核对生成的配置

验证选择

配置字段

一把 key，图像、视频、音乐全搞定。

图像生成

视频生成

音乐生成

在龙虾中使用任何模型

Claude

DeepSeek

ElevenLabs

Embedding

Fish Audio

Flux

Flux 2

Flux Kontext

Gemini

Gemini Omni

Gemini TTS

GLM

GPT

GPT Image

GPT Image 2

GPT-4o Image

Grok

Grok Imagine

Hailuo

HappyHorse

Ideogram V3

Imagen 4

InfiniteTalk

Kimi

Kling

Luma

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Runway Aleph

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan