¿Quieres un asistente personal de IA que puedas usar en todas tus aplicaciones de chat, que recuerde lo que has dicho y que incluso te envíe recordatorios de forma proactiva? Clawdbot es precisamente ese proyecto de código abierto revolucionario que convierte a Claude AI en tu asistente exclusivo.
Valor principal: Al leer este artículo, dominarás los conceptos fundamentales de Clawdbot, sus métodos de instalación y configuración, y cómo conectarlo mediante API para que te asista en más de 8 plataformas como Discord, Telegram y WhatsApp.
¿Qué es Clawdbot? Explicación rápida
Clawdbot es un proyecto de asistente personal de IA de código abierto desarrollado por Peter Steinberger (fundador de PSPDFKit). A diferencia de las versiones web convencionales de ChatGPT o Claude, Clawdbot funciona directamente en tus aplicaciones de mensajería habituales: si envías un mensaje en WhatsApp, te responde en WhatsApp; si preguntas en Discord, te contesta en Discord.
| Característica | Clawdbot | Chat de IA convencional |
|---|---|---|
| Forma de uso | En apps de mensajería habituales | Requiere abrir una web específica |
| Memoria de conversación | Persistente y multiplataforma | Cada chat suele ser independiente |
| Notificaciones proactivas | Soporta avisos y recordatorios | Solo respuesta pasiva |
| Almacenamiento | Archivos Markdown locales | Almacenado en la nube |
| Personalización | Sistema de Skills programable | Opciones limitadas |
🎯 Punto clave: Clawdbot no es un modelo de IA en sí mismo, sino un "Gateway de IA" (puerta de enlace) que conecta tus apps de chat con las API de los Modelos de Lenguaje Grande, integrando la IA de forma natural en tus herramientas de comunicación diaria.
Arquitectura principal de Clawdbot: Diseño de 3 capas
Comprender la arquitectura de Clawdbot ayuda con la configuración posterior y la resolución de problemas. Utiliza un diseño claro de tres capas:
Capa 1: Gateway (Pasarela)
El Gateway es el plano de control central de Clawdbot y escucha de forma predeterminada en localhost:18789:
- Gestiona todas las sesiones de mensajes.
- Enruta mensajes de diferentes canales.
- Maneja las llamadas a herramientas y la ejecución de Skills.
- Mantiene el historial de conversación y el sistema de memoria.
Capa 2: Channels (Canales)
Los Channels se encargan de conectar varias plataformas de chat:
| Tipo de canal | Plataformas soportadas | Método de conexión |
|---|---|---|
| Mensajería instantánea | WhatsApp, Telegram, Signal | Bot API / Protocolo Web |
| Colaboración | Discord, Slack, Teams | Bot API |
| Ecosistema Apple | iMessage, macOS | imsg CLI / Integración nativa |
| Protocolos abiertos | Matrix, WebChat | Conexión por protocolo estándar |
| Apps regionales | Zalo, BlueBubbles | Plugins de la comunidad |
Capa 3: Modelo de Lenguaje Grande (LLM)
Clawdbot admite múltiples backends de modelos de IA:
| Proveedor del modelo | Método de autenticación | Casos de uso |
|---|---|---|
| Anthropic Claude | API Key / OAuth | Opción recomendada, optimización nativa para Clawdbot |
| OpenAI GPT | API Key / OAuth | Escenarios generales |
| Proxy de API de terceros | API Key | Optimización de costos, facilidad de acceso |
🎯 Sugerencia técnica: Para las llamadas a modelos Claude, recomendamos obtener la API Key a través de la plataforma APIYI (apiyi.com). Esta plataforma es compatible con toda la serie de modelos Claude 4, ofrece una interfaz unificada compatible con OpenAI, tiene precios más competitivos y no requiere métodos de pago internacionales.
Detalle de las 4 ventajas principales de Clawdbot
Ventaja 1: Acceso omnicanal sin interrupciones
El concepto «omnicanal» de Clawdbot significa:
- Un mismo asistente, múltiples puntos de entrada: Puedes hacer una pregunta por WhatsApp desde tu móvil y continuar la conversación en Discord desde tu ordenador.
- Sincronización automática de contexto: Sin importar el canal que uses, el asistente recordará el contenido de las interacciones previas.
- Enrutamiento inteligente de mensajes: Puedes configurar que ciertos tipos de mensajes se envíen por canales específicos.
Ventaja 2: Sistema de memoria persistente
Mientras que los chats de IA tradicionales suelen estar en un estado de «amnesia» en cada sesión, Clawdbot:
- Almacena la memoria en archivos Markdown, de forma similar a las notas de Obsidian.
- Soporta búsqueda semántica, permitiendo relacionar información que mencionaste anteriormente.
- Es de almacenamiento local total; tus datos no se suben a la nube.
~/clawd/
├── memories/ # Memoria de conversaciones
│ ├── 2026-01-26.md # Organizado por fecha
│ └── topics/ # Clasificado por temas
├── skills/ # Habilidades personalizadas
└── config.yaml # Archivo de configuración
Ventaja 3: Capacidad de notificaciones proactivas
Esta es la funcionalidad estrella que distingue a Clawdbot de otros asistentes de IA:
| Escenario de notificación proactiva | Ejemplo |
|---|---|
| Resumen matutino | Envía tu agenda y el clima cada día a las 8:00 a. m. |
| Recordatorio de tareas | Te avisa antes de las fechas límite que hayas mencionado. |
| Alertas de monitoreo | Notifica activamente si un sitio web monitoreado presenta anomalías. |
| Ejecución programada | Ejecuta scripts periódicamente e informa de los resultados. |
Ventaja 4: Sistema de habilidades (Skills)
Las "Skills" son el sistema de «complementos» de Clawdbot, definidos mediante archivos Markdown o TypeScript:
# skill: web-search
Usa la API de Brave Search para buscar contenido en la red.
## Disparador
Cuando el usuario hace una pregunta que requiere información en tiempo real.
Pasos de ejecución
- Llamar a la API de Brave Search
- Analizar los resultados de búsqueda
- Generar una respuesta resumida
La comunidad ya ha contribuido con más de 100 Skills listos para usar, que incluyen:
- Navegación web y capturas de pantalla
- Operaciones de lectura y escritura de archivos
- Integración de gestión de calendarios
- Entornos de ejecución de código
- Control de domótica
---
## Instalación y configuración de Clawdbot: 3 pasos para empezar rápido
### Requisitos del sistema
| Ítem | Requisito |
|------|-----------|
| **Node.js** | ≥ 22.x |
| **Sistema operativo** | macOS / Linux / Windows (WSL2) |
| **Memoria** | ≥ 2GB disponible |
| **API de IA** | Clave API de Claude u OpenAI |
### Paso 1: Instalación global
```bash
# Instalar con npm (recomendado)
npm install -g clawdbot@latest
# O usar pnpm
pnpm add -g clawdbot@latest
Paso 2: Ejecutar el asistente de configuración
# Iniciar el asistente de configuración interactivo
clawdbot onboard --install-daemon
El asistente te guiará para completar:
- Configuración del modelo de IA – Introduce tu clave API de Claude u OpenAI.
- Configuración del directorio de trabajo – Por defecto es
~/clawd. - Habilitación de canales – Elige las plataformas de chat que deseas conectar.
- Instalación del demonio (daemon) – Para que el Gateway se mantenga ejecutándose en segundo plano de forma continua.
🚀 Inicio rápido: Si aún no tienes una clave API de Claude, te recomendamos usar la plataforma APIYI (apiyi.com) para obtener una rápidamente. Esta plataforma ofrece interfaces API listas para usar, regala crédito de prueba gratuito al registrarte y permite completar la configuración en solo 5 minutos.
Paso 3: Verificar la instalación
# Comprobar el estado del servicio
clawdbot status
# Control de salud profundo (health check)
clawdbot health
# Diagnosticar problemas de configuración
clawdbot doctor
Resultado esperado:
Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord, Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed
Guía de configuración de la integración de Clawdbot con Discord
Discord es uno de los canales más utilizados de Clawdbot; aquí tienes los pasos para configurarlo:
Paso 1: Crear el Bot de Discord
- Accede al Discord Developer Portal:
discord.com/developers/applications - Haz clic en "New Application" para crear la aplicación.
- Ve a la página "Bot" y haz clic en "Add Bot".
- Guarda el Bot Token (haz clic en "Reset Token" para generarlo).
Paso 2: Configurar permisos del Bot
En "OAuth2 → URL Generator", selecciona:
| Categoría de permiso | Permiso específico |
|---|---|
| Scopes | bot, applications.commands |
| Bot Permissions | Send Messages, Read Message History, Embed Links |
Paso 3: Invitar al Bot al servidor
Usa la URL de OAuth2 generada para invitar al Bot a tu servidor de Discord.
Paso 4: Configurar Clawdbot
# Configuración interactiva del canal de Discord
clawdbot configure --section channels.discord
Tras introducir el Bot Token, Clawdbot completará la conexión automáticamente.
Paso 5: Probar la conversación
Menciona a tu Bot con @ o envíale un mensaje directo en el servidor de Discord:
@ClawdBot Hola, preséntate
El Bot utilizará la API de Claude para generar una respuesta y enviarla a Discord.
Detalles de configuración de la API de Clawdbot
La inteligencia de Clawdbot proviene del Modelo de Lenguaje Grande subyacente; configurar correctamente la API es fundamental.
API oficial de Anthropic
# ~/clawd/config.yaml
llm:
provider: anthropic
model: claude-sonnet-4-20250514
apiKey: sk-ant-xxxxx
Ventajas:
- Conexión directa con el proveedor oficial, mínima latencia.
- Soporte para los modelos más recientes.
Limitaciones:
- Requiere una tarjeta de crédito internacional para el pago.
- El acceso está restringido en algunas regiones.
Proxy de API de terceros (Recomendado)
# ~/clawd/config.yaml
llm:
provider: openai-compatible
model: claude-sonnet-4-20250514
apiKey: sk-xxxxx
baseUrl: https://api.apiyi.com/v1 # Uso de la interfaz unificada de APIYI
💰 Optimización de costes: Para los usuarios que buscan alternativas, usar APIYI (apiyi.com) como proxy de API es una excelente opción. Esta plataforma ofrece una interfaz compatible con OpenAI, admite toda la serie de modelos Claude, tiene precios más competitivos que la oficial y permite diversos métodos de pago locales, eliminando la necesidad de canales de pago internacionales.
Autenticación por suscripción OAuth
Si ya tienes una suscripción a Claude Pro/Max:
clawdbot configure --section llm.oauth
La ventaja es que utiliza el cupo de tu suscripción actual, sin costes adicionales por API.
Configuración de Skills comunes de Clawdbot
Skill de búsqueda web
# 配置 Brave Search API
clawdbot configure --section web
# 输入你的 Brave Search API Key
Una vez configurado, Clawdbot puede buscar información en la web en tiempo real para responder preguntas.
Skill de operaciones de archivos
Clawdbot cuenta con capacidad integrada de lectura y escritura de archivos:
Yo: Ayúdame a leer el contenido de ~/Documents/notes.md
Bot: Leyendo archivo... [contenido del archivo]
Yo: Añade una línea al final del archivo: "Tareas de hoy: Terminar el informe"
Bot: Contenido añadido al archivo
Skill de navegador
Yo: Ayúdame a visitar example.com y toma una captura de pantalla
Bot: [Iniciando navegador] → [Cargando página] → [Generando captura] → [Enviando imagen]
Skill personalizado
Solo tienes que crear un archivo Markdown en el directorio ~/clawd/skills/:
# skill: daily-report
Generador de informes de trabajo diarios
## Descripción
Genera un informe diario basado en el registro de conversaciones de hoy.
Palabras clave
Generar informe diario, Resumen del día
Lógica de ejecución
- Leer toda la memoria de las conversaciones de hoy
- Extraer el contenido relacionado con el trabajo
- Generar un informe diario estructurado
---
## Estimación de costos y comparativa de Clawdbot
| Concepto de gasto | Costo mensual | Descripción |
|----------|--------|------|
| **Servidor VPS** | ¥35-70 | Opcional, la ejecución local es gratuita |
| **API de Claude** | ¥70-140 | Depende del volumen de uso |
| **Suscripción Claude Pro** | ¥140 | Se pueden ahorrar costos de API con autenticación OAuth |
| **Suscripción Claude Max** | ¥1400 | Para usuarios intensivos, Opus sin límites |
### Sugerencias de optimización de costos
1. **Ejecución local**: Úsalo en el ordenador de tu casa o en un Mac mini para ahorrarte los gastos del VPS.
2. **Proxy de API**: Llama a la API de Claude a través de APIYI (apiyi.com) para obtener precios más competitivos.
3. **Selección de modelo**: Usa `claude-haiku` para conversaciones diarias y cambia a `claude-sonnet` solo para tareas complejas.
4. **Gestión de memoria**: Limpia periódicamente la memoria que no necesites para reducir el consumo de Tokens.
---
## Comparativa entre Clawdbot y otras soluciones
| Dimensión de comparación | Clawdbot | ChatGPT App | Claude App | Bot propio |
|----------|----------|-------------|------------|----------|
| **Soporte multiplataforma** | ⭐⭐⭐⭐⭐ 8+ plataformas | ⭐⭐ Solo App | ⭐⭐ Solo App | ⭐⭐⭐ Requiere desarrollo individual |
| **Memoria de diálogo** | ⭐⭐⭐⭐⭐ Almacenamiento local persistente | ⭐⭐⭐ Nube limitada | ⭐⭐⭐ Nube limitada | ⭐⭐ Requiere implementación propia |
| **Notificaciones push** | ⭐⭐⭐⭐⭐ Soporte completo | ❌ No soportado | ❌ No soportado | ⭐⭐⭐ Requiere implementación propia |
| **Protección de privacidad** | ⭐⭐⭐⭐⭐ Almacenamiento local | ⭐⭐ Almacenamiento en la nube | ⭐⭐ Almacenamiento en la nube | ⭐⭐⭐⭐ Depende de la implementación |
| **Capacidad de personalización** | ⭐⭐⭐⭐⭐ Sistema de Skills | ⭐⭐ GPTs limitados | ⭐⭐ Proyectos | ⭐⭐⭐⭐⭐ Totalmente personalizable |
| **Facilidad de inicio** | ⭐⭐⭐ Requiere base técnica | ⭐⭐⭐⭐⭐ Listo para usar | ⭐⭐⭐⭐⭐ Listo para usar | ⭐ Requiere mucho desarrollo |
> 💡 **Recomendación de elección**: Clawdbot es ideal para usuarios con ciertos conocimientos técnicos que buscan privacidad y una personalización profunda. Si solo necesitas conversaciones sencillas con la IA, las aplicaciones oficiales son suficientes; pero si quieres que la IA se integre realmente en tu flujo de trabajo diario, vale la pena invertir tiempo en aprender a usar Clawdbot.
---
## Preguntas frecuentes (FAQ)
<details open>
<summary><strong>Q1: ¿Clawdbot requiere un servidor VPS?</strong></summary>
No es estrictamente necesario. Clawdbot puede ejecutarse en tu ordenador personal, siempre que el equipo esté encendido podrás usarlo. Pero si quieres que esté online las 24 horas, te recomiendo usar:
- Un ordenador que siempre esté encendido en casa (como un Mac mini, etc.)
- Un servidor en la nube (VPS, unos 5-10 €/mes)
- Un dispositivo NAS local
</details>
<details open>
<summary><strong>Q2: ¿Cómo obtengo la API de Claude si no tengo una tarjeta de crédito extranjera?</strong></summary>
Puedes obtener acceso a la API de Claude a través de la plataforma **APIYI** (apiyi.com). Esta plataforma permite pagos con Alipay y WeChat, ofrece una interfaz de API idéntica a la oficial y suele tener precios más competitivos. Una vez registrado, solo tienes que obtener tu API Key y configurarla en Clawdbot para empezar a usarlo.
</details>
<details open>
<summary><strong>Q3: ¿Clawdbot es compatible con el español?</strong></summary>
Totalmente. Clawdbot en sí mismo es solo una pasarela (gateway); la capacidad de la IA proviene del modelo subyacente (Claude/GPT). Estos modelos tienen un soporte excelente para el español, así que puedes realizar todas tus interacciones con Clawdbot en tu idioma.
</details>
<details open>
<summary><strong>Q4: ¿Cómo se garantiza la privacidad de las conversaciones?</strong></summary>
Clawdbot utiliza un diseño "local-first":
- El historial de conversaciones se guarda en tu propio dispositivo (archivos Markdown).
- El Gateway se ejecuta en `localhost`, sin exponerse a la red pública.
- Puedes acceder de forma segura mediante túneles SSH o Tailscale.
- Solo las llamadas al modelo de IA requieren conexión a internet (peticiones API).
</details>
<details open>
<summary><strong>Q5: ¿A dónde voy si tengo problemas o necesito ayuda?</strong></summary>
Clawdbot cuenta con una comunidad muy activa:
- **Servidor de Discord**: Al unirte, puedes hablar directamente con dos instancias de Clawdbot e incluso hacer preguntas.
- **GitHub Issues**: `github.com/clawdbot/clawdbot`
- **Documentación oficial**: `docs.clawd.bot`
Los reportes de bugs suelen recibir respuesta muy rápido; a veces, el autor incluso los corrige en tiempo real mientras chateas.
</details>
<details open>
<summary><strong>Q6: ¿Cómo se instala en Windows?</strong></summary>
Para usuarios de Windows, se recomienda encarecidamente usar **WSL2**:
1. Instala WSL2 (se recomienda la distribución Ubuntu).
2. Instala Node.js 22+ dentro de WSL2.
3. Sigue los pasos de instalación de Linux para Clawdbot.
El soporte nativo para Windows aún no es perfecto y podrías encontrarte con diversos problemas.
</details>
---
## Usos avanzados de Clawdbot
### 1. Colaboración Multi-Agente
Clawdbot permite crear múltiples sesiones (Sessions) que pueden comunicarse entre sí:
Sesión A (Asistente de investigación): Investiga datos de mercado.
Sesión B (Asistente de redacción): Recibe los datos de A y genera un informe.
Sesión C (Asistente de revisión): Revisa el informe de B y sugiere cambios.
### 2. Flujos de trabajo automatizados
Combínalo con tareas programadas (Cron):
- Todos los días a las 8:00 AM: Resumir correos importantes.
- Cada lunes a las 9:00 AM: Generar el resumen de trabajo de la semana pasada.
- El día 1 de cada mes: Estadísticas de uso de la API del mes actual.
### 3. Integración con el hogar inteligente
Conéctalo a dispositivos inteligentes mediante Home Assistant o MQTT:
Yo: Baja un poco la luz del salón.
Bot: [Llamando a la API de Home Assistant] He ajustado el brillo de la luz del salón al 50%.
### 4. Asistente de desarrollo de código
Clawdbot puede:
- Leer archivos de código y explicarlos.
- Ejecutar comandos de la terminal (shell).
- Navegar por repositorios de GitHub.
- Generar código y guardarlo directamente en archivos.
---
## Resumen y próximos pasos
Clawdbot representa un nuevo paradigma en asistentes personales de IA:
| Valor fundamental | Descripción |
|----------|------|
| **Omnipresente** | Usa la IA en tus aplicaciones de chat habituales |
| **Nunca olvida** | Memoria persistente; te conoce de verdad |
| **Servicio proactivo** | Ya no espera pasivamente; envía recordatorios de forma proactiva |
| **Control total** | Código abierto y autohospedado; tus datos siempre te pertenecen |
| **Expansión ilimitada** | El sistema de Skills permite que sus capacidades no tengan límites |
**Próximos pasos**:
1. Instala Clawdbot: `npm install -g clawdbot@latest`
2. Obtén la API de Claude: recomendamos obtenerla rápidamente a través de APIYI (apiyi.com)
3. Ejecuta el asistente de configuración: `clawdbot onboard --install-daemon`
4. Conecta tu primer canal (recomendamos empezar con Discord)
5. Únete a la comunidad de Discord de Clawdbot para compartir experiencias
---
## Referencias
1. **Sitio oficial de Clawdbot**: Introducción al producto y guía de inicio rápido
- Enlace: `clawd.bot`
2. **Documentación oficial de Clawdbot**: Guía completa de configuración
- Enlace: `docs.clawd.bot`
3. **Repositorio de GitHub**: Código abierto e incidencias (Issues)
- Enlace: `github.com/clawdbot/clawdbot`
4. **Reseña detallada de MacStories**: Compartiendo la experiencia de uso
- Enlace: `macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/`
5. **Sitio personal de Peter Steinberger**: Blog del autor
- Enlace: `steipete.me`
---
> 📝 **Autor**: Equipo de APIYI
> 🔗 **Intercambio técnico**: Visita apiyi.com para obtener más trucos sobre el uso de APIs de IA
> 📅 **Fecha de actualización**: Enero de 2026
