---
title: "Use RunAPI no OpenClaw - Guia de configuração compatível com OpenAI"
url: "https://runapi.ai/pt-BR/openclaw.md"
canonical: "https://runapi.ai/pt-BR/openclaw"
locale: "pt-BR"
---

# RunAPI in 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.

## Install prompt

Copy this prompt into OpenClaw:

```text
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.
```

## Configuration

```json5
{
  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,
          },
        ],
      },
    },
  },
}
```

## Steps

1. **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.
2. **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.
3. **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.

## FAQ

### 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.


## Links

- [Model catalog](https://runapi.ai/pt-BR/models)
- [CLI](https://runapi.ai/pt-BR/cli)
- [MCP Server](https://runapi.ai/pt-BR/mcp)
- [Pricing](https://runapi.ai/pt-BR/pricing)
- [API docs](https://runapi.ai/pt-BR/docs)
- [Hermes Agent setup](https://runapi.ai/pt-BR/hermes-agent)