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.16 o posterior. Node 24 es el runtime predeterminado y recomendado para instalaciones, CI y flujos de trabajo de lanzamiento. Node 22 sigue siendo compatible a través de 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).

Verifica tu versión

bash
node -v

Si esto imprime v24.x.x o superior, estás usando el valor predeterminado recomendado. Si imprime v22.16.x o superior, estás en la ruta compatible de Node 22 LTS, pero aun así recomendamos actualizar a Node 24 cuando sea conveniente. Si Node no está instalado o la versión es demasiado antigua, elige un método de instalación a continuación.

Instalar Node

macOS

Homebrew (recomendado):

bash
brew install node

O descarga el instalador de 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 abajo).

Windows

winget (recomendado):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

O descarga el instalador de Windows desde nodejs.org.

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

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

  • fnm - rápido, multiplataforma
  • nvm - ampliamente 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

  • Verifica si está en tu PATH

    bash
    echo "$PATH"

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

  • Agrégalo al archivo de inicio de tu shell

    macOS / Linux

    Agrega 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

    Agrega la salida de npm prefix -g al 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"

    Agrega la línea export PATH=... a tu ~/.bashrc o ~/.zshrc para hacerla permanente.

    Relacionado

    Was this useful?