Documentación

La guía completa para poner a tu equipo de IA a trabajar — desde el primer clic hasta la API.

¿Qué es AireClaw?

AireClaw es un sistema operativo agéntico para tu negocio. En lugar de una sola IA con la que chateas, obtienes un equipo de agentes — un Orquestador que coordina, y agentes dedicados de marketing (CMO), ventas (CSO), operaciones (COO) y finanzas (CFO) — que no solo responden: ejecutan el trabajo real a través de tus herramientas conectadas.

Tú defines el objetivo y las reglas. Los agentes proponen o ejecutan acciones; todo lo sensible pasa por tu Decision Inbox para que apruebes con un toque. Cada corrección tuya entrena su memoria, así que mejoran con el tiempo.

💡 La idea central: dejas de vender tu tiempo y pasas de operar tú mismo a dirigir un equipo que opera por ti — con el control siempre de tu lado.

Conceptos clave

  • Workspace / Tenant — tu espacio aislado. Tus datos nunca se cruzan con los de otro cliente.
  • Orquestador — el agente maestro: construye tu setup, planifica y coordina al resto.
  • Agente — una entidad con identidad, memoria permanente, un objetivo y permisos por módulo.
  • Objetivo (Objective) — la misión que guía cada decisión de un agente.
  • Grants — a qué áreas/módulos puede acceder un agente (marketing, ventas, ops, finanzas), incluso por módulo específico.
  • Modo — Manual (propone y espera tu aprobación) o Auto (ejecuta dentro de sus límites).
  • Decision Inbox — la bandeja donde apruebas/rechazas/corriges las acciones propuestas.
  • Créditos — el combustible de las acciones. Pensar es barato; producir, distribuir y traer data cuesta.

Inicio rápido

  1. Crea tu cuenta — gratis, con Google o email (sin tarjeta). Verifica tu correo si usas email.
  2. Cuéntanos de tu negocio — el onboarding conversacional de 2 minutos (puedes hablar en vez de escribir).
  3. Tu equipo se arma solo — el Orquestador crea tus agentes, tu Brand Brain y tu roadmap diario.
  4. Entra a Today — ya con tus primeros movimientos listos para aprobar.
  5. Instala la app — añádela a tu pantalla de inicio (PWA) para recibir recordatorios push.

Onboarding conversacional

Al entrar por primera vez, un wizard te pregunta: quién eres, a qué te dedicas, tu rol, en qué quieres ayuda, qué redes usas y cómo gestionas leads. Con tus respuestas, el Orquestador:

  • Define tu tipo de negocio y tus pilares de contenido.
  • Siembra tu Brand Brain (tu voz, identidad y audiencia).
  • Crea tus agentes dedicados con su objetivo.
  • Escribe tu Success Roadmap (rutina diaria personalizada).

Todo esto queda editable después. Puedes rehacer el onboarding cuando quieras.

Instalar como app (PWA)

AireClaw es instalable en tu teléfono o escritorio como una app nativa (PWA). Al instalarla obtienes acceso de un toque y, sobre todo, notificaciones push que te recuerdan tu rutina diaria — incluso con la app cerrada. En iPhone, el push funciona después de instalarla desde Safari (Compartir → Añadir a pantalla de inicio).

El Orquestador

El Orquestador es tu agente maestro. Construye tu equipo a partir de tu onboarding o de tus SOPs, propone qué agentes necesitas, les asigna objetivos y coordina su trabajo. Es también quien traduce tus instrucciones en lenguaje natural en flujos ejecutables.

Agentes: identidad y memoria

Cada agente se compone de:

  • SOUL — su propósito y valores.
  • IDENTITY — quién es y cómo se comporta.
  • OBJECTIVE — la misión que persigue (inyectada en cada decisión).
  • Memoria permanente — todo lo que aprende de ti vive aquí, para siempre.
  • Guía de estilo — su voz (puedes entrenarla).

El equipo por defecto

  • Orchestrator coordina al equipo y lo construye.
  • CMO contenido, campañas, redes, marca.
  • CSO pipeline, leads, deals, cotizaciones.
  • COO proyectos, tareas, inventario, proveedores.
  • CFO cashflow, facturas, precios, márgenes.

Objetivos, grants y modos

Controlas exactamente qué puede hacer cada agente:

  • Objetivo — defínelo al crear o editar el agente; guía su comportamiento.
  • Grants — concede acceso a un área completa (ej. Marketing) o a un módulo específico (ej. solo CRM dentro de Ventas).
  • Guardrails — límites duros: puede enviar email, crear deals, modificar finanzas, máximo de acciones por corrida, etc.
  • Modo — Manual (human-in-the-loop) o Auto (ejecuta dentro de guardrails). Se puede definir por agente y por tarea.

