English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

OpenClaw requiere Node 22.19+, Node 23.11+ o Node 24+. Node 24 es el runtime predeterminado y recomendado para instalaciones, CI y flujos de trabajo de lanzamiento. Node 22 sigue siendo compatible mediante la línea LTS activa. El script de instalación detectará e instalará Node automáticamente; esta página es para cuando quieres configurar Node por tu cuenta y asegurarte de que todo esté conectado correctamente (versiones, PATH, instalaciones globales).

Comprueba tu versión

bash
node -v

Si esto imprime v24.x.x o superior, estás en el valor predeterminado recomendado. Si imprime v22.19.x o superior, estás en la ruta LTS de Node 22 compatible, pero aun así recomendamos actualizar a Node 24 cuando sea conveniente. Las versiones de Node 23 anteriores a v23.11.0 no son compatibles. Si Node no está instalado o la versión está fuera del intervalo compatible, elige un método de instalación a continuación.

Instalar Node

macOS

Homebrew (recomendado):

bash
brew install node

O descarga 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

O usa un gestor de versiones (consulta más abajo).

Windows

winget (recomendado):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

O descarga el instalador para Windows desde nodejs.org.

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

Los gestores de versiones te permiten cambiar entre versiones de Node fácilmente. Opciones populares:

  • fnm - rápido y multiplataforma
  • nvm - muy usado 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 tu PATH.

  • Encuentra tu prefijo global de npm

    bash
    npm prefix -g

  • Comprueba si está en tu PATH

    bash
    echo "$PATH"

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

  • Añádelo a tu archivo de inicio del shell

    macOS / Linux

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

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

    Luego abre una nueva terminal (o ejecuta rehash en zsh / hash -r en bash).

    Windows

    Añade la salida de npm prefix -g a tu PATH del sistema mediante Configuración → Sistema → Variables de entorno.

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

    Si ves errores EACCES, cambia el prefijo global de npm a un directorio en el que el usuario pueda escribir:

    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 tu ~/.bashrc o ~/.zshrc para hacerla permanente.

    Relacionado

    Was this useful?
    On this page

    On this page