أتمتة عمليات Odoo ERP باستخدام الذكاء الاصطناعي OpenClaw

Odoo عبارة عن منصة شاملة لتخطيط موارد المؤسسات (ERP) تحتوي على وحدات تغطي كل وظائف الأعمال بدءًا من المحاسبة وحتى التصنيع وحتى الموارد البشرية. ولكن حتى مع قواعد التشغيل الآلي المضمنة في Odoo، فإن معظم المؤسسات تستخدم فقط جزءًا صغيرًا مما هو ممكن. قواعد الأتمتة التي يأتي معها Odoo تعتمد على المشغلات والقواعد، فهي تفتقر إلى القدرة على التفكير المنطقي للتعامل مع الاستثناءات، والتكيف مع السياق، واتخاذ قرارات متعددة الخطوات. OpenClaw يملأ هذه الفجوة.

يجلس عملاء OpenClaw AI جنبًا إلى جنب مع Odoo كطبقة عمليات مستقلة. إنهم يستهلكون أحداث Odoo من خلال خطافات الويب، وينفذون تفكيرًا متعدد الخطوات على البيانات، ويتفاعلون مع واجهة برمجة تطبيقات JSON-RPC الخاصة بـ Odoo لإنشاء السجلات وتحديثها والاستعلام عنها، والتنسيق عبر الوحدات بطرق لا تستطيع أتمتة Odoo الأصلية القيام بها. والنتيجة هي نظام تخطيط موارد المؤسسات (ERP) الذي يعمل بشكل أقرب إلى ما يمكن أن يفعله فريق العمليات الماهر: توقع المشكلات، وحل الاستثناءات، وتحسين العمليات بشكل مستمر.

الوجبات الرئيسية

• يتكامل OpenClaw مع Odoo عبر واجهة برمجة تطبيقات JSON-RPC ومشغلات webhook، ولا يتطلب أي تعديلات على مصدر Odoo.
• يقوم وكيل أتمتة الشراء بمراقبة نقاط إعادة الطلب، وإنشاء طلبات عرض الأسعار، واختيار الموردين، وإنشاء أوامر الشراء بناءً على قواعد قابلة للتكوين ومنطق الذكاء الاصطناعي.
• يقوم وكيل تسوية المورد بمطابقة فواتير المورد مع أوامر الشراء والإيصالات، وترحيل الفواتير المطابقة، واستثناءات المسارات.
• يقوم وكيل تحسين المخزون بتحليل أنماط الطلب ويوصي بتعديلات المخزون الآمن وإعادة ترتيب الكميات وإجراءات إدارة انتهاء الصلاحية.
• يقوم وكيل خط أنابيب المبيعات بمراقبة الفرص، ويرسل مهام المتابعة، ويحدث فئات التوقعات، ويحدد الصفقات المعرضة للخطر.
• جميع إجراءات الوكيل قابلة للعكس حسب التصميم - يقوم الوكيل بتسجيل كل سجل Odoo يقوم بإنشائه أو تعديله مع إمكانية التراجع.
• تتم معالجة التنسيق متعدد الوحدات (على سبيل المثال، ربط نقص أمر المبيعات بأمر الشراء وأمر عمل الإنتاج) محليًا بواسطة طبقة الوكيل.
• توفر خدمة تكامل OpenClaw Odoo من ECOSIRE وكلاء تم تصميمهم مسبقًا وتم معايرتهم وفقًا لتكوين Odoo الخاص بك.

---

هندسة التكامل: كيف يتصل OpenClaw بـ Odoo

يتكامل OpenClaw مع Odoo من خلال آليتين:

أحداث الخطاف عبر الويب: يمكن للإجراءات التلقائية لـ Odoo إطلاق خطافات الويب HTTP على أحداث الإنشاء/التحديث/الحذف. يشترك مستمع الأحداث في OpenClaw في خطافات الويب هذه ويوجه الأحداث إلى الوكيل المناسب. هذا هو المسار في الوقت الحقيقي، الذي يحركه الحدث.

استقصاء JSON-RPC: بالنسبة للمقاييس ولوحات المعلومات والأتمتة المجدولة، يقوم OpenClaw باستقصاء واجهة برمجة تطبيقات Odoo JSON-RPC مباشرة. هذا هو المسار المجدول والمثقل بالقراءة.

// 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 },
  });
}

يتم تخزين مفتاح Odoo API (الذي تم إنشاؤه في الإعدادات > التقنية > مفاتيح واجهة برمجة التطبيقات المسموح بها) في Vault ولا يظهر أبدًا في التعليمات البرمجية أو ملفات التكوين.

