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

GUÍA OPENCLAW

Usa RunAPI en 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.

Obtener API Key gratis Leer la documentación

Copiar prompt · una RunAPI key · enlaces al 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

RESUMEN

Qué cambia esta configuración

OpenClaw puede llamar proveedores de modelos personalizados compatibles con OpenAI desde su configuración de proveedores. La ruta más rápida es pegar el prompt de configuración de RunAPI en OpenClaw y dejar que el agente actualice su propia configuración. El ID del proveedor queda local en tu configuración de OpenClaw, la referencia del modelo pasa a ser runapi/gpt-5.2 y la API key se mantiene en RUNAPI_API_KEY.

CONFIGURACIÓN

Instala RunAPI en OpenClaw con un prompt

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.

Copiar prompt

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.

runapi/gpt-5.2

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.

openclaw models status

REFERENCIA

Campos de configuración

Campo	Valor	Propósito
`baseUrl`	`https://runapi.ai/v1`	Apunta OpenClaw a la superficie API compatible con OpenAI de RunAPI.
`apiKey`	`${RUNAPI_API_KEY}`	Lee la RunAPI API key desde el entorno.
`api`	`openai-completions`	Usa el adaptador de Chat Completions esperado por endpoints compatibles con OpenAI.
`agents.defaults.model.primary`	`runapi/gpt-5.2`	Selecciona el modelo de RunAPI como modelo predeterminado para nuevas sesiones de OpenClaw.

FAQ

Preguntas sobre la configuración de OpenClaw

Usa una sola RunAPI key dentro de OpenClaw.

Explora el catálogo de modelos, elige el model ID y agrégalo a tu configuración de proveedor de OpenClaw.

Explorar modelos →