Construir un Asistente Personal

Descripción General

Clawdbot sirve como una puerta de enlace que conecta plataformas de mensajería con agentes de IA, permitiéndote interactuar con un asistente de IA a través de tu aplicación de mensajería preferida.

Consideraciones de Seguridad

Clawdbot puede ejecutar comandos, acceder a archivos y enviar mensajes. Medidas de seguridad importantes:

• Configura channels.whatsapp.allowFrom para restringir el acceso
• Usa un número de teléfono dedicado para el asistente
• Comienza con los heartbeats deshabilitados ("0m") hasta que confíes
• Revisa los permisos antes de otorgar acceso al shell

Requisitos Previos

• Node.js 22+
• Clawdbot instalado globalmente
• Un segundo número de teléfono para el asistente (recomendado)

Arquitectura Recomendada

Usa dos teléfonos para la configuración más segura:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Tu Teléfono    │────▶│  Asistente      │────▶│  Tu Computadora │
│  (Personal)     │     │  Número Tel.    │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Tu dispositivo personal envía mensajes a un segundo teléfono (el asistente) que está vinculado a Clawdbot ejecutándose en tu computadora.

Inicio Rápido

1. Vincular WhatsApp Web

clawdbot channels login whatsapp

Escanea el código QR con tu teléfono asistente.

2. Iniciar Gateway

clawdbot gateway --port 18789

3. Configurar Lista de Permitidos

Edita ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

Espacio de Trabajo y Memoria

Espacio de Trabajo Predeterminado

Ubicación: ~/.clawdbot/workspace

Contiene archivos de instrucciones:

Control de Versiones

Trata tu espacio de trabajo como un repositorio git para respaldo:

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

Sesiones

Las sesiones se almacenan por remitente. Comandos para gestionar sesiones:

Heartbeats (Tareas Proactivas)

Los heartbeats son verificaciones periódicas donde el agente lee HEARTBEAT.md para tareas.

Configuración

En ~/.clawdbot/clawdbot.json:

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

Comportamiento

• Predeterminado: Cada 30 minutos
• El agente lee HEARTBEAT.md para tareas pendientes
• Responde con HEARTBEAT_OK si nada necesita atención
• Configura a "0m" para deshabilitar

Ejemplo de HEARTBEAT.md

# Tareas de Heartbeat

- Verificar nuevos correos y resumir los importantes
- Revisar calendario para próximas reuniones
- Monitorear precios de acciones para AAPL, GOOGL

Manejo de Medios

Archivos Adjuntos Entrantes

Clawdbot puede recibir y procesar:

• Imágenes
• Documentos
• Notas de voz
• Videos

Medios Salientes

Envía medios usando la sintaxis MEDIA:<ruta>:

MEDIA:/path/to/image.png

Operaciones

Comandos de Estado

# Verificar salud
clawdbot health

# Ver estado
clawdbot status

# Verificar logs
tail -f /tmp/clawdbot/gateway.log

Registro

Los logs se almacenan en /tmp/clawdbot/:

Configuración Multi-Canal

Configura múltiples canales en clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Próximos Pasos

• Vinculación - Configurar control de acceso
• Escaparate - Ver lo que otros han construido
• Habilidades - Extender con plugins