Playground & entrenamiento de voz

Entrena a tus agentes en un sandbox seguro (dry-run) antes de ponerlos en vivo: practican y proponen, pero nada real se envía ni se ejecuta. Cuando estén sólidos, los promueves a Live. Con Voice training, pegas ejemplos de tu forma de escribir y el agente sintetiza una guía de estilo con tu voz.

Decision Inbox

Toda acción sensible que un agente propone (publicar, enviar un correo, crear un deal, cobrar…) llega a tu bandeja de decisiones. Apruebas, editas o rechazas — con un motivo. Cada corrección entrena la memoria del agente, así que la próxima vez lo hace mejor. Autonomía donde ayuda, supervisión donde importa.

Today, Momentum & Success Roadmap

Tu home es Today: una lista corta de movimientos que mueven la aguja, curados por tus agentes. Incluye:

  • Today's moves — las acciones propuestas priorizadas.
  • Success Roadmap — tu rutina diaria personalizada; complétala para mantener tu racha.
  • Impact Meter & Momentum — horas ganadas, trabajo hecho y tu score.
  • Rachas & hitos — hábito diario con celebraciones.

Content Studio & Brand Brain

Genera contenido on-brand (imágenes, carruseles, ideas de video), investiga tendencias y publica. El Brand Brain guarda tu voz, identidad y audiencia para que todo salga consistente. Incluye un CMO agéntico con el que chateas y que ejecuta las ediciones por ti.

Funnels & pagos

Un page builder asistido por el CMO: landing pages con URL rastreable, captura de leads directo a tu CRM, checkout/pagos (Stripe o MercadoPago, tarjeta hospedada por el proveedor — PCI), carritos y recupero de abandonados, y A/B testing con métricas.

Redes & Campaigns

Publicar. La misma pieza sale a Instagram, TikTok, YouTube, LinkedIn y X de una pasada, desde Content Studio y con tu aprobación.

Conversar. WhatsApp no es un canal de publicación: son conversaciones con tus clientes. Los mensajes de tu número de WhatsApp Business, los mensajes directos y comentarios de Instagram, los comentarios de TikTok y el correo que rediriges entran todos a la misma bandeja, donde el asistente de esa cuenta redacta la respuesta y una persona la aprueba. Ver Mensajería para negocios para el detalle de qué datos se usan y cómo se conecta cada cuenta.

Campaigns. Envías correos reales desde tu Gmail conectado, con segmentación desde tu CRM, tracking de aperturas/clics, programación y series recurrentes.

Lead Finder & CRM

Lead Finder investiga negocios que encajan con lo que vendes y los importa al pipeline que elijas — no extrae direcciones de correo ni contacta a nadie; el acercamiento lo decides tú. El CRM/Contactos gestiona leads, clientes, pipelines y deals con campos personalizados. También puedes sincronizar con tu CRM existente (HubSpot, Pipedrive, Salesforce, Zoho, GoHighLevel, Close, Freshsales, Copper).

Automations & workflows

Describe una automatización en palabras y el Orquestador construye el flujo: trigger → pasos. Pasos deterministas baratos, IA solo donde razona. Conecta Zapier, Make y n8n, importa tus automatizaciones existentes, y paga por corrida (con log de corridas y auto-fix ante fallos).

Operaciones & finanzas

Según tu plan y vertical: proyectos, tareas, inventario, proveedores, mantenimientos, personal, cashflow e invoices. Tus SOPs pueden convertirse en tareas ejecutables para tus agentes.

Integraciones & BYO-LLM

Conecta Gmail, Google Calendar, tus redes, tu CRM y tus automatizaciones. Para la IA, arranca con la plataforma incluida o trae tu propio modelo (Anthropic, OpenAI, Gemini, Mistral, DeepSeek, Perplexity, Ollama, OpenRouter, Hugging Face, xAI/Grok…) — así tus costos de compute quedan bajo tu control y puedes elegir la potencia que quieras por agente.

Créditos, planes & billing

El principio es simple: pensar es gratis, hacer cuesta. Cobramos por el valor entregado, no por cada token — así el precio es predecible y justo.

Gratis o de bajo costo

  • Chatear con tus agentes y con el Orquestador.
  • Planear, consultar y leer tus propios datos.
  • Revisar y aprobar acciones en la Decision Inbox.
  • Navegar el panel, ver métricas y reportes.

Consume créditos (value-actions)

  • Contenido: generar imágenes, carruseles y videos; investigar tendencias en vivo; transcribir notas de voz.
  • Distribución: publicar en redes; enviar campañas de email (por destinatario); responder comentarios.
  • Ventas: búsquedas de Lead Finder; enriquecer/analizar prospectos; generar cotizaciones y propuestas en PDF.
  • Automatización: cada corrida de un workflow (1 crédito base + los pasos que usen IA).
  • Agentes en modo Auto: cada acción que ejecutan por ti.
  • Funnels: publicar y hostear páginas.

