Esta guía te llevará paso a paso desde cero hasta tener tu asistente funcionando. No necesitas conocimientos previos de programación.
Antes de empezar, vamos a explicar algunos términos que usaremos:
La terminal (también llamada "consola" o "línea de comandos") es una aplicación donde escribes comandos de texto para controlar tu ordenador. Es como hablar con tu ordenador escribiendo en vez de haciendo clic.
Node.js es un programa que permite ejecutar JavaScript fuera del navegador. Clawdbot está escrito en JavaScript, así que necesitamos Node.js para que funcione. Es como instalar Java para usar aplicaciones Java.
npm (Node Package Manager) es una herramienta que viene con Node.js y sirve para instalar programas. Es como una "App Store" de línea de comandos.
Una API key es como una contraseña que te identifica cuando usas un servicio. Para usar Claude, GPT u otros modelos de IA, necesitas una API key del proveedor. Es como tener una tarjeta de socio.
El Gateway es el "cerebro" de Clawdbot. Es un programa que corre en tu ordenador, recibe tus mensajes de WhatsApp/Telegram/Discord, los envía a la IA, y te devuelve la respuesta. Debe estar siempre encendido para que funcione.
Node.js es necesario para ejecutar Clawdbot. Sigue las instrucciones según tu sistema operativo:
Opción A: Con Homebrew (recomendado)
Si tienes Homebrew instalado (un gestor de paquetes para Mac), abre Terminal y ejecuta:
brew install nodeOpción B: Instalador oficial
¿No tienes Homebrew? Instálalo con este comando en Terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Windows no soporta Clawdbot directamente. Necesitas WSL2 (Windows Subsystem for Linux), que te permite ejecutar Linux dentro de Windows.
Paso 1: Instalar WSL2
wsl --installPaso 2: Instalar Node.js en WSL
Abre Ubuntu (búscalo en el menú inicio) y ejecuta estos comandos uno por uno:
# Actualizar el sistema
sudo apt update && sudo apt upgrade -y
# Instalar Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# Verificar instalación
node --version# Actualizar el sistema
sudo apt update && sudo apt upgrade -y
# Instalar Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# Verificar instalación
node --versionAbre una terminal nueva y ejecuta:
node --version
npm --versionDeberías ver algo como:
v22.x.x
10.x.xSi ves números de versión, ¡Node.js está instalado correctamente!
Para que tu asistente use inteligencia artificial, necesitas una API key de un proveedor. Los más populares son:
Claude es el modelo más recomendado por su calidad y precio.
sk-ant-...)sk-...)El coste depende del uso. Para uso personal moderado:
Puedes poner un límite de gasto en la configuración del proveedor.
Ahora vamos a instalar Clawdbot. Abre la terminal y ejecuta:
npm install -g clawdbot@latestEste comando descarga e instala Clawdbot. Puede tardar 1-2 minutos.
-g? La bandera -g significa "global", es decir, que Clawdbot se instala para todo el sistema y podrás ejecutarlo desde cualquier carpeta.
clawdbot onboard --install-daemonEste comando hace varias cosas:
~/.clawdbot/clawdbot.jsonclawdbot --versionDeberías ver algo como 2026.1.24 (el número de versión).
Ahora necesitamos decirle a Clawdbot qué API key usar y quién puede hablar con él.
Opción A: Variable de entorno (recomendado)
Añade tu API key como variable de entorno. Edita tu archivo de configuración de shell:
En macOS/Linux (con zsh, el predeterminado en Mac moderno):
# Abrir el archivo de configuración
nano ~/.zshrc
# Añade esta línea al final (reemplaza con tu key real):
export ANTHROPIC_API_KEY="sk-ant-tu-api-key-aqui"
# Guarda: Ctrl+O, Enter, Ctrl+X
# Recarga la configuración:
source ~/.zshrcEn Linux (con bash):
# Abrir el archivo de configuración
nano ~/.bashrc
# Añade esta línea al final:
export ANTHROPIC_API_KEY="sk-ant-tu-api-key-aqui"
# Guarda y recarga:
source ~/.bashrcPor seguridad, Clawdbot solo responde a números que tú autorices. Vamos a editar la configuración:
# Abrir el archivo de configuración
nano ~/.clawdbot/clawdbot.jsonBusca la sección "channels" → "whatsapp" y modifícala así:
{
"channels": {
"whatsapp": {
"dmPolicy": "allowlist",
"selfChatMode": true,
"allowFrom": [
"+34612345678"
],
"groupPolicy": "allowlist",
"mediaMaxMb": 50,
"debounceMs": 0
}
}
}+34612345678 con TU número de teléfono real, en formato internacional (con el +34 para España).
Guarda el archivo: Ctrl+O, Enter, Ctrl+X
Ahora vamos a vincular tu WhatsApp con Clawdbot, igual que cuando vinculas WhatsApp Web.
clawdbot channels loginAparecerá un código QR en la terminal. Es grande y está hecho con caracteres de texto.
clawdbot channels login de nuevo para generar uno nuevo.
Si todo ha ido bien, verás un mensaje de éxito en la terminal. Ejecuta:
clawdbot statusDeberías ver que WhatsApp está conectado.
clawdbot statusDeberías ver algo como:
Gateway: running (pid 12345)
WhatsApp: connected
Sessions: 0 activeSi dice "not running", arráncalo con:
clawdbot gatewayEn unos segundos (normalmente 2-10 segundos), deberías recibir una respuesta del asistente.
Si quieres usar tu asistente también en Discord, sigue estos pasos:
botnano ~/.clawdbot/clawdbot.jsonAñade o modifica la sección de Discord:
{
"channels": {
"discord": {
"enabled": true,
"token": "TU_TOKEN_DE_DISCORD_AQUI",
"groupPolicy": "allowlist",
"guilds": {
"ID_DE_TU_SERVIDOR": {
"requireMention": false,
"channels": {
"ID_DEL_CANAL": {
"allow": true,
"requireMention": false
}
}
}
}
}
}
}clawdbot gateway restart/newbotnano ~/.clawdbot/clawdbot.jsonAñade la sección de Telegram:
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "TU_TOKEN_DE_TELEGRAM_AQUI",
"dmPolicy": "allowlist",
"allowFrom": ["tu_username_de_telegram"]
}
}
}clawdbot gateway restartBusca tu bot en Telegram y envíale un mensaje.
# Ver estado de Clawdbot
clawdbot status
# Arrancar el Gateway
clawdbot gateway
# Arrancar con logs detallados (para ver qué pasa)
clawdbot gateway --verbose
# Reiniciar
clawdbot gateway restart
# Parar
clawdbot gateway stop# Ver configuración actual
clawdbot config
# Abrir archivo de configuración
nano ~/.clawdbot/clawdbot.json# Vincular WhatsApp (generar QR)
clawdbot channels login
# Ver estado de conexión
clawdbot status# Actualizar a la última versión
npm install -g clawdbot@latest
# Ver versión instalada
clawdbot --version# Ver todos los comandos disponibles
clawdbot help
# Ayuda de un comando específico
clawdbot gateway --helpCausas posibles:
~/.clawdbot/clawdbot.jsonallowFrom+34612345678clawdbot statusclawdbot gatewayclawdbot status y mira si WhatsApp está conectadoclawdbot channels login de nuevoecho $ANTHROPIC_API_KEYLa API key no está configurada. Sigue el paso 6 para configurarla.
clawdbot channels login de nuevorm -rf ~/.clawdbot/whatsapp-auth y vuelve a intentarclawdbot gateway --verboseEn Mac/Linux, puede que necesites permisos de administrador:
sudo npm install -g clawdbot@latestTe pedirá tu contraseña del sistema.
Node.js no está instalado o no está en el PATH. Vuelve al paso 3.