Automatización de las operaciones de Odoo ERP con OpenClaw AI

Odoo es una plataforma ERP integral con módulos que cubren todas las funciones comerciales, desde contabilidad hasta fabricación y recursos humanos. Pero incluso con las reglas de automatización integradas de Odoo, la mayoría de las organizaciones utilizan sólo una fracción de lo que es posible. Las reglas de automatización que incluye Odoo se basan en activadores y reglas: carecen de la capacidad de razonamiento para manejar excepciones, adaptarse al contexto y tomar decisiones de varios pasos. OpenClaw llena este vacío.

Los agentes de OpenClaw AI se sientan junto a Odoo como una capa de operaciones autónoma. Consumen eventos de Odoo a través de webhooks, ejecutan razonamientos de varios pasos sobre los datos, interactúan con la API JSON-RPC de Odoo para crear, actualizar y consultar registros, y coordinan entre módulos de maneras que la automatización nativa de Odoo no puede. El resultado es un ERP que opera más cerca de lo que haría un equipo de operaciones capacitado: anticipando problemas, resolviendo excepciones y optimizando procesos continuamente.

Conclusiones clave

OpenClaw se integra con Odoo a través de la API JSON-RPC y activadores de webhook, sin requerir modificaciones del código fuente de Odoo.

El Agente de automatización de compras monitorea los puntos de reorden, genera solicitudes de cotización, selecciona proveedores y crea órdenes de compra basadas en reglas configurables y razonamiento de inteligencia artificial.

The Vendor Reconciliation Agent matches supplier invoices to POs and receipts, posts matched invoices, and routes exceptions.

El Agente de optimización de inventario analiza los patrones de demanda y recomienda ajustes de stock de seguridad, cantidades de reorden y acciones de gestión de vencimientos.

El agente de canalización de ventas monitorea oportunidades, envía tareas de seguimiento, actualiza categorías de pronóstico e identifica acuerdos en riesgo.

Todas las acciones del agente son reversibles por diseño: el agente registra cada registro de Odoo que crea o modifica con la capacidad de deshacerlo.

La capa de agente maneja de forma nativa la coordinación de múltiples módulos (por ejemplo, vincular una escasez de orden de venta con una orden de compra y una orden de trabajo de producción).

El servicio de integración OpenClaw Odoo de ECOSIRE proporciona agentes prediseñados y calibrados para su configuración de Odoo.

Arquitectura de integración: cómo se conecta OpenClaw con Odoo

OpenClaw se integra con Odoo a través de dos mecanismos:

Eventos de webhook: las acciones automatizadas de Odoo pueden activar webhooks HTTP en eventos de creación/actualización/eliminación de registros. El detector de eventos de OpenClaw se suscribe a estos webhooks y enruta los eventos al agente apropiado. Este es el camino en tiempo real impulsado por eventos.

Encuesta JSON-RPC: para métricas, paneles y automatización programada, OpenClaw sondea la API JSON-RPC de Odoo directamente. Este es el camino programado y de lectura intensa.

// Odoo tool definition for OpenClaw
export const OdooTool = defineTool({
  name: "odoo",
  type: "json-rpc",
  endpoints: {
    authenticate: "/web/session/authenticate",
    call: "/web/dataset/call_kw",
    search: "/web/dataset/call_kw/search_read",
  },
  auth: {
    type: "session",
    database: process.env.ODOO_DB,
    username: process.env.ODOO_USERNAME,
    apiKey: "${ODOO_API_KEY}", // Secrets manager reference
  },
});

// Generic Odoo search_read wrapper
async function odooSearchRead(tool, model: string, domain: any[], fields: string[], limit = 100) {
  return tool.call({
    model,
    method: "search_read",
    args: [domain],
    kwargs: { fields, limit },
  });
}

La clave API de Odoo (generada en Configuración > Técnica > Claves API permitidas) se almacena en Vault y nunca aparece en el código o en los archivos de configuración.

Agente de automatización de compras: adquisiciones inteligentes

La adquisición manual es lenta y propensa a errores. Un punto de reorden envía un correo electrónico, un comprador lo revisa tres días después, envía una solicitud de cotización a tres proveedores, espera una semana para recibir respuestas, crea manualmente la orden de compra y, mientras tanto, la fábrica se queda sin existencias. El agente de automatización de compras lo comprime en minutos.

El flujo de trabajo del agente:

