Instalación de OpenClaw y configuración de OmniProxy

OpenClaw es un asistente de IA instalado en tu propia computadora. Puedes hablar con él directamente a través de Telegram, Discord, WhatsApp o Feishu sin necesidad de mantener otra ventana de chat abierta. Las conversaciones y los registros permanecen en esta computadora, y puede continuar ejecutando los pasos siguientes de forma local.

Antes de comenzar

OpenClaw requiere Node 24.16 o posterior. También puedes usar Node 26.1 o posterior, siendo Node 26 la versión recomendada. Node proporciona el entorno de ejecución necesario para OpenClaw.

Se puede instalar en macOS, Linux y Windows. Si la computadora no tiene una versión adecuada de Node, el script de instalación preparará una automáticamente: Node 26 en macOS y Node 24 LTS en Linux. pnpm solo es necesario si compilas OpenClaw desde el código fuente.

Si ya tienes instalada una versión anterior de Node, no es necesario desinstalarla primero. Durante las pruebas realizadas el 09-10-2026, la versión de Node del sistema en esta computadora era 24.2.0, inferior a la 24.16 requerida, y el script de instalación no interactivo preparó Node 24.21.0 automáticamente.

¿Quieres una ventana?

Compañero de escritorio

Usa el instalador Hub en Windows
Usa el DMG de GitHub en macOS
El Gateway local se puede instalar durante la configuración inicial

Recomendado oficialmente

Script de instalación

macOS Linux WSL2
Usa PowerShell en Windows
Puedes añadir --no-onboard

Node ya instalado

Gestor de paquetes

npm pnpm o bun
Luego ejecuta onboard
Consulta la página de instalación para ver la versión de Node

Descarga el compañero de escritorio si quieres una ventana. Si solo deseas usarlo en la terminal, ejecuta el script de instalación oficial.

Instalación y primer inicio

Puedes instalar el compañero de escritorio con una ventana gráfica o instalarlo directamente a través de la terminal. Gateway es el servicio local responsable de recibir mensajes, llamar a los modelos y devolver los resultados. Puedes configurarlo al abrir el compañero de escritorio por primera vez.

Si quieres una ventana

Windows: Descarga y ejecuta OpenClawCompanion-Setup-x64.exe o OpenClawCompanion-Setup-arm64.exe. El instalador está firmado e incluye ajustes, estado en la bandeja del sistema, chat y modos de nodo.
macOS: Descarga el OpenClaw .dmg desde los lanzamientos de GitHub de OpenClaw. Prefiere el dmg, aunque también puedes usar el .zip. Abre OpenClaw.app después de la instalación. Si esta versión no incluye un archivo para macOS, sigue la página de la aplicación para macOS.

Al abrirlo por primera vez, puedes dejar que OpenClaw prepare el Gateway en esta computadora o conectarte a un Gateway remoto existente.

Instalación a través de la terminal

Para macOS, Linux y WSL2, usa:

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

Para PowerShell en Windows, usa:

iwr -useb https://openclaw.ai/install.ps1 | iex

El script detecta el sistema actual, instala Node cuando es necesario, instala OpenClaw y luego inicia el proceso de configuración inicial (onboarding). El flujo de configuración te guiará durante la primera puesta en marcha.

Si aún no quieres iniciar la configuración, usa lo siguiente en macOS, Linux y WSL2:

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

En Windows, usa la opción oficial -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Si ya gestionas Node por tu cuenta, también puedes usar npm, pnpm o bun. Con npm 12 o npm 11.16 y versiones posteriores, ejecuta:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Para npm 11.15 y versiones anteriores, elimina --allow-scripts=openclaw. Al usar pnpm, añade --allow-build=openclaw. Consulta la página de instalación para ver las diferencias exactas.

Tras la instalación, ejecuta estos tres comandos en orden:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version muestra la versión, openclaw doctor comprueba problemas comunes del entorno y openclaw gateway status muestra si el Gateway está en ejecución. La instalación básica se completa solo cuando los tres comandos producen una salida normal.

Si la terminal informa que no puede encontrar openclaw, generalmente falta el directorio bin global de npm en PATH. PATH es la lista de ubicaciones donde la terminal busca programas. Compara la salida de node -v, npm prefix -g y echo "$PATH", añade el directorio bin correspondiente a PATH y luego vuelve a abrir la terminal.

Si ~/.openclaw ya contiene una configuración en uso, el script de instalación predeterminado usará ese directorio. Para instalar una copia separada sin cambiar la configuración existente, ejecuta el script no interactivo y especifica un nuevo directorio:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard es el comportamiento predeterminado de este script. El 09-10-2026, este comando instaló OpenClaw 2026.9.9. Después de la instalación, ejecuta el ejecutable openclaw desde la carpeta bin del directorio.

Obtener valores de conexión de OmniProxy

Primero confirma que OmniProxy esté en ejecución, luego abre su lista de modelos y prepara los siguientes tres valores:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl es la dirección a la que OpenClaw envía las solicitudes de modelo, y debe terminar con /v1. Al conectarte a OmniProxy, usa openai-completions para api. Cámbialo a openai-responses solo si el modelo realmente funciona a través de /v1/responses.

El ID del modelo es el identificador completo del modelo en la lista. Cópialo exactamente como se muestra, incluyendo cualquier barra diagonal. Los siguientes dos nombres son solo referencias de la documentación del proveedor al 09-10-2026; no los uses si no aparecen en la lista: claude-sonnet-5-5, gpt-6-luna.

Incluso si el gateway no valida la clave, apiKey debe contener un valor. Puedes usar una cadena de marcador de posición que solo se use en esta computadora. No subas una clave real a un repositorio.

