Instalación de OpenClaw y configuración de OmniProxy

OpenClaw es un asistente de IA que se instala en tu propio ordenador. Puedes hablar con él directamente desde Telegram, Discord, WhatsApp o Feishu, sin tener que mantener abierta otra ventana de chat; las conversaciones y los registros permanecen en ese ordenador, y también puede continuar allí con los pasos posteriores.

Preparativos antes de la instalación

OpenClaw requiere Node 24.16 o una versión posterior; también se puede usar Node 26.1 o posterior. Se recomienda Node 26. Node es el entorno básico que OpenClaw necesita para ejecutarse.

Puede instalarse en macOS, Linux y Windows. Si el ordenador no tiene una versión adecuada de Node, el script de instalación la preparará automáticamente: Node 26 en macOS y Node 24 LTS en Linux. pnpm solo es necesario cuando se compila OpenClaw desde el código fuente.

Si ya tienes instalada una versión anterior de Node, no hace falta desinstalarla de inmediato. En la prueba del 2026-10-09, el Node del sistema de este ordenador era la versión 24.2.0, inferior a la 24.16 requerida, y el script de instalación no interactiva preparó automáticamente Node 24.21.0.

Si quieres una ventana

Asistente de escritorio

En Windows, usa el instalador de Hub
En macOS, usa el DMG de GitHub
La primera vez puedes instalar un Gateway local

Recomendación oficial

Script de instalación

macOS Linux WSL2
En Windows, usa PowerShell
Puedes añadir --no-onboard

Si ya tienes Node

Gestor de paquetes

npm, pnpm o bun
Después, ejecuta onboard
Consulta la versión de Node en la página de instalación

Si quieres una ventana, descarga la aplicación complementaria de escritorio. Si solo vas a usar el terminal, ejecuta el script de instalación oficial.

Instalación y primer inicio

Puedes instalar la aplicación complementaria de escritorio con interfaz gráfica o realizar la instalación directamente desde el terminal. Gateway es el servicio local que recibe mensajes, llama al modelo y devuelve los resultados; puedes prepararlo al abrir por primera vez la aplicación complementaria de escritorio.

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, chat y modo node.
macOS: descarga el archivo .dmg de OpenClaw desde las releases de GitHub de OpenClaw. Usa preferentemente el dmg, aunque también puedes utilizar el archivo .zip. Después de la instalación, abre OpenClaw.app. Si esta versión no incluye archivos para macOS, sigue las indicaciones de la página de la aplicación para macOS.

La primera vez que lo abras, puedes permitir que OpenClaw prepare Gateway en este ordenador o conectarte a un Gateway remoto que ya exista.

Instalación desde el terminal

En macOS, Linux y WSL2, usa:

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

En Windows PowerShell, usa:

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

El script detecta el sistema actual, instala Node cuando es necesario, instala OpenClaw e inicia el asistente de configuración. Este asistente te guiará durante la configuración inicial.

Si por ahora no quieres iniciar el asistente, en macOS, Linux y WSL2 usa en su lugar:

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 administras Node por tu cuenta, también puedes utilizar npm, pnpm o bun. Con npm 12 y npm 11.16 o versiones posteriores, ejecuta:

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

Con npm 11.15 y versiones anteriores, debes quitar --allow-scripts=openclaw. Si utilizas pnpm, debes añadir --allow-build=openclaw. Consulta la página de instalación para conocer las diferencias concretas.

Después de completar 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 habituales del entorno y openclaw gateway status indica si Gateway está en ejecución. La instalación básica solo se considera completada cuando los tres comandos producen una salida normal.

Si el terminal indica que no encuentra openclaw, normalmente significa que el directorio bin global de npm no está incluido en PATH. PATH es la lista de ubicaciones en las que el terminal busca programas. Puedes comparar los resultados de node -v, npm prefix -g y echo "$PATH", añadir a PATH el directorio bin correspondiente y volver a abrir el terminal.

Si ya tienes una configuración en uso dentro de ~/.openclaw, el script de instalación predeterminado utilizará ese directorio. Si quieres instalar otra copia sin modificar la configuración original, ejecuta el script no interactivo e indica un directorio nuevo:

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 2026-10-09, este comando instaló OpenClaw 2026.9.9. Una vez terminada la instalación, debes ejecutar el archivo openclaw del directorio bin correspondiente.

Obtener los parámetros de conexión de OmniProxy

Primero confirma que OmniProxy está en ejecución. Después, abre su lista de modelos y prepara estos tres datos:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copia el ID completo de la lista actual de modelos de OmniProxy

baseUrl es la dirección a la que OpenClaw envía las solicitudes del modelo y debe terminar en /v1. Al conectar OmniProxy, utiliza openai-completions como valor de api. Cámbialo a openai-responses únicamente si el modelo realmente funciona mediante /v1/responses.

Model ID es el identificador completo del modelo en la lista. Cópialo exactamente como aparece; si contiene barras, debes conservarlas. Los dos nombres siguientes solo sirven como referencia respecto a la documentación de los proveedores del 2026-10-09. No los utilices si no aparecen en la lista: claude-sonnet-5-5, gpt-6-luna.

