Cómo Crear un Asistente IA para tu Empresa con OpenClaw

Al final de este tutorial tendrás:

• Un asistente de IA desplegado en tu servidor (local o VPS) • Accesible desde WhatsApp y/o Telegram • Conectado a Google Calendar, Gmail y tu herramienta de gestión de tareas • Capaz de responder preguntas sobre documentos internos de tu empresa • Extensible con plugins para cualquier servicio adicional

La arquitectura básica es simple: OpenClaw escucha tus mensajes en el canal que elijas, los procesa usando un modelo de lenguaje (GPT-4, Claude 3 o un modelo local), y ejecuta las acciones necesarias a través de sus integraciones.

Todo el código y las conversaciones permanecen en tu servidor. No pasa información por servidores de terceros (excepto las llamadas a la API del modelo de lenguaje, que puedes evitar usando un modelo local como Ollama con Llama 3).

Necesitas lo siguiente antes de empezar:

Hardware. Un servidor Linux (Ubuntu 22.04 LTS recomendado) o un VPS con al menos 2 CPU y 4 GB de RAM. Para usar un modelo de lenguaje local sin API externa, necesitas 16 GB de RAM mínimo.

Software instalado. Docker 24+ y Docker Compose v2. Si no los tienes, la documentación oficial de Docker tiene el proceso de instalación completo para Ubuntu.

Cuentas y credenciales. Una API key de OpenAI (GPT-4) o Anthropic (Claude 3), o alternativamente una instalación de Ollama con el modelo de tu elección. Para las integraciones de Google (Calendar, Gmail), necesitarás crear un proyecto en Google Cloud Console y habilitar las APIs correspondientes.

Canal de mensajería. Una cuenta de Telegram (la más fácil de configurar) o un número de WhatsApp Business. WhatsApp requiere acceso a la API oficial de Meta o una solución de puente de terceros.

Dominio o IP. Para recibir webhooks de WhatsApp necesitas una URL pública con HTTPS. Para Telegram puedes usar tanto una URL pública como long polling (más sencillo para empezar).

Clona el repositorio y prepara la configuración base:

```bash git clone https://github.com/openclaw/openclaw cd openclaw cp .env.example .env ```

Edita el archivo `.env` con tus credenciales. Los campos principales:

```env # Modelo de lenguaje LLM_PROVIDER=openai # openai | anthropic | ollama OPENAI_API_KEY=sk-...

# Base de datos (PostgreSQL incluida en Docker Compose) DB_HOST=postgres DB_NAME=openclaw DB_USER=openclaw DB_PASSWORD=cambia_esta_contraseña

# Seguridad SECRET_KEY=genera_una_clave_aleatoria_larga ALLOWED_HOSTS=tu-dominio.com,localhost ```

Levanta los servicios:

```bash docker compose up -d ```

Verifica que todos los contenedores están corriendo:

```bash docker compose ps ```

Deberías ver los servicios `web`, `worker`, `postgres` y `redis` en estado `running`. Si hay errores, revisa los logs con `docker compose logs web`.

Telegram es el canal más fácil de configurar porque no requiere IP pública ni configuración de webhooks complicada.

Paso 1: Crear el bot. Habla con @BotFather en Telegram, usa `/newbot`, elige un nombre y un username. Te dará un token en el formato `1234567890:ABCDEF...`.

Paso 2: Configura el token en tu `.env`:

```env TELEGRAM_BOT_TOKEN=1234567890:ABCDEF... TELEGRAM_ALLOWED_USERS=tu_telegram_id # opcional, para acceso restringido ```

Paso 3: Reinicia el servicio:

```bash docker compose restart web worker ```

Paso 4: Prueba. Busca tu bot en Telegram por el username que creaste, envía `/start` y deberías recibir la respuesta de bienvenida de OpenClaw.

Si quieres que lo use todo tu equipo, añade los IDs de Telegram de cada persona a `TELEGRAM_ALLOWED_USERS` separados por comas. Encontrarás tu ID enviando un mensaje a @userinfobot en Telegram.

