OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

OpenClaw requiere Node 22.19+, Node 23.11+ o Node 24+. Node 24 es el entorno de ejecución predeterminado y recomendado para instalaciones, CI y flujos de trabajo de publicación; Node 22 sigue siendo compatible mediante la rama LTS activa. El script de instalación detecta e instala Node automáticamente; usa esta página cuando quieras configurar Node por tu cuenta (versiones, PATH, instalaciones globales).

Comprobar la versión

bash
node -v

v24.x.x o posterior es la opción predeterminada recomendada. v22.19.x o posterior es la versión compatible de la rama LTS de Node 22 (actualiza a Node 24 cuando te resulte conveniente). Las compilaciones de Node 23 anteriores a v23.11.0 no son compatibles. Si Node no está instalado o su versión está fuera del intervalo compatible, elige uno de los métodos de instalación siguientes.

Instalar Node

macOS

Homebrew (recomendado):

bash
brew install node

También puedes descargar el instalador para macOS desde nodejs.org.

Linux

Ubuntu / Debian:

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL:

bash
sudo dnf install nodejs

También puedes usar un gestor de versiones (consulta la sección siguiente).

Windows

winget (recomendado):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

También puedes descargar el instalador para Windows desde nodejs.org.

Uso de un gestor de versiones (nvm, fnm, mise, asdf)

Los gestores de versiones permiten cambiar fácilmente entre versiones de Node. Estas son algunas opciones populares:

  • fnm: rápido y multiplataforma
  • nvm: muy utilizado en macOS/Linux
  • mise: compatible con varios lenguajes (Node, Python, Ruby, etc.)

Ejemplo con fnm:

bash
fnm install 24fnm use 24

Solución de problemas

openclaw: command not found

Esto casi siempre significa que el directorio global de binarios de npm no está incluido en PATH.

  • Buscar el prefijo global de npm

    bash
    npm prefix -g

  • Comprobar si está incluido en PATH

    bash
    echo "$PATH"

    Busca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en la salida.

  • Añadirlo al archivo de inicio del shell

    macOS / Linux

    Añade lo siguiente a ~/.zshrc o ~/.bashrc:

    bash
    export PATH="$(npm prefix -g)/bin:$PATH"

    Después, abre una terminal nueva (o ejecuta rehash en zsh / hash -r en bash).

    Windows

    Añade la salida de npm prefix -g al PATH del sistema mediante Settings → System → Environment Variables.

    • Errores de permisos al ejecutar npm install -g (Linux)

    Si aparecen errores EACCES, cambia el prefijo global de npm a un directorio en el que el usuario tenga permisos de escritura:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Añade la línea export PATH=... a ~/.bashrc o ~/.zshrc para que el cambio sea permanente.

    Contenido relacionado

    Was this useful?
    On this page

    On this page