Monitorear puntos de reorden: se suscribe a eventos de inventario de Odoo. Cuando la cantidad disponible de un producto cae por debajo del punto de reorden (teniendo en cuenta las cantidades ya pedidas en tránsito), el agente desencadena la secuencia de adquisición.
Calcular la cantidad óptima de pedido: va más allá del cálculo mínimo-máximo. Considera la tendencia actual de la demanda, los próximos pedidos de ventas confirmados, los factores estacionales y los plazos de entrega de los proveedores para determinar la cantidad correcta, no solo el mínimo.
Selección de proveedor: Consulta la lista de precios del proveedor y los datos de tiempo de entrega en Odoo. Para productos con múltiples proveedores aprobados, seleccione según el precio actual, la disponibilidad, el historial de desempeño de entrega (extraído de recibos anteriores) y las cantidades mínimas de pedido.
Crear RFQ o Orden de Compra Directa: Para proveedores establecidos con acuerdos de precios vigentes, crea una Orden de Compra directamente. Para nuevos proveedores o productos sin acuerdos de precios, crea una solicitud de cotización y la envía por correo electrónico, luego monitorea las respuestas.

export const AutomateProcurement = defineSkill({
  name: "automate-procurement",
  tools: ["odoo", "email"],
  async run({ input, tools }) {
    const product = await odooSearchRead(
      tools.odoo, "product.product",
      [["id", "=", input.productId]],
      ["id", "name", "qty_available", "reorder_min_qty", "seller_ids", "route_ids"]
    );

    if (!product.length) throw new SkillError("PRODUCT_NOT_FOUND");

    const p = product[0];
    const transitQty = await getInTransitQty(tools.odoo, input.productId);
    const confirmedDemand = await getConfirmedDemand(tools.odoo, input.productId, { days: 60 });

    const orderQty = calculateOptimalOrderQty({
      currentStock: p.qty_available + transitQty,
      confirmedDemand,
      safetyStock: p.reorder_min_qty,
      vendorLeadTime: await getVendorLeadTime(tools.odoo, input.productId),
    });

    const bestVendor = await selectVendor(tools.odoo, input.productId, orderQty);

    if (!bestVendor) {
      return { action: "RFQ_NEEDED", reason: "No vendor with current price agreement" };
    }

    // Create Purchase Order
    const po = await tools.odoo.call({
      model: "purchase.order",
      method: "create",
      args: [{
        partner_id: bestVendor.partnerId,
        order_line: [[0, 0, {
          product_id: input.productId,
          product_qty: orderQty,
          price_unit: bestVendor.price,
          date_planned: addDays(new Date(), bestVendor.leadTimeDays),
        }]],
      }],
    });

    return { poId: po, orderQty, vendorId: bestVendor.partnerId };
  },
});

Agente de conciliación de facturas de proveedores

El cotejo triple (factura contra orden de compra contra recepción de mercancías) es uno de los procesos de cuentas por pagar que requieren más mano de obra. El Agente de Reconciliación lo automatiza para más del 85 % de las facturas que coinciden claramente, dejando las excepciones para la revisión humana.

La lógica de coincidencia:

Extraiga los datos de la factura (proveedor, número de factura, importe, partidas individuales) del documento o de un feed EDI.
Encuentre la orden de compra coincidente en Odoo utilizando el número de referencia de la factura o la heurística de proveedor + fecha + monto.
Busque las entradas de mercancías asociadas a la orden de compra.
Compare las partidas de la factura con las líneas de la orden de compra y las cantidades de los recibos.
Si los montos coinciden dentro de la tolerancia (configurable, generalmente 2%), registre la factura del proveedor automáticamente.
Si hay una variación, cree un proyecto de ley en estado de borrador con la discrepancia anotada para que el equipo de AP la revise.

export const ReconcileVendorInvoice = defineSkill({
  name: "reconcile-vendor-invoice",
  tools: ["odoo"],
  async run({ input, tools }) {
    // Find matching PO
    const pos = await odooSearchRead(
      tools.odoo, "purchase.order",
      [["name", "=", input.poReference], ["state", "in", ["purchase", "done"]]],
      ["id", "order_line", "amount_total", "partner_id"]
    );

    if (!pos.length) {
      return { matched: false, reason: "PO_NOT_FOUND", action: "ROUTE_TO_AP_TEAM" };
    }

    const po = pos[0];
    const amountVariance = Math.abs(po.amount_total - input.invoiceTotal);
    const variancePct = amountVariance / po.amount_total;

    if (variancePct > 0.02) {
      // Create draft bill with mismatch annotation
      await tools.odoo.call({
        model: "account.move",
        method: "create",
        args: [{
          move_type: "in_invoice",
          partner_id: po.partner_id[0],
          invoice_origin: po.name,
          ref: input.invoiceNumber,
          state: "draft",
          narration: `RECONCILIATION MISMATCH: Invoice total ${input.invoiceTotal} vs PO total ${po.amount_total} (variance: ${(variancePct * 100).toFixed(1)}%)`,
        }],
      });
      return { matched: false, variancePct, action: "DRAFT_BILL_CREATED_FOR_REVIEW" };
    }

    // Post the bill
    const bill = await tools.odoo.call({
      model: "account.move",
      method: "create",
      args: [{
        move_type: "in_invoice",
        partner_id: po.partner_id[0],
        invoice_origin: po.name,
        ref: input.invoiceNumber,
        invoice_line_ids: buildInvoiceLines(input.lineItems, po.order_line),
      }],
    });

    await tools.odoo.call({ model: "account.move", method: "action_post", args: [[bill]] });

    return { matched: true, billId: bill, variancePct };
  },
});

