Guía completa para instalar el asistente de IA Clawdbot en macOS, Linux y Windows. Instalación rápida con un solo comando u opciones de configuración manual.

Descripción General de la Instalación de Clawdbot

Usa el instalador de Clawdbot a menos que tengas una razón específica para no hacerlo. Configura la CLI y ejecuta la incorporación automáticamente.

Instalación Rápida (Recomendada)

Instala Clawdbot con un solo comando:

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://clawd.bot/install.ps1 | iex

Siguiente paso (si omitiste la incorporación):

clawdbot onboard --install-daemon

Requisitos del Sistema

Requisito	Detalles
Node.js	Versión 22 o superior
Sistema Operativo	macOS, Linux o Windows vía WSL2
pnpm	Solo requerido si compilas desde el código fuente

Elige tu Método de Instalación

1. Script de Instalación (Recomendado)

El instalador de Clawdbot instala globalmente vía npm y ejecuta la incorporación:

curl -fsSL https://clawd.bot/install.sh | bash

Opciones del instalador:

curl -fsSL https://clawd.bot/install.sh | bash -s -- --help

No interactivo (omitir incorporación):

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

2. Instalación Global (Manual)

Si ya tienes Node.js instalado:

npm install -g clawdbot@latest

Si tienes libvips instalado globalmente y sharp falla:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawdbot@latest

Con pnpm:

pnpm add -g clawdbot@latest
pnpm approve-builds -g  # aprobar clawdbot, node-llama-cpp, sharp, etc.

Luego ejecuta la incorporación:

clawdbot onboard --install-daemon

3. Desde el Código Fuente (Colaboradores/Desarrollo)

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

4. Otras Opciones de Instalación

Docker: Ver Instalación con Docker
Nix: Ver Instalación con Nix
Ansible: Ver Instalación con Ansible

Después de la Instalación

Ejecuta estos comandos para verificar tu instalación de Clawdbot:

# Ejecutar incorporación
clawdbot onboard --install-daemon

# Verificación rápida
clawdbot doctor

# Verificar estado del gateway
clawdbot status
clawdbot health

# Abrir el panel de control
clawdbot dashboard

Método de Instalación: npm vs git

El instalador de Clawdbot soporta dos métodos:

Método	Descripción
`npm` (predeterminado)	`npm install -g clawdbot@latest`
`git`	Clonar/compilar desde el código fuente de GitHub

Opciones de CLI:

# npm explícito
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method npm

# Instalar desde GitHub (checkout del código fuente)
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git

Opciones comunes:

Opción	Descripción
`--install-method npm\|git`	Elegir método de instalación
`--git-dir <path>`	Directorio Git (predeterminado: ~/clawdbot)
`--no-git-update`	Omitir git pull para checkout existente
`--no-prompt`	Deshabilitar prompts (para CI/automatización)
`--dry-run`	Mostrar qué ocurriría
`--no-onboard`	Omitir incorporación

Variables de Entorno

Para automatización, usa estas variables de entorno:

CLAWDBOT_INSTALL_METHOD=git|npm
CLAWDBOT_GIT_DIR=...
CLAWDBOT_GIT_UPDATE=0|1
CLAWDBOT_NO_PROMPT=1
CLAWDBOT_DRY_RUN=1
CLAWDBOT_NO_ONBOARD=1
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1

Solución de Problemas: clawdbot no encontrado (PATH)

Diagnóstico rápido:

node -v
npm -v
npm prefix -g
echo "$PATH"

Si $(npm prefix -g)/bin no está en tu PATH, agrégalo a tu archivo de inicio de shell:

macOS / Linux (~/.zshrc o ~/.bashrc):

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

Windows: Agrega la salida de npm prefix -g a tu variable de entorno PATH.

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

Actualizar / Desinstalar

Actualizaciones: Ver Actualizar Clawdbot
Desinstalar: Ver Desinstalar Clawdbot

Próximos Pasos

Guía de Configuración de Clawdbot - Guía completa de configuración
Gateway de Clawdbot - Configuración del gateway
Clawdbot WhatsApp - Conectar a WhatsApp

Guía de Instalación de Clawdbot