---

وكيل أتمتة الشراء: المشتريات الذكية

الشراء اليدوي بطيء وعرضة للخطأ. ترسل نقطة إعادة الطلب رسالة بريد إلكتروني، ويقوم المشتري بفحصها بعد ثلاثة أيام، ويرسل طلب عرض أسعار إلى ثلاثة بائعين، وينتظر أسبوعًا للحصول على الردود، وينشئ أمر الشراء يدويًا، وينفد مخزون المصنع في هذه الأثناء. يقوم وكيل أتمتة الشراء بضغط هذا إلى دقائق.

سير عمل الوكيل:

1. مراقبة نقاط إعادة الطلب: الاشتراك في أحداث مخزون Odoo. عندما تنخفض الكمية الفعلية لمنتج ما عن نقطة إعادة الطلب (محاسبة الكميات المطلوبة بالفعل أثناء النقل)، يقوم الوكيل بتشغيل تسلسل الشراء.

2. حساب الكمية المثالية للطلب: يتجاوز حساب الحد الأدنى والحد الأقصى. يأخذ في الاعتبار اتجاه الطلب الحالي وأوامر المبيعات المؤكدة القادمة والعوامل الموسمية والمهل الزمنية للمورد لتحديد الكمية المناسبة - وليس فقط الحد الأدنى.

3. اختيار البائع: الاستعلام عن قائمة أسعار البائع وبيانات المهلة الزمنية في Odoo. بالنسبة للمنتجات التي لديها العديد من الموردين المعتمدين، يتم التحديد بناءً على السعر الحالي والتوفر وتاريخ أداء التسليم (المأخوذ من عمليات الاستلام السابقة) والحد الأدنى لكميات الطلب.

4. إنشاء طلب عرض أسعار أو أمر شراء مباشر: بالنسبة إلى الموردين المعتمدين الذين لديهم اتفاقيات أسعار حالية، قم بإنشاء طلب شراء مباشرةً. بالنسبة للموردين الجدد أو المنتجات التي ليس لديها اتفاقيات أسعار، قم بإنشاء طلب عرض الأسعار (RFQ) وإرساله عبر البريد الإلكتروني، ثم قم بمراقبة الردود.

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 };
  },
});

---

وكيل تسوية فاتورة البائع

تعد المطابقة الثلاثية (فاتورة مقابل أمر الشراء مقابل استلام البضائع) واحدة من أكثر عمليات الحسابات الدائنة كثافة في العمالة. يقوم وكيل التسوية بأتمتة ما يزيد عن 85% من الفواتير التي تتطابق بشكل واضح، مع ترك الاستثناءات للمراجعة البشرية.

منطق المطابقة:

1. قم باستخراج بيانات الفاتورة (المورد، رقم الفاتورة، المبلغ، البنود) من المستند أو من موجز EDI.
2. ابحث عن أمر الشراء المطابق في Odoo باستخدام الرقم المرجعي للفاتورة أو أساليب البائع + التاريخ + المبلغ.
3. ابحث عن إيصالات البضائع المرتبطة بأمر الشراء.
4. قارن بنود الفاتورة ببنود أمر الشراء وكميات الاستلام.
5. إذا كانت المبالغ متطابقة ضمن حدود التسامح (قابلة للتكوين، عادةً 2%)، فقم بترحيل فاتورة المورد تلقائيًا.
6. إذا كان هناك اختلاف، فقم بإنشاء فاتورة في حالة المسودة مع الإشارة إلى عدم التطابق لمراجعة فريق AP.

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 };
  },
});

---

وكيل تحسين المخزون

تصبح نقاط إعادة الطلب الثابتة وقيم المخزون الآمن خاطئة في اللحظة التي تتغير فيها أنماط الطلب. يقوم وكيل تحسين المخزون بتحليل بيانات الطلب بشكل مستمر ويوصي بالتعديلات.

يعمل الوكيل أسبوعيًا ويقوم بتحليل كل منتج في المخزون:

التنبؤ بالطلب: لحساب متوسط ​​الطلب الأسبوعي والانحراف المعياري عن آخر 52 أسبوعًا من بيانات المبيعات/الاستهلاك. يطبق التعديل الموسمي على المنتجات ذات أنماط الطلب الموسمية.

تحسين المخزون الآمن: يستخدم هدف مستوى الخدمة (قابل للتكوين لكل فئة منتج) وتغير الطلب لحساب المخزون الآمن الأمثل إحصائيًا. تحتاج المنتجات ذات التقلبات العالية في الطلب إلى المزيد من المخزون الآمن؛ فالمنتجات ذات الطلب المستقر والمتوقع تحتاج إلى أقل.

