OpenClaw pode usar RunAPI como provider de modelo personalizado?

Sim. OpenClaw suporta providers personalizados compatíveis com OpenAI via models.providers. Configure RunAPI com a base URL /v1, defina api como openai-completions e escolha a referência de modelo com prefixo de provider em agents.defaults.model.primary.

O model ID dentro de models.providers deve incluir o prefixo do provider?

Não. Dentro de models.providers.runapi.models, use o ID local ao provider, como gpt-5.2. Use a referência com prefixo runapi/gpt-5.2 ao selecionar o modelo nos defaults ou comandos do OpenClaw.

Onde devo armazenar a RunAPI API key?

Armazene a key em RUNAPI_API_KEY e leia a partir da configuração do OpenClaw. Isso mantém a credencial fora do controle de versão e permite usar a mesma configuração em shells locais, servidores e automação.

Posso manter meus modelos OpenClaw existentes como fallbacks?

Sim. Mantenha models.mode como merge e adicione RunAPI como um provider. Seus providers existentes continuam disponíveis, e você pode adicionar fallbacks em agents.defaults.model.fallbacks quando quiser comportamento de recuperação.

GUIA OPENCLAW

Use RunAPI no OpenClaw.

RunAPI funciona como endpoint compatível com OpenAI para OpenClaw. Copie o prompt no OpenClaw, deixe ele adicionar o provider e use a aba de configuração só quando quiser revisar os campos exatos.

Obter API Key grátis Ler a documentação

Copiar prompt · uma RunAPI key · links do catálogo de modelos

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

CONFIGURAÇÃO

Instale RunAPI no OpenClaw com um prompt

Cole o prompt de setup

Copie o prompt da primeira aba para o OpenClaw. Ele orienta o OpenClaw a ler RUNAPI_API_KEY, adicionar o provider runapi e manter os providers existentes disponíveis.

Copiar prompt

Revise a configuração gerada

OpenClaw deve adicionar gpt-5.2 como ID de modelo local ao provider e então selecioná-lo pela referência com prefixo de provider runapi/gpt-5.2.

runapi/gpt-5.2

Verifique a seleção

Execute openclaw models status, troque para o modelo RunAPI e inicie uma sessão OpenClaw. Se o modelo não aparecer, confirme que a allowlist inclui runapi/gpt-5.2.

openclaw models status

REFERÊNCIA

Campos de configuração

Campo	Valor	Propósito
`baseUrl`	`https://runapi.ai/v1`	Aponta OpenClaw para a superfície API compatível com OpenAI da RunAPI.
`apiKey`	`${RUNAPI_API_KEY}`	Lê a RunAPI API key do ambiente.
`api`	`openai-completions`	Usa o adaptador Chat Completions esperado por endpoints compatíveis com OpenAI.
`agents.defaults.model.primary`	`runapi/gpt-5.2`	Seleciona o modelo RunAPI como padrão para novas sessões OpenClaw.

ALÉM DOS LLMs

Uma API key. Imagens, vídeo e música.

A maioria dos usuários do OpenClaw instala uma GitHub skill separada para cada modalidade — uma para imagens, outra para vídeo, outra para música. Com o RunAPI, a mesma RUNAPI_API_KEY que você já configurou para chat também chama mais de 113 modelos de imagens, vídeo e música. Sem skills extras para instalar.

Geração de imagens

Gere e edite imagens com Flux Kontext, Imagen 4, Seedream, GPT Image e Nano Banana. Envie um prompt para o mesmo endpoint /v1 — o RunAPI encaminha para o modelo que você especificar.

Ver modelos de imagens

Geração de vídeo

Crie vídeos a partir de texto ou imagens com Kling 3.0, Seedance 2.0, Veo 3 e Wan 2.7. Mesmo ciclo de tarefa, mesmo formato de callback, mesma API key.

Ver modelos de vídeo

Geração de música

Gere músicas com Suno v4 até v5.5. Passe letra, estilo e duração — o RunAPI retorna as URLs de áudio pelo fluxo padrão de polling de tarefas.

Ver modelos de música

GUIAS DE MODELOS

Use qualquer modelo no OpenClaw

Cada guia mostra o prompt, comando curl, parâmetros e FAQ para chamar um modelo específico pelo RunAPI dentro do OpenClaw.

Perguntas sobre configuração do OpenClaw

Use uma RunAPI key dentro do OpenClaw.

Explore o catálogo de modelos, escolha o model ID e adicione à sua configuração de provider do OpenClaw.

Explorar modelos →

Use RunAPI no OpenClaw.

Instale RunAPI no OpenClaw com um prompt

Cole o prompt de setup

Revise a configuração gerada

Verifique a seleção

Campos de configuração

Uma API key. Imagens, vídeo e música.

Geração de imagens

Geração de vídeo

Geração de música

Use qualquer modelo no OpenClaw

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