Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

Homebrew (recomendado):
brew install node
O descarga el instalador de macOS desde nodejs.org.
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:
fnm install 24
fnm use 24
Asegúrate de que tu gestor de versiones esté inicializado en el archivo de inicio de tu shell (~/.zshrc o ~/.bashrc). Si no lo está, puede que openclaw no se encuentre en nuevas sesiones de terminal porque PATH no incluirá el directorio bin de Node.

​
Solución de problemas

​
openclaw: command not found

Esto casi siempre significa que el directorio bin global de npm no está en tu PATH.
1

Encuentra tu prefijo global de npm

npm prefix -g
2

Verifica si está en tu PATH

echo "$PATH"
Busca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en la salida.
3

Agrégalo al archivo de inicio de tu shell

Agrega a ~/.zshrc o ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Luego abre una nueva terminal (o ejecuta rehash en zsh / hash -r en bash).

​
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: 
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