Instalar wa

Conecta tu WhatsApp a un agente de IA en tu ordenador. Al terminar podrá leer chats guardados, buscar mensajes y preparar respuestas. Ten cerca el teléfono con WhatsApp abierto y deja unos cinco minutos para recibir el historial reciente.

Los pasosCopy Anchor Link

1. Instalar wa: la herramienta y su motor de WhatsApp.
2. Vincular tu cuenta: escanea un QR desde WhatsApp en el teléfono.
3. Conectar tu agente: instala sus instrucciones, llamadas skill.
4. Comprobar el resultado: identifica tu cuenta y algunos chats guardados.

Es un cliente no oficial. Lee seguridad y límites antes de vincular: WhatsApp puede restringir o bloquear cuentas que usan clientes no oficiales.

1. Instalar waCopy Anchor Link

Con tu agenteCopy Anchor Link

Usa un agente con acceso al terminal de este ordenador, como Codex, Claude Code, Cursor o Gemini CLI. Para un chat solo en el navegador, consulta acceso web o móvil.

Usa wa CLI. Ayúdame a conectar mi WhatsApp al agente siguiendo https://wirecat.dev/es/docs/wa/installation. Comprueba los programas necesarios e instala la herramienta. Pregunta qué cuenta y nombre de perfil quiero; personal es un ejemplo. Yo confirmaré la vinculación en el teléfono. Instala el skill y muestra mi cuenta y algunos chats. No envíes mensajes ni inicies trabajo en segundo plano sin preguntar.

A mano en el terminalCopy Anchor Link

Abre Terminal en macOS o Linux, o PowerShell en Windows. Necesitas Node.js 22.16 o posterior dentro de 22.x, o 24 o posterior, con npm; consulta preparar el entorno.

npm install -g @wirecat/whatsapp-cli
wa --version
wa doctor

Mantén habilitados los paquetes opcionales: npm instala el motor de WhatsApp para tu sistema y procesador. El gestor puede avisar de scripts de instalación bloqueados; comprueba el resultado con los comandos siguientes. Si falta el motor, consulta solución de problemas. En Windows, abre un terminal nuevo si no se encuentra el comando.

2. Vincular tu cuenta de WhatsAppCopy Anchor Link

En los ejemplos, personal es el nombre del perfil: una cuenta vinculada en este ordenador. Elige cualquier nombre y repítelo en los comandos posteriores. La herramienta no elige una cuenta por ti.

wa personal setup

1. Ejecuta la configuración en el terminal. Comprueba carpetas e inicia la vinculación; reutiliza un perfil ya vinculado.
2. En el teléfono, abre WhatsApp → Ajustes → Dispositivos vinculados → Vincular un dispositivo. Usa el escáner de WhatsApp para leer el QR mostrado por la configuración.
3. Mantén WhatsApp abierto mientras llega el historial reciente. La configuración comprueba tu cuenta y hasta cinco chats guardados y ofrece instalar el skill del agente.

Se añade un dispositivo vinculado, como WhatsApp Web. Puedes desconectarlo cuando quieras desde Dispositivos vinculados en el teléfono. Para usar un código en lugar del QR, ejecuta wa personal setup --method phone; introduces el número en el terminal. Confirma tú el acceso. El historial antiguo requiere una petición aparte al teléfono.

3. Conectar tu agenteCopy Anchor Link

Un skill es un archivo breve que explica al agente del terminal cómo usar wa. La configuración puede instalarlo para el agente elegido. Para instalarlo aparte:

wa skill install --for all

Una aplicación sin terminal puede usar MCP. Elige antes los permisos del perfil: MCP ofrece comandos de escritura además de lectura.

4. Comprobar el resultadoCopy Anchor Link

wa personal account show
wa personal chats list --limit 5

La cuenta debe ser la elegida en tu teléfono. La lista de chats utiliza el historial guardado y no envía confirmaciones de lectura. Un historial vacío o incompleto no demuestra que no haya mensajes; consulta cobertura del historial.

Para seguir recibiendo mensajes, ejecuta wa personal serve en un terminal; Ctrl-C lo detiene. Un dispositivo vinculado solo admite una conexión. Lee la regla de conexión antes de ejecutar otro comando conectado.

Preguntas y respuestasCopy Anchor Link

No se ve el QRCopy Anchor Link

Pide al agente que muestre el terminal o pegue el QR de texto en el chat. Usa el escáner de WhatsApp. Si el terminal es demasiado estrecho, amplíalo y espera el siguiente QR. Consulta otros fallos en solución de problemas.

Instalación avanzada y mantenimientoCopy Anchor Link

De la fuenteCopy Anchor Link

Para ejecutar wa desde el repositorio:

git clone https://github.com/WireCatLabs/whatsapp-cli.git
cd whatsapp-cli
pnpm install
pnpm build
pnpm engine:build   # needs Go
node dist/bin/wa.js --version

Adónde van los archivosCopy Anchor Link

Las claves del dispositivo, las configuraciones y el almacén local tienen cada uno su propio lugar: donde se guardan las piezas.

Finalización del caparazónCopy Anchor Link

Tab completa comandos, opciones y sus valores. Cuando se espera un chat, ofrece chats del almacén local. Añade una línea al archivo de inicio de su shell:

echo 'source <(wa complete zsh)' >> ~/.zshrc      # zsh
echo 'source <(wa complete bash)' >> ~/.bashrc    # bash
wa complete fish | source                         # fish, in config.fish

PowerShell: wa complete powershell | Out-String | Invoke-Expression en tu perfil.

Una Tab nunca se conecta a WhatsApp. Sin un almacén local todavía, solo se completan los comandos y opciones.

ActualizarCopy Anchor Link

wa upgrade            # with the package manager that installed wa
wa upgrade --check    # only say whether a newer version exists; installs nothing

upgrade pregunta a npm, por lo que se rechaza --offline con el código de salida 2. upgrade --check se ejecuta bajo WA_READ_ONLY; upgrade sin él no lo hace.

Después de una actualización, wa upgrade reinicia cada serve en ejecución en segundo plano, por lo que no sigue ejecutando el código anterior. El motor viene como paquete wa, por lo que se actualiza con él. Una vez al día, wa dice en stderr cuando existe una versión más nueva; WA_NO_UPDATE_CHECK=1, o update_check: false en la configuración, lo desactiva.

De fuente: git pull && pnpm install && pnpm build && pnpm engine:build.

DesinstalarCopy Anchor Link

Al eliminar el comando, se dejan sus datos. Desvincule primero, mientras wa todavía esté ahí:

wa personal server uninstall         # if you installed the background unit; stop it first
wa personal session end              # unlinks the device on WhatsApp's side and deletes its keys here
npm uninstall -g @wirecat/whatsapp-cli
rm -rf ~/.config/whatsapp-cli ~/.local/share/whatsapp-cli ~/.cache/whatsapp-cli

Repita session end para cada perfil. El almacén local se comparte con otras herramientas WireCat. Elimine ~/.local/share/WireCat/ solo si nada más lo usa: contiene los mensajes que cada uno de ellos ha guardado.

SiguienteCopy Anchor Link

Vincular un perfil y leer tus primeros chats.