Aunque el gateway no compruebe la clave, apiKey debe contener algún valor. Puedes utilizar una cadena de caracteres de sustitución que solo se use en este ordenador. No envíes una clave real al repositorio.

Introducir la configuración de la herramienta

Un Provider puede entenderse como el conjunto de ajustes de conexión que OpenClaw utiliza para localizar el servicio del modelo. Aquí se asignará al Provider el nombre omniproxy.

Ejecuta el siguiente comando en el terminal y sustituye la dirección, la clave y los dos ID de modelo por 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 en la configuración el Provider y la lista de modelos. Si el comando se completa correctamente, no es necesario reiniciar Gateway.

A continuación, especifica el modelo predeterminado. La referencia del modelo se compone de omniproxy/ y el ID del modelo. Conserva todas las barras que ya contenga el ID. Si el ID de la lista de modelos es más largo que el nombre abreviado mostrado a continuación, utiliza el valor completo de la lista:

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

Puedes omitir reasoning, input, cost, contextWindow y maxTokens. Si no los especificas, los modelos de texto se gestionarán de la forma predeterminada.

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

Si este models.json contiene un baseUrl no vacío, esa dirección sustituirá a la de la configuración principal.

Comprobar la instalación

Tres comandos

openclaw --version
openclaw doctor
gateway status

Configuración

models.providers

baseUrl debe terminar en /v1
Usa completions para api
Especifica al menos el id del modelo

Selección

provider/modelo

Usa esta referencia para primary
Es preferible proporcionar la clave mediante una variable de entorno
Usa la lista de la puerta de enlace

Primero confirma que se encuentra el comando y después introduce la dirección y el modelo. La referencia del modelo debe incluir el nombre del Provider.

Verificar una tarea real

Entra en el directorio de un proyecto normal y envía un mensaje muy corto. Sustituye la referencia de modelo del comando por tu Model ID completo:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Responde con una palabra."

--local indica que esta tarea del agent se ejecutará en el equipo local, --model especifica el modelo que se utilizará y --timeout 300 establece un tiempo de espera máximo de 300 segundos.

Debe aparecer una respuesta real del modelo en el terminal. El 2026-10-09, OpenClaw 2026.9.9 recibió una respuesta mediante 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 primero el valor de --timeout y vuelve a enviar la solicitud. Normalmente, esto significa que el tiempo de espera era insuficiente y no necesariamente que la dirección sea incorrecta.

Después de recibir correctamente la respuesta corta, pídele que lea un archivo local que hayas especificado. A continuación, abre el registro de llamadas de OmniProxy y confirma el origen y el ID del modelo que aparecen en el registro. Que el número de versión o doctor produzcan una salida no basta para demostrar que la conexión con el modelo se ha configurado correctamente.

Instalación

El comando responde

Se puede mostrar el número de versión
doctor no muestra ningún bloqueo
El estado de Gateway se puede consultar

Tarea

Ha realizado una tarea pequeña

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

Registro

Es visible en la puerta de enlace

El origen es OpenClaw
El ID del modelo coincide
La clave no está en el repositorio

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

Errores habituales

No se encuentra openclaw: añade el directorio bin global de npm a PATH y vuelve a abrir el terminal. Si realizaste la instalación en un directorio específico, ejecuta el programa que se encuentra en su directorio bin.
node -v muestra una versión anterior a 24.16: no es necesario desinstalar primero la versión antigua. Comprueba el Node preparado por el script de instalación o utiliza una versión 24.16+ o 26.1+ siguiendo la página de instalación. Se recomienda Node 26.
El modelo no aparece: el modelo debe estar incluido en el array models de models.providers y debe contener como mínimo el mismo id. Definir únicamente agents.defaults.models no registra por separado un modelo nuevo.
Se devuelve un error 400 que menciona el rol developer: si el host de la dirección no es api.openai.com, conserva el valor predeterminado y no configures supportsDeveloperRole como true. Aunque lo configures como true, seguirá siendo sustituido.
Se agota el tiempo de espera muy rápidamente: aumenta --timeout a más de 300 segundos y no cambies todavía la dirección.
Has seleccionado gpt-6-luna, pero falla la llamada a herramientas: admite Chat Completions; dentro de Chat Completions, las llamadas a funciones solo son compatibles cuando reasoning_effort es none. Si el ID de la lista es diferente, utiliza el de la lista.
No se puede conectar con la dirección: confirma que OmniProxy está en ejecución, que baseUrl termina en /v1 y que se puede acceder a la dirección guardada en la configuración. Las demás direcciones de redes privadas deben autorizarse por separado.
Después de configurarlo, las solicitudes siguen dirigiéndose a otra dirección: comprueba si el models.json de ese agent contiene otro baseUrl.

Referencias oficiales

Consulta los pasos de instalación en OpenClaw install. Para configurar un Provider personalizado, consulta Custom providers y campos de configuración. Puedes contrastar los ID de modelo usados en los ejemplos con descripción general de los modelos Claude 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 demuestra compatibilidad total con el Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · OpenClaw ↗