Para conectar Google Calendar y Gmail necesitas un proyecto en Google Cloud Console con las APIs habilitadas y credenciales OAuth 2.0.

Paso 1: Crea el proyecto en Google Cloud.

1. Ve a console.cloud.google.com y crea un proyecto nuevo 2. Activa las APIs: Google Calendar API y Gmail API 3. En "Credenciales", crea credenciales OAuth 2.0 de tipo "Web application" 4. Añade tu URL como redirect URI: `https://tu-dominio.com/integrations/google/callback` 5. Descarga el archivo `credentials.json`

Paso 2: Coloca las credenciales en la configuración de OpenClaw.

```env GOOGLE_CLIENT_ID=tu-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=GOCSPX-... GOOGLE_REDIRECT_URI=https://tu-dominio.com/integrations/google/callback ```

Paso 3: Autoriza el acceso. Accede al panel de administración de OpenClaw en `https://tu-dominio.com/admin`, ve a Integraciones y sigue el flujo OAuth para conectar tu cuenta de Google.

Una vez conectado, prueba desde Telegram:

> "¿Tengo alguna reunión mañana?" > "Crea un evento el viernes a las 11h con el equipo de marketing" > "Revisa si hay algún email sin leer de [nombre del cliente]"

Una de las funciones más útiles de OpenClaw para empresas es poder responder preguntas sobre documentos internos: manuales, procesos, FAQs, catálogos de productos.

OpenClaw usa una base de datos vectorial para indexar documentos y hacer búsqueda semántica. El proceso:

Paso 1: Sube tus documentos. Desde el panel de administración, ve a "Knowledge Base" y sube PDFs, archivos de texto o documentos Word. OpenClaw los divide en fragmentos y genera embeddings automáticamente.

Paso 2: Asigna permisos. Puedes definir qué usuarios o canales tienen acceso a qué documentos. Por ejemplo, el manual de RRHH solo accesible para el canal de RRHH en Slack.

Paso 3: Prueba las consultas. Desde Telegram:

> "¿Cuál es la política de devoluciones?" > "¿Qué garantía tienen los productos de la línea X?" > "Resúmeme el proceso de onboarding para nuevos empleados"

OpenClaw busca en los documentos indexados, extrae el fragmento relevante y genera una respuesta en lenguaje natural citando la fuente.

Si los 50+ servicios nativos de OpenClaw no cubren un sistema específico de tu empresa (un ERP, un CRM propietario, una API interna), puedes crear plugins en Python.

La estructura básica de un plugin es esta:

```python from openclaw.plugins import Plugin, tool

class MiERP(Plugin): name = "mi_erp" description = "Consulta stock y pedidos en nuestro ERP"

@tool def consultar_stock(self, referencia: str) -> dict: """Devuelve el stock actual de un producto por referencia""" response = requests.get( f"{ERP_BASE_URL}/stock/{referencia}", headers={"Authorization": f"Bearer {ERP_API_KEY}"} ) return response.json()

@tool def estado_pedido(self, numero_pedido: str) -> dict: """Devuelve el estado actual de un pedido""" # ... lógica de consulta pass ```

Coloca el archivo en la carpeta `plugins/` de tu instalación de OpenClaw y reinicia el worker. El sistema detecta los nuevos plugins automáticamente y los hace disponibles para el asistente.

Desde ese momento puedes preguntar:

> "¿Cuántas unidades quedan de la referencia ABC-123?" > "¿En qué estado está el pedido 9847?"

Si vas a usar OpenClaw con un equipo real, hay aspectos de seguridad y estabilidad que debes tener en cuenta antes de abrir el acceso.

Autenticación. Configura `TELEGRAM_ALLOWED_USERS` o el equivalente para WhatsApp para restringir el acceso. Sin esto, cualquier persona que encuentre tu bot puede usarlo.

