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

1

粘贴 setup prompt

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

复制 prompt
2

核对生成的配置

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

runapi/gpt-5.2
3

验证选择

运行 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 命令、参数说明和常见问题。

InfiniteTalk

从音频生成数字人口播视频

Grok Imagine

xAI 文生图与文生视频

Flux Kontext

提示词引导的图像编辑

Z Image

双语快速文生图

Topaz

AI 图像与视频超分

Imagen 4

Google 文生图

Seedream

字节跳动 4K 文生图

Qwen 2 Image

阿里巴巴图像生成与编辑

Kling

带动感控制和原声音频的视频生成

Veo 3

Google 影视级视频，原生音频

Seedance

字节跳动低成本视频生成

Hailuo

MiniMax 视频，每日免费额度

Wan

开源视频与图像生成

Runway

带镜头控制的创意视频生成

Luma

空间感知视频生成

Suno

文字转 AI 音乐

ElevenLabs

文字转语音与语音 AI

GPT

OpenAI 对话与响应 API

Claude

Anthropic 消息 API

DeepSeek

低成本推理大模型

Gemini

Google AI 模型，无需 GCP

Nano Banana

Google 图像生成，支持文字排版

Midjourney

Midjourney AI 绘画、图片编辑和图生视频

Ideogram V3

专注排版的图像生成

Recraft

矢量艺术与图像超分

Flux 2

BFL 图像生成，Pro 和 Flex 档

GPT Image

OpenAI 图像生成与编辑
常见问题

OpenClaw 配置问题

在 OpenClaw 中用一把 RunAPI key。

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

浏览模型 →