El costo exacto de cada acción es visible antes de ejecutarla y en tu historial — sin sorpresas. Empiezas con créditos de bienvenida en Free; escalas a Pro cuando necesitas más capacidad. El plan Agency (operar y revender a tus clientes) se activa desde Billing para usuarios Pro. Puedes comprar recargas cuando quieras y activar auto-reload por saldo bajo.

🔌 Trae tu propio modelo (BYO-LLM): conectar tu propia IA cubre tu costo de compute y abarata el chat y el razonamiento de los agentes. Las value-actions (producir, distribuir, traer data) se cobran igual, porque el valor está en el resultado, no en el token.

Soporte

Tienes ayuda en dos niveles:

  • AI Assistant — el asistente dentro de la app, disponible en la barra superior, que responde sobre cómo usar AireClaw.
  • Tickets de soporte — desde el módulo Support creas tickets (bug, pregunta, solicitud) con prioridad y seguimiento. Nuestro equipo responde en la cola, ordenada por urgencia y tiempo de espera.

Para temas de cuenta o datos, escríbenos a support@aireclaw.ai.

Developers · Autenticación

AireClaw expone una API REST y un servidor MCP bajo /api/v1, autenticados con una API key de tu tenant (créala en tu panel). Envíala en cada request:

Authorization: Bearer <tu_api_key>
# o
X-API-Key: <tu_api_key>

Las keys tienen permisos de lectura o lectura/escritura y están sujetas a rate limiting. Base URL: https://leaderos.aireclaw.ai/api/v1.

Developers · API REST

MétodoEndpointDescripción
GET/agentsLista tus agentes
GET/agents/{id}Detalle de un agente
POST/agents/{id}/chatHabla con un agente
POST/leadsCrea un lead en tu CRM
GET/decisionsAcciones pendientes de aprobación
POST/decisions/{id}/decideAprueba o rechaza una acción
GET/workflowsLista tus automatizaciones

Ejemplo — hablar con un agente

curl https://leaderos.aireclaw.ai/api/v1/agents/<id>/chat \
  -H "Authorization: Bearer $AIRECLAW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Dame 3 ideas de contenido para esta semana"}'

Ejemplo — aprobar una decisión

curl https://leaderos.aireclaw.ai/api/v1/decisions/123/decide \
  -H "Authorization: Bearer $AIRECLAW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"approve": true, "reason": "ok"}'

Developers · MCP

AireClaw incluye un servidor Model Context Protocol (JSON-RPC 2.0) que expone tus agentes como tools — para usarlos desde Claude, Cursor u otro cliente MCP. Endpoint:

POST https://leaderos.aireclaw.ai/api/v1/mcp
Authorization: Bearer <tu_api_key>

Métodos soportados: initialize, tools/list, tools/call. Tools disponibles: listar agentes, obtener un agente, hablar con un agente, listar decisiones pendientes y decidir sobre ellas.

Ejemplo — listar tools

curl https://leaderos.aireclaw.ai/api/v1/mcp \
  -H "Authorization: Bearer $AIRECLAW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
🔌 Al conectar el servidor MCP a tu cliente favorito, tu equipo de agentes de AireClaw queda disponible como herramientas dentro de esa herramienta.

Developers · Captura & webhooks

Para capturar leads desde tus propias páginas o formularios, usa el endpoint público de captura por funnel:

POST https://leaderos.aireclaw.ai/api/v1/capture/<slug>
Content-Type: application/json

{ "name": "Ana", "email": "ana@ejemplo.com", "phone": "+56 9 ..." }

El lead entra directo a tu CRM en el pipeline configurado para ese funnel. Los disparadores de automatización (rules engine) también aceptan hooks entrantes autenticados por un token único por regla.

Seguridad, datos & infraestructura

AireClaw corre sobre Google Cloud (Cloud Run + Cloud SQL). Puntos clave:

  • Aislamiento multi-tenant — tus datos viven en tu workspace y nunca se cruzan con otro cliente.
  • Cifrado — el tráfico viaja cifrado (TLS); las credenciales de tus integraciones se guardan cifradas y nunca se exponen en el navegador ni en mensajes de error.
  • Permisos — tus agentes operan solo dentro de los grants y guardrails que defines.
  • Backups & recuperación — respaldos automáticos diarios con point-in-time recovery, más una copia off-site.
  • Tus derechos — puedes exportar o solicitar la eliminación de tus datos en cualquier momento.

Ver también la Política de privacidad y los Términos.