** توصية نقطة إعادة الطلب **: المخزون الآمن بالإضافة إلى الطلب خلال المهلة الزمنية يساوي نقطة إعادة الطلب الموصى بها. يقوم الوكيل بمقارنة القيمة الموصى بها بقيمة Odoo الحالية ويضع علامة على الانحرافات المهمة للمراجعة.

إدارة انتهاء الصلاحية: بالنسبة للمنتجات القابلة للتلف، تحدد العناصر التي تقترب من انتهاء الصلاحية وتنشئ الإجراءات: النقل إلى مواقع أسرع حركة، أو وضع علامة على تخفيض السعر، أو إنشاء أوامر التخلص.

---

وكيل أتمتة خطوط أنابيب المبيعات

وكيل خط أنابيب المبيعات هو طبقة أتمتة CRM أعلى Odoo CRM. فهو يراقب مراحل الفرصة، ويحدد الصفقات التي توقفت، ويرسل مهام المتابعة إلى مديري الحسابات، ويضبط درجات الاحتمالية بناءً على إشارات المشاركة، ويضع علامة على الفرص المعرضة للخطر في التوقعات.

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 };
  },
});

---

وكيل أمر عمل التصنيع

بالنسبة للمصنعين الذين يستخدمون Odoo Manufacturing، يقوم وكيل أمر العمل بمراقبة أوامر الإنتاج، والكشف عن الاختناقات، واتخاذ الإجراءات التصحيحية.

القدرات الرئيسية:

• مراقبة السعة: للتحقق من حمل مركز العمل مقابل الساعات المتاحة ووضع علامة على التخصيص الزائد قبل أن يتسبب في حدوث تأخير.
• اكتشاف نقص المواد: التحقق من توفر المكونات لأوامر الإنتاج القادمة. إذا كان أحد المكونات قصيرًا، فسيتم تشغيل أمر الشراء أو النقل بين المستودعات تلقائيًا.
• تسلسل أوامر العمل: بالنسبة لقوائم انتظار مركز العمل، يقترح التسلسل الأمثل لتقليل وقت الإعداد وزيادة الإنتاجية إلى أقصى حد.
• تصعيد الجودة: في حالة فشل فحص مراقبة الجودة، يقوم الوكيل بتعليق أمر العمل وإبلاغ فريق الجودة ومنع الدفعة من الانتقال إلى المرحلة التالية.

---

أتمتة المحاسبة: معالجة نهاية الفترة

تتطلب محاسبة Odoo معالجة نهاية الفترة: تسوية كشف الحساب البنكي، والاستحقاقات، وإعادة تقييم العملة الأجنبية، وإدخالات الاستهلاك، وإغلاق الفترة. يقوم وكيل المحاسبة بأتمتة الخطوات الروتينية.

تسوية البنك: يقوم الوكيل بمعالجة عمليات استيراد كشف الحساب البنكي، ومطابقة المعاملات مع إدخالات دفتر يومية Odoo باستخدام مطابقة المبلغ والتاريخ والمرجع، وإنشاء إدخالات متبقية للمعاملات غير المطابقة. عادةً ما تتجاوز معدلات المطابقة للخلاصات النظيفة 95%.

إدخالات الاستحقاق: استنادًا إلى قواعد الاستحقاق التي تم تكوينها (النفقات المدفوعة مسبقًا، والإيرادات المستحقة، والإيرادات غير المكتسبة)، يقوم الوكيل بإنشاء إدخالات دفتر يومية الاستحقاق الشهرية وإدخالات الإلغاء للفترة التالية.

إعادة تقييم العملة الأجنبية: يسترد الوكيل أسعار الصرف الحالية من موجز أسعار خارجي، ويحسب المكاسب/الخسائر غير المحققة على جميع أرصدة العملات الأجنبية المفتوحة، وينشر إدخالات إعادة التقييم وفقًا لقواعد المعايير الدولية لإعداد التقارير المالية/مبادئ المحاسبة المقبولة عمومًا.

---

الأسئلة المتداولة

هل يتطلب OpenClaw إجراء تغييرات على كود مصدر Odoo أو وحدات Odoo المخصصة؟

لا، يتم دمج OpenClaw بالكامل من خلال واجهة برمجة تطبيقات JSON-RPC القياسية الخاصة بـ Odoo وآليات خطاف الويب. ليست هناك حاجة لأي تعديلات على مصدر Odoo، أو وحدات مخصصة، أو تبعيات OCA. وهذا يعني أن التكامل يعمل مع أي إصدار من Odoo يدعم JSON-RPC API (Odoo 14+) ويستمر في تحديثات Odoo دون تعديل.