Agente de optimización de inventario

Los puntos de reorden estáticos y los valores de las existencias de seguridad se vuelven incorrectos en el momento en que cambian los patrones de demanda. El Agente de optimización de inventario analiza continuamente los datos de la demanda y recomienda ajustes.

El agente corre semanalmente y analiza cada producto del inventario:

Pronóstico de demanda: Calcula la demanda semanal promedio y la desviación estándar de las últimas 52 semanas de datos de ventas/consumo. Aplica ajuste estacional para productos con patrones de demanda estacionales.

Optimización del stock de seguridad: utiliza el objetivo de nivel de servicio (configurable por categoría de producto) y la variabilidad de la demanda para calcular el stock de seguridad estadísticamente óptimo. Los productos con alta variabilidad de demanda necesitan más stock de seguridad; los productos con una demanda estable y predecible necesitan menos.

Recomendación del punto de reorden: El stock de seguridad más la demanda durante el tiempo de entrega equivale al punto de reorden recomendado. El agente compara el valor recomendado con el valor actual de Odoo y señala las desviaciones significativas para su revisión.

Gestión de caducidad: para productos perecederos, identifica los artículos que están a punto de caducar y crea acciones: transferir a ubicaciones de movimiento más rápido, marcar para rebajas o crear órdenes de eliminación.

Agente de automatización del canal de ventas

El Sales Pipeline Agent es la capa de automatización de CRM además de Odoo CRM. Supervisa las etapas de las oportunidades, identifica los acuerdos que se han quedado en silencio, envía tareas de seguimiento a los administradores de cuentas, ajusta las puntuaciones de probabilidad en función de las señales de participación y señala las oportunidades en riesgo en el pronóstico.

export const MonitorSalesPipeline = defineSkill({
  name: "monitor-sales-pipeline",
  tools: ["odoo"],
  async run({ input, tools }) {
    const staleOpportunities = await odooSearchRead(
      tools.odoo, "crm.lead",
      [
        ["type", "=", "opportunity"],
        ["stage_id.name", "not in", ["Won", "Lost"]],
        ["date_last_stage_update", "<", addDays(new Date(), -14).toISOString()],
        ["probability", ">", 10],
      ],
      ["id", "name", "partner_id", "user_id", "expected_revenue", "probability", "date_last_stage_update"]
    );

    const actions = [];
    for (const opp of staleOpportunities) {
      // Create follow-up activity
      await tools.odoo.call({
        model: "mail.activity",
        method: "create",
        args: [{
          res_model: "crm.lead",
          res_id: opp.id,
          activity_type_id: 4, // Phone call type
          summary: `AI Alert: No activity for ${daysSince(opp.date_last_stage_update)} days`,
          user_id: opp.user_id[0],
          date_deadline: addDays(new Date(), 2).toISOString().split("T")[0],
          note: `This opportunity has had no stage movement or logged activity for ${daysSince(opp.date_last_stage_update)} days. Expected revenue: $${opp.expected_revenue.toLocaleString()}. Please review and update.`,
        }],
      });

      actions.push({ opportunityId: opp.id, action: "FOLLOWUP_ACTIVITY_CREATED" });
    }

    return { processed: staleOpportunities.length, actions };
  },
});

Agente de órdenes de trabajo de fabricación

Para los fabricantes que utilizan Odoo Manufacturing, el Agente de órdenes de trabajo monitorea las órdenes de producción, detecta cuellos de botella y toma acciones correctivas.

Capacidades clave:

Monitoreo de capacidad: verifica la carga del centro de trabajo versus las horas disponibles y señala la sobreasignación antes de que cause retrasos.
Detección de escasez de material: verifica la disponibilidad de componentes para próximos pedidos de producción. Si falta un componente, se activa automáticamente una orden de compra o una transferencia entre almacenes.
Secuenciación de órdenes de trabajo: para colas de centros de trabajo, sugiere una secuenciación óptima para minimizar el tiempo de configuración y maximizar el rendimiento.
Escalado de calidad: si una verificación de control de calidad falla, el agente pone la orden de trabajo en espera, notifica al equipo de calidad y evita que el lote pase a la siguiente etapa.

