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.22.3+, Node 24.15+ o Node 25.9+. 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 línea LTS activa. Node 23 no es compatible. El script de instalación detecta e instala Node automáticamente; use esta página cuando quiera configurar Node por su cuenta (versiones, PATH, instalaciones globales).

Comprobar la versión

bash
node -v

v24.15.0 o una versión 24.x posterior es la opción predeterminada recomendada. v22.22.3 o una versión 22.x posterior es la ruta compatible de Node 22 LTS; Node v25.9.0+ también es compatible. Node 23 no es compatible. Si Node no está instalado o se encuentra fuera del intervalo compatible, elija uno de los métodos de instalación siguientes.

Instalar Node

macOS

Homebrew (recomendado):

bash
brew install node

También puede 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 puede usar un gestor de versiones (consulte la sección siguiente).

Windows

winget (recomendado):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

También puede 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. Algunas opciones populares son:

  • fnm - rápido y multiplataforma
  • nvm - muy utilizado en macOS/Linux
  • mise - políglota (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 bin global de npm no está en PATH.

  • Buscar el prefijo global de npm

    bash
    npm prefix -g

  • Comprobar si está en PATH

    bash
    echo "$PATH"

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

  • Añadirlo al archivo de inicio del shell

    macOS / Linux

    Añádalo a ~/.zshrc o ~/.bashrc:

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

    A continuación, abra una terminal nueva (o ejecute rehash en zsh / hash -r en bash).

    Windows

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

    • Errores de permisos en npm install -g (Linux)

    Si aparecen errores EACCES, cambie 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ñada 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