Ingresar la configuración de la herramienta

Un Proveedor puede entenderse como un conjunto de ajustes de conexión que OpenClaw utiliza para localizar un servicio de modelo. Aquí, el Proveedor se llama omniproxy.

Ejecuta el siguiente comando en la terminal, reemplazando la dirección, la clave y los dos IDs de modelo con tus propios valores:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Este comando escribe el Proveedor y la lista de modelos en la configuración. No necesitas reiniciar el Gateway después de que el comando tenga éxito.

A continuación, especifica el modelo predeterminado. La referencia del modelo consiste en omniproxy/ seguido del ID del modelo. Conserva todas las barras diagonales ya presentes en el ID. Si el ID en la lista de modelos es más largo que el nombre corto a continuación, usa el valor completo de la lista:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindow y maxTokens pueden omitirse. Cuando no se proporcionan, los modelos de texto se manejan usando los valores predeterminados.

También puedes escribir los mismos ajustes directamente en el archivo de configuración. En la configuración principal, el Proveedor se encuentra bajo models.providers. Cada agente también puede tener su propio models.json; un agente es una instancia de asistente que realmente recibe tareas y llama a los modelos. El archivo se encuentra en agent/models.json dentro del directorio del agente correspondiente bajo ~/.openclaw/agents/.

Si este models.json contiene un baseUrl no vacío, este sobrescribe la dirección en la configuración principal.

Comprobar instalación

Tres comandos

openclaw --version
openclaw doctor
gateway status

Configuración

models.providers

baseUrl termina con /v1
Establecer api en completions
Especificar al menos el id del modelo

Seleccionar

provider/model

Usar esta referencia para el principal
Preferir una variable de entorno para la clave
Usar la lista del gateway como fuente de verdad

Primero confirma que se pueda encontrar el comando, luego ingresa la dirección y el modelo. La referencia del modelo debe incluir el nombre del Proveedor.

Verificar una tarea real

Ingresa a un directorio de proyecto regular y envía un mensaje muy corto. Reemplaza la referencia del modelo en el comando con tu ID de modelo completo:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local ejecuta esta tarea de agente localmente, --model especifica el modelo a usar para esta ejecución y --timeout 300 establece el tiempo máximo de espera en 300 segundos.

Debe aparecer una respuesta real del modelo en la terminal. El 09-10-2026, OpenClaw 2026.9.9 recibió una respuesta usando este comando. La primera llamada puede tardar uno o dos minutos.

Si aparece el error original Request timed out before a response was generated, aumenta --timeout y envía la solicitud de nuevo. Esto generalmente significa que el tiempo de espera fue insuficiente y no indica necesariamente que la dirección sea incorrecta.

Después de que la respuesta corta tenga éxito, pídele que lea un archivo local que especifiques. Luego abre los registros de solicitudes de OmniProxy y confirma la fuente y el ID del modelo que se muestran en el registro. La salida solo del comando de versión o doctor no significa que la conexión del modelo se haya configurado completamente.

Instalación

El comando responde

Se muestra el número de versión
doctor informa que no hay bloqueos
El estado del Gateway es legible

Tarea

Completó una tarea pequeña

Por ejemplo, leer un archivo local
La respuesta no es un error
La referencia del modelo es correcta

Registros

Visible en el gateway

La fuente es OpenClaw
El ID del modelo coincide
La clave no se añadió al repositorio

Después de que el comando de versión produzca una salida, también debes recibir una respuesta real.

Errores comunes

No se puede encontrar openclaw: Añade el directorio bin global de npm a PATH, luego vuelve a abrir la terminal. Si instalaste en un directorio especificado, ejecuta el ejecutable desde la carpeta bin de ese directorio.
node -v es inferior a 24.16: No necesitas desinstalar la versión antigua primero. Comprueba la versión de Node preparada por el script de instalación, o usa 24.16+ o 26.1+ como se describe en la página de instalación. Se recomienda Node 26.
El modelo no aparece: El modelo debe estar incluido en la matriz models bajo models.providers y debe tener al menos el mismo id. Establecer solo agents.defaults.models no registra un nuevo modelo por sí solo.
Una respuesta 400 menciona el rol de desarrollador: Cuando el host de la dirección no es api.openai.com, mantén el valor predeterminado y no establezcas supportsDeveloperRole en true. Incluso si se establece en true, seguirá siendo sobrescrito.
Se agota el tiempo de espera rápidamente: Aumenta --timeout a más de 300 segundos antes de cambiar la dirección.
Las llamadas a herramientas fallan después de seleccionar gpt-6-luna: Soporta Chat Completions; la llamada a funciones en Chat Completions solo se admite cuando reasoning_effort es none. Si el ID en la lista difiere de este, usa el ID que se muestra en la lista.
No se puede alcanzar la dirección: Confirma que OmniProxy esté en ejecución, que baseUrl termine con /v1 y que la dirección escrita en la configuración sea accesible. Otras direcciones de red privada deben permitirse por separado.
Las solicitudes siguen yendo a otra dirección después de la configuración: Comprueba si el models.json de ese agente contiene un baseUrl diferente.

Referencias oficiales

Para los pasos de instalación, consulta OpenClaw install. Para la configuración personalizada del Proveedor, consulta Custom providers y configuration fields. Para los IDs de modelo usados en los ejemplos, compara con Claude model overview y GPT-6 Luna.

Reemplaza cada marcador de posición con valores de tu propia configuración de OmniProxy. Nunca publiques una clave real.

Un resultado guardado o HTTP 200 por sí solo no prueba la compatibilidad completa del Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · OpenClaw ↗