Automatización contable: procesamiento de fin de período

Odoo Accounting requiere procesamiento de fin de período: conciliación de extractos bancarios, acumulaciones, revaluación de moneda extranjera, asientos de depreciación y cierre del período. El Agente Contable automatiza los pasos de rutina.

Conciliación bancaria: El agente procesa las importaciones de extractos bancarios, compara las transacciones con los asientos del diario de Odoo utilizando la comparación de montos, fechas y referencias, y crea asientos residuales para transacciones no coincidentes. Las tasas de coincidencia para feeds limpios suelen superar el 95%.

Entradas de acumulación: según las reglas de acumulación configuradas (gastos pagados por adelantado, ingresos acumulados, ingresos no devengados), el agente genera entradas de diario de acumulación mensuales y entradas de reversión para el siguiente período.

Revaluación de moneda extranjera: el agente recupera los tipos de cambio actuales de una fuente de tasas externa, calcula las ganancias/pérdidas no realizadas en todos los saldos abiertos en moneda extranjera y publica las entradas de revaluación según las reglas IFRS/GAAP.

Preguntas frecuentes

¿OpenClaw requiere cambios en el código fuente de Odoo o en módulos personalizados de Odoo?

No. OpenClaw se integra completamente a través de la API JSON-RPC estándar de Odoo y los mecanismos de webhook. No se requieren modificaciones del código fuente de Odoo, módulos personalizados ni dependencias de OCA. Esto significa que la integración funciona con cualquier versión de Odoo que admita la API JSON-RPC (Odoo 14+) y sobreviva a las actualizaciones de Odoo sin modificaciones.

¿Cómo maneja el agente el control de acceso de Odoo y las reglas de registro?

El agente se autentica como un usuario del servicio Odoo dedicado con un rol configurado específicamente para las necesidades del agente. Las listas de control de acceso (ACL) y las reglas de registro de Odoo se aplican al usuario agente tal como lo harían con un usuario humano. Si el agente intenta una operación para la que no tiene permiso, Odoo devuelve un error de acceso, que el controlador de errores del agente registra y escala. Esto significa que su modelo de seguridad de Odoo sigue siendo la fuente autorizada de control de acceso.

¿Qué sucede si el servidor Odoo no está disponible temporalmente durante la ejecución del agente?

La definición de la herramienta Odoo tiene una lógica de reintento con retroceso exponencial. Para errores transitorios (HTTP 503, tiempo de espera de conexión), el agente reintenta hasta tres veces con retrasos de 5, 15 y 30 segundos. En caso de fallas persistentes, la tarea se dirige a la cola de mensajes fallidos y se envía una alerta al equipo de operaciones. No se pierden datos de tareas en curso porque la memoria de trabajo del agente mantiene el estado de la tarea en todos los reintentos.

¿Puede el agente crear registros en Odoo en nombre de usuarios específicos?

Sí. La API JSON-RPC de Odoo admite la suplantación de usuario basada en contexto a través del parámetro uid si la cuenta de servicio tiene los permisos necesarios. Esto permite que las órdenes de compra creadas por el agente aparezcan como creadas por el comprador responsable de esa categoría de producto, preservando el seguimiento de auditoría y el enrutamiento de notificaciones en Odoo. Suplantar o utilizar la identidad de la cuenta de servicio es una decisión de política que ECOSIRE ayuda a tomar a los clientes en función de sus requisitos de auditoría.

¿Cómo maneja la integración las configuraciones multiempresa de Odoo?

Para instancias de Odoo de varias empresas, el manifiesto del agente incluye una configuración de mapeo de la empresa. Al procesar eventos o realizar llamadas API, el agente establece el contexto apropiado de la empresa en la sesión de Odoo. El agente maneja las transacciones entre empresas entre empresas (compras y transferencias entre empresas) realizando llamadas API separadas en el contexto de cada empresa y vinculando los registros resultantes.

Próximos pasos

Odoo es una plataforma poderosa, pero alcanza su máximo potencial cuando una capa de automatización inteligente maneja la complejidad operativa que las reglas de automatización nativas no pueden. Los agentes de OpenClaw cierran la brecha entre lo que Odoo puede rastrear y lo que su equipo de operaciones necesita hacer.

El servicio de integración OpenClaw Odoo de ECOSIRE proporciona agentes prediseñados calibrados para sus módulos de Odoo, automatización personalizada del flujo de trabajo y optimización continua. Nuestro equipo tiene una amplia experiencia tanto en el desarrollo del agente OpenClaw como en la configuración funcional de Odoo; unimos ambos dominios.

Comuníquese con ECOSIRE para analizar sus requisitos de automatización de Odoo y recibir un plan de implementación personalizado.

Automating Odoo ERP Operations with OpenClaw AI