Instalación de OpenClaw y configuración de OmniProxy

OpenClaw es un asistente de IA instalado en tu propio ordenador. 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 este equipo, y puede continuar realizando los pasos siguientes de forma local.

Antes de empezar

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

Se puede instalar en macOS, Linux y Windows. Si el ordenador 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. Solo se requiere pnpm al compilar OpenClaw desde el código fuente.

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

¿Quieres una ventana?

Compañero de escritorio

Usa el instalador Hub en Windows
Usa el DMG de GitHub en macOS
La 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 quieres 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. Es preferible 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 Gateway en este ordenador o conectarte a una Gateway remota 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 onboarding te guiará a través de la configuración inicial.

Si aún no quieres iniciar el onboarding, usa lo siguiente en su lugar 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 posteriores, ejecuta:

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

Para npm 11.15 y anteriores, elimina --allow-scripts=openclaw. Al usar pnpm, añade --allow-build=openclaw. Consulta la página de instalación para conocer 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 Gateway se está ejecutando. 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, normalmente falta el directorio bin global de npm en el 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 al PATH y luego vuelve a abrir la terminal.

Si ~/.openclaw ya contiene una configuración en uso, el script de instalación predeterminado utilizará 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. Tras la instalación, ejecuta el ejecutable openclaw desde la carpeta bin del directorio.

Obtener valores de conexión de OmniProxy

Primero confirma que OmniProxy se está ejecutando, 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 a fecha de 09-10-2026; no los uses si no aparecen en la lista: claude-sonnet-5-5, gpt-6-luna.

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

Introducir la configuración de la herramienta

Un proveedor (Provider) puede entenderse como un conjunto de ajustes de conexión que OpenClaw utiliza para localizar un servicio de modelos. Aquí, el proveedor se llama omniproxy.

Ejecuta el siguiente comando en la terminal, sustituyendo la dirección, la clave y los dos IDs 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 el proveedor y la lista de modelos en la configuración. No necesitas reiniciar 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 que ya estén presentes en el ID. Si el ID en la lista de modelos es más largo que el nombre corto de abajo, 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 gestionan utilizando 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 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, anula 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 de la gateway como fuente de verdad

Primero confirma que se puede encontrar el comando, luego introduce la dirección y el modelo. La referencia del modelo debe incluir el nombre del proveedor.

Verificar una tarea real

Entra en un directorio de proyecto normal y envía un mensaje muy corto. Sustituye la referencia del modelo en el comando por 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 de espera máximo 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 vuelve a enviar la solicitud. 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 de Gateway es legible

Tarea

Completó una pequeña tarea

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

Registros

Visible en la 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 salida, también debes recibir una respuesta real.

Errores comunes

No se puede encontrar openclaw: Añade el directorio bin global de npm al 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í mismo.
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 anulado.
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 se está ejecutando, que baseUrl termina con /v1 y que la dirección escrita en la configuración es 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 utilizados en los ejemplos, compáralos 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 total del Agente. Comprueba el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · OpenClaw ↗