كيف يتعامل الوكيل مع التحكم في الوصول إلى Odoo وقواعد التسجيل؟

يقوم الوكيل بالمصادقة كمستخدم خدمة Odoo مخصص مع دور تم تكوينه خصيصًا لتلبية احتياجات الوكيل. تنطبق قوائم التحكم في الوصول (ACLs) وقواعد التسجيل الخاصة بـ Odoo على مستخدم الوكيل تمامًا كما تنطبق على المستخدم البشري. إذا حاول الوكيل إجراء عملية ليس لديه إذن بها، فسيقوم Odoo بإرجاع خطأ في الوصول، والذي يقوم معالج أخطاء الوكيل بتسجيله وتصعيده. وهذا يعني أن نموذج أمان Odoo الخاص بك يظل هو المصدر الرسمي للتحكم في الوصول.

ماذا يحدث إذا كان خادم Odoo غير متاح مؤقتًا أثناء تنفيذ الوكيل؟

يحتوي تعريف أداة Odoo على منطق إعادة المحاولة مع التراجع الأسي. بالنسبة للأخطاء العابرة (HTTP 503، مهلة الاتصال)، يقوم الوكيل بإعادة المحاولة حتى ثلاث مرات مع تأخيرات مدتها 5 ثوانٍ، و15 ثانية، و30 ثانية. بالنسبة لحالات الفشل المستمرة، يتم توجيه المهمة إلى قائمة انتظار الأحرف الميتة ويتم إرسال تنبيه إلى فريق العمليات. لا يتم فقدان أي بيانات مهمة أثناء الرحلة لأن الذاكرة العاملة للوكيل تحافظ على حالة المهمة عبر محاولات إعادة المحاولة.

هل يمكن للوكيل إنشاء سجلات في Odoo نيابة عن مستخدمين محددين؟

نعم. تدعم واجهة برمجة تطبيقات Odoo JSON-RPC انتحال هوية المستخدم المستند إلى السياق عبر المعلمة uid إذا كان حساب الخدمة لديه الأذونات اللازمة. يسمح هذا لأوامر الشراء التي أنشأها الوكيل بالظهور كما أنشأها المشتري المسؤول عن فئة المنتج تلك، مع الحفاظ على مسار التدقيق وتوجيه الإشعارات في Odoo. يعد انتحال هوية حساب الخدمة أو استخدامها قرارًا سياسيًا يساعد ECOSIRE العملاء على اتخاذه بناءً على متطلبات التدقيق الخاصة بهم.

كيف يتعامل التكامل مع تكوينات Odoo للشركات المتعددة؟

بالنسبة لمثيلات Odoo متعددة الشركات، يتضمن بيان الوكيل تكوين تعيين الشركة. عند معالجة الأحداث أو إجراء استدعاءات واجهة برمجة التطبيقات (API)، يقوم الوكيل بتعيين سياق الشركة المناسب في جلسة Odoo. يتم التعامل مع المعاملات بين الشركات الشقيقة (عمليات الشراء والتحويلات بين الشركات الشقيقة) بواسطة الوكيل عن طريق إجراء استدعاءات منفصلة لواجهة برمجة التطبيقات (API) في سياق كل شركة وربط السجلات الناتجة.

---

الخطوات التالية

يعد Odoo نظامًا أساسيًا قويًا، ولكنه يصل إلى إمكاناته الكاملة عندما تتعامل طبقة الأتمتة الذكية مع التعقيد التشغيلي الذي لا تستطيع قواعد الأتمتة الأصلية التعامل معه. يقوم وكلاء OpenClaw بسد الفجوة بين ما يمكن لـ Odoo تتبعه وما يحتاج فريق العمليات لديك إلى القيام به.

توفر [خدمة تكامل OpenClaw Odoo] (/services/openclaw/odoo-integration) من ECOSIRE عوامل مدمجة مسبقًا تمت معايرتها وفقًا لوحدات Odoo الخاصة بك، وأتمتة سير العمل المخصصة، والتحسين المستمر. يتمتع فريقنا بخبرة عميقة في كل من تطوير وكيل OpenClaw والتكوين الوظيفي لـ Odoo - فنحن نربط بين كلا المجالين.

اتصل بـ ECOSIRE لمناقشة متطلبات التشغيل الآلي لـ Odoo والحصول على خطة تنفيذ مخصصة.