Configuración de OpenClaw

Aprende a configurar OpenClaw para usar la API de Aiberm. Esta guía cubre la instalación y la configuración en Windows, macOS y Linux.

¿Qué es OpenClaw?

OpenClaw es una plataforma de agentes de IA de código abierto que lleva la asistencia de IA directamente a tu terminal y a tus aplicaciones de mensajería. Admite varios proveedores de LLM y se puede ampliar con plugins.

Al instalar el plugin openclaw-aiberm, puedes acceder a todos los modelos disponibles en Aiberm (incluidos GPT, Claude, Gemini, DeepSeek, Grok y más) a través de una interfaz unificada con una sola clave de API.

Requisitos previos

Antes de empezar, asegúrate de tener:

Una cuenta de Aiberm (Regístrate aquí)
Una clave de API de Aiberm (Obtén tu clave)
Acceso a Terminal/Símbolo del sistema en tu computadora
Node.js 18+ instalado

Instalación

Paso 1: Instalar OpenClaw

macOS y Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

O usando npm:

npm i -g openclaw

Windows:

npm i -g openclaw

Verificar la instalación:

openclaw --version

Paso 2: Instalar el plugin de Aiberm

Instala el plugin de proveedor de Aiberm:

openclaw plugins install openclaw-aiberm

Activa el plugin:

openclaw plugins enable openclaw-aiberm

Importante: Después de activarlo, reinicia el gateway para que los cambios surtan efecto:

openclaw gateway restart

Autenticación

Después de instalar y activar el plugin, autentícate con tu clave de API de Aiberm:

openclaw models auth login --provider aiberm --set-default

Se te pedirá que ingreses tu clave de API de Aiberm. Obtén tu clave de API en https://aiberm.com/console/token.

Si necesitas cambiar a otro modelo, puedes volver a ejecutar openclaw onboard, seleccionar Skip for now en Model/auth provider, seleccionar aiberm en Filter models by provider y luego elegir el modelo al que quieres cambiar en la lista de modelos.

Si estás en un contenedor Docker donde instalar plugins es inconveniente, puedes consultar de forma directa este archivo de configuración y guardarlo en ~/.openclaw/openclaw.json.

Modelos disponibles

El plugin carga los modelos de forma dinámica desde la API de Aiberm. Estos son algunos ejemplos:

OpenAI GPT

aiberm/openai/gpt-5.2-codex
aiberm/openai/gpt-5.2
aiberm/openai/gpt-4.1
aiberm/openai/gpt-4o
aiberm/openai/gpt-4o-mini

Anthropic Claude

aiberm/anthropic/claude-opus-4.5
aiberm/anthropic/claude-sonnet-4.5
aiberm/anthropic/claude-haiku-4.5
aiberm/anthropic/claude-sonnet-4.5:thinking

Google Gemini

aiberm/google/gemini-3-pro
aiberm/google/gemini-3-flash
aiberm/google/gemini-2.5-pro

DeepSeek

aiberm/deepseek/deepseek-r1
aiberm/deepseek/deepseek-v3.2

X.AI Grok

aiberm/x-ai/grok-4.1-fast
aiberm/x-ai/grok-code-fast-1

Visita Aiberm Pricing para ver la lista completa y actualizada de modelos disponibles.

Uso

Después de autenticarte, puedes empezar a usar OpenClaw. Para un uso detallado, consulta la documentación de OpenClaw.

Listar los modelos instalados:

openclaw models list | grep aiberm

Variable de entorno

También puedes definir la clave de API mediante una variable de entorno:

export AIBERM_API_KEY=sk-your-api-key

Carga dinámica de modelos

El plugin openclaw-aiberm incluye carga dinámica de modelos:

Cuando se carga el plugin, obtiene la lista de modelos más reciente desde la API de Aiberm
Si la API no está disponible, el plugin recurre a una lista de modelos integrada
Durante la autenticación, se vuelven a obtener los modelos más recientes

Esto significa:

Los modelos nuevos están disponibles de inmediato, sin actualizaciones del plugin
Los modelos obsoletos se eliminan de forma automática
Las capacidades de los modelos siempre están actualizadas

Solución de problemas

Error “No provider plugins found”

Asegúrate de haber:

Instalado el plugin: openclaw plugins install openclaw-aiberm
Activado el plugin: openclaw plugins enable openclaw-aiberm
Reiniciado el gateway: openclaw gateway restart

Errores 401/403

Error 401: La clave de API no está definida o no es válida
Error 403: Permisos insuficientes o clave vencida
Verifica tu clave de API en Aiberm Console

El plugin no se carga

Comprueba si el plugin está activado:

openclaw plugins list

Si no está activado, ejecuta:

openclaw plugins enable openclaw-aiberm
openclaw gateway restart