HTTPS obligatorio. Usa un certificado SSL válido, ya sea con Let's Encrypt (gratuito) usando Certbot, o a través del proxy de tu proveedor de VPS. WhatsApp y muchos webhooks lo requieren.

Backups de la base de datos. Los documentos indexados y el historial de conversaciones viven en PostgreSQL. Configura backups automáticos diarios con `pg_dump` y almacénalos fuera del servidor principal.

Límites de uso. Si tienes muchos usuarios, configura `RATE_LIMIT_PER_USER` para evitar un consumo excesivo de tokens de la API del modelo de lenguaje.

Monitorización. Activa los logs de nivel `WARNING` en producción y conecta un servicio de alertas (Sentry funciona bien con Django) para detectar errores antes de que afecten a los usuarios.

Actualizaciones. Suscríbete a las releases del repositorio de OpenClaw en GitHub para recibir notificaciones de actualizaciones de seguridad.

OpenClaw es una solución potente para empresas con equipo técnico, pero hay situaciones donde una solución a medida tiene más sentido:

Alta personalización del flujo conversacional. OpenClaw está diseñado como asistente de propósito general. Si necesitas un flujo de conversación muy específico (por ejemplo, un agente de ventas que sigue un proceso de cualificación preciso o un asistente de soporte con lógica de escalado compleja), construir desde cero da más control.

Integraciones propietarias profundas. Si tu empresa usa sistemas muy personalizados o con APIs complejas, el sistema de plugins de OpenClaw puede quedar corto. Una integración nativa diseñada específicamente para tu arquitectura interna funcionará mejor.

Sin equipo técnico. La instalación y mantenimiento de OpenClaw requiere familiaridad con servidores, Docker y configuración de sistemas. Si no tienes ese perfil internamente, el coste real es mayor de lo que parece.

Requisitos de cumplimiento normativo estrictos. En sectores como salud o finanzas, puede que necesites controles adicionales sobre los datos, auditorías y documentación que van más allá de lo que OpenClaw ofrece de serie.

En todos estos casos, el enfoque correcto es construir una solución personalizada desde el principio. El resultado es un sistema más ajustado a tus necesidades, con menor coste de mantenimiento a largo plazo y sin deuda técnica de adaptar una base de código no diseñada para tu caso de uso.

¿Puedo usar OpenClaw sin pagar por una API de LLM? Sí. OpenClaw soporta Ollama, que te permite correr modelos de lenguaje de código abierto como Llama 3, Mistral o Phi-3 en tu propio hardware. Necesitarás un servidor con GPU o, para modelos más ligeros, con 16+ GB de RAM. La calidad de las respuestas será inferior a GPT-4 o Claude 3 para tareas complejas, pero suficiente para muchos casos de uso.

¿Cuánto cuesta en API si uso OpenAI? Depende del volumen de uso. Con GPT-4o a $5 por millón de tokens de entrada y $15 por millón de tokens de salida, un equipo de 5 personas usando el asistente moderadamente gasta entre $20 y $80 al mes. Los costes suben si indexas muchos documentos en la knowledge base.

¿Funciona con WhatsApp normal o necesito WhatsApp Business? Para el uso empresarial recomendado necesitas la API oficial de WhatsApp Business (Meta). Hay soluciones de terceros que permiten conectar un número normal, pero violan los términos de servicio de WhatsApp y pueden resultar en el bloqueo del número.

¿Puedo tener el asistente en varios canales a la vez? Sí. OpenClaw puede correr múltiples puentes de mensajería simultáneamente. Puedes tener el mismo asistente accesible por Telegram, Slack y WhatsApp al mismo tiempo, con la misma configuración y base de conocimiento compartida.

¿Se puede limitar qué puede hacer cada usuario? Sí. El sistema de permisos permite asignar roles a usuarios y restringir el acceso a herramientas concretas. Por ejemplo, solo el equipo de finanzas puede consultar datos del ERP, y solo los administradores pueden modificar la knowledge base.