---
title: &quot;Usa RunAPI en OpenClaw - Guía de configuración compatible con OpenAI&quot;
url: &quot;https://runapi.ai/es/openclaw.md&quot;
canonical: &quot;https://runapi.ai/es/openclaw&quot;
locale: &quot;es&quot;
---

# RunAPI in OpenClaw

RunAPI funciona como endpoint compatible con OpenAI para OpenClaw. Copia el prompt en OpenClaw, deja que agregue el proveedor y usa la pestaña de configuración solo cuando quieras revisar los campos exactos.

## 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 &quot;https://runapi.ai/v1&quot;.
- Use api &quot;openai-completions&quot;.
- Register provider-local model id &quot;gpt-5.5&quot; with display name &quot;RunAPI GPT 5.5&quot;.
- Set the default model to &quot;runapi/gpt-5.5&quot; 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. **Pega el prompt de configuración** — Copia el prompt de la primera pestaña en OpenClaw. Le indica a OpenClaw que lea RUNAPI_API_KEY, agregue el proveedor runapi y conserve disponibles los proveedores existentes.
2. **Revisa la configuración generada** — OpenClaw debería agregar gpt-5.2 como ID de modelo local al proveedor y luego seleccionarlo mediante la referencia con prefijo de proveedor runapi/gpt-5.2.
3. **Verifica la selección** — Ejecuta openclaw models status, cambia al modelo de RunAPI e inicia una sesión de OpenClaw. Si el modelo no aparece, confirma que la allowlist incluya runapi/gpt-5.2.

## FAQ

### ¿OpenClaw puede usar RunAPI como proveedor de modelos personalizado?

Sí. OpenClaw admite proveedores personalizados compatibles con OpenAI mediante models.providers. Configura RunAPI con la base URL /v1, define api como openai-completions y elige la referencia de modelo con prefijo de proveedor en agents.defaults.model.primary.

### ¿El ID del modelo dentro de models.providers debe incluir el prefijo del proveedor?

No. Dentro de models.providers.runapi.models usa el ID local al proveedor, como gpt-5.2. Usa la referencia con prefijo runapi/gpt-5.2 al seleccionar el modelo en defaults o comandos de OpenClaw.

### ¿Dónde debo guardar la RunAPI API key?

Guarda la key en RUNAPI_API_KEY y léela desde la configuración de OpenClaw. Así la credencial queda fuera del control de versiones y la misma configuración funciona en shells locales, servidores y automatizaciones.

### ¿Puedo mantener mis modelos existentes de OpenClaw como fallbacks?

Sí. Mantén models.mode en merge y agrega RunAPI como un proveedor más. Los proveedores existentes siguen disponibles, y puedes agregar fallbacks en agents.defaults.model.fallbacks cuando quieras comportamiento de recuperación.


## Links

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