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.2" with display name "RunAPI GPT 5.2".
- Set the default model to "runapi/gpt-5.2" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.2` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

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

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

Copy prompt first /v1

VISÃO GERAL

O que esta configuração muda

OpenClaw pode chamar providers de modelo personalizados compatíveis com OpenAI por meio da configuração de providers. O caminho mais rápido é colar o prompt de setup da RunAPI no OpenClaw e deixar o agente atualizar a própria configuração. O provider ID fica local na sua configuração do OpenClaw, a referência de modelo vira runapi/gpt-5.2 e a API key permanece em RUNAPI_API_KEY.

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.

FAQ

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 →