OpenClaw هي حلقة متكررة: فهي تقرأ مساحة عملك، وتشغل أوامر shell من خلال أداة التنفيذ الخاصة بها، وتقرأ المخرجات، وتقرر ما يجب القيام به بعد ذلك. فلماذا لا تكون اختبارات API الخاصة بك ضمن هذه الحلقة؟ إنها موجودة في Apidog خلف واجهة مستخدم رسومية، وتعمل عندما يتذكر أحدهم النقر. وكيلك لا يلمسها أبدًا.
الحل هو كتلة تكوين واحدة. واجهة سطر الأوامر (CLI) الخاصة بـ Apidog هي حزمة npm، apidog-cli، تشغل سيناريوهات الاختبار التي أنشأتها في Apidog مباشرة من الطرفية. بمجرد تثبيت CLI ومعرفة OpenClaw بوجودها، يقوم وكيلك بتشغيل سيناريو Apidog بنفس الطريقة التي يشغل بها اختبارات الوحدة الخاصة بك: قم بتشغيل الأمر، واقرأ رمز الخروج، واصلح الكود إذا كان أحمر.
يغطي هذا الدليل الجزء الخاص بـ OpenClaw الذي تتجاهله أدلة التثبيت العامة: أين تضع قواعد Apidog حتى يحتفظ بها الوكيل، وكيف تشغل أداة exec الخاصة بـ OpenClaw الأمر apidog run فعليًا، وكيفية قراءة النتيجة.
إذا لم تكن قد قمت بتثبيت CLI بعد، فافعل ذلك أولاً. يتناول كيفية تثبيت Apidog CLI باستخدام وكيل برمجة يعمل بالذكاء الاصطناعي عملية تثبيت npm والمصادقة والتشغيل الأول. يفترض هذا المقال أن apidog --version تطبع رقمًا وأن حسابك في Apidog مسجل الدخول.
عن أي OpenClaw نتحدث
OpenClaw هو وكيل الذكاء الاصطناعي مفتوح المصدر ومحلي التشغيل الذي يعمل على جهازك الخاص. لديه مساحة عمل، ومجموعة من المهارات، وأداة exec تشغل أوامر shell حقيقية. إنه ليس مكونًا إضافيًا لإكمال التعليمات البرمجية وليس روبوت دردشة مستضافًا. إذا كنت قد قمت بتشغيل openclaw محليًا وشاهدته يقوم بتحرير الملفات وتنفيذ الأوامر، فأنت في المكان الصحيح. للإعداد الأوسع، راجع أتمتة سير عمل تطوير OpenClaw ودليل تثبيت OpenClaw الآمن قبل أن تعطيه أي أوامر.
يعد هذا التمييز مهمًا لأن OpenClaw يتعلم قواعد المشروع من ملفات مساحة العمل، وهذه الآلية تحول "تشغيل اختباراتي" لمرة واحدة إلى شيء يستدعيه OpenClaw بنفسه. هذه الآلية هي AGENTS.md.
الخطوة 1: أضف قواعد Apidog إلى AGENTS.md
يقرأ OpenClaw ملفات مساحة العمل كتعليمات دائمة ويحقنها في سياق الوكيل. الملف الذي تريده هو AGENTS.md، وهو دليل القواعد الإجرائية الذي يخبر الوكيل بما يجب فعله وكيف. فكر في الأمر كـ CLAUDE.md لـ Claude Code؛ حتى أن OpenClaw يشحن قالبًا افتراضيًا تقوم بنسخه إلى مساحة عملك، ويعامل الرمز الرمزي (symlink) الشقيق CLAUDE.md على أنه نفس الملف. مساحة العمل الافتراضية هي ~/.openclaw/workspace، ولكن يمكنك توجيه وكيل إلى دليل مشروعك باستخدام agents.list[].workspace، ويدعم OpenClaw ملفات AGENTS.md ذات النطاق لكل دليل فرعي (راجع مرجع AGENTS.md في OpenClaw).
أضف كتلة قصيرة إلى ملف AGENTS.md الخاص بك:
## اختبار API باستخدام Apidog
- لتشغيل اختبارات API، استخدم Apidog CLI: `apidog run -t -e -r cli`.
- رمز الخروج 0 يعني أن جميع التأكيدات قد نجحت. أي قيمة غير صفرية تعني حدوث فشل. عاملها كبوابة نجاح/فشل.
- الجهاز مصادق عليه بالفعل باستخدام `apidog login`. لا تقم أبدًا بإضافة علامة --access-token ولا تضع رمزًا مميزًا في هذا الملف.
- إذا بدت علامة غير مألوفة، قم بتشغيل `apidog run --help` بدلاً من التخمين.
هذا هو سبب كتابة CLI في AGENTS.md بدلاً من ذكرها في الدردشة. معرف السيناريو الذي يتم إدخاله في جلسة ما يختفي عند انتهاء الجلسة. أما الذي في AGENTS.md فهو موجود لكل زميل في الفريق ولكل تشغيل لـ OpenClaw من الآن فصاعدًا.
الخطوة 2: احصل على الأمر من Apidog
ليس عليك كتابة معرف السيناريو يدويًا. افتح سيناريو الاختبار في Apidog، انتقل إلى علامة التبويب CI/CD الخاصة به، وانسخ الأمر الذي تم إنشاؤه. يبدو الأمر كالتالي:
apidog run -t 1234567 -e 890123 -r cli
يمثل -t سيناريو الاختبار، و -e البيئة، و -r cli هو المُبلّغ. الصق المعرفات الحقيقية في كتلة AGENTS.md من الخطوة 1 حتى يستدعي OpenClaw دائمًا السيناريو الصحيح مقابل البيئة الصحيحة. يغطي دليل Apidog CLI الكامل و مرجع أمر apidog run كل علامة إذا أردت ضبطها.
الخطوة 3: اجعل الوكيل يشغل الاختبار
مع وضع الكتلة في مكانها، ابدأ OpenClaw مقابل مشروعك وقم بإجراء تغيير يمس واجهة برمجة التطبيقات الخاصة بك، أو اطلب منه فقط تشغيل التحقق. نظرًا لأن AGENTS.md موجود بالفعل في السياق، فإن الوكيل يعرف أن CLI موجود ويصدر الأمر apidog run من خلال أداة exec الخاصة به.
تشغل أداة exec أوامر shell في مساحة العمل، ويتحكم فيها OpenClaw بوضع صلاحية. الأوضاع هي deny، allowlist، ask، auto، و full (موثقة في صفحة أوضاع صلاحيات OpenClaw). لوكيل برمجة، auto هو الإعداد المنطقي: الأوامر المدرجة في القائمة البيضاء تعمل بدون طلب، وأي شيء آخر يمر بالمراجعة قبل أن يسألك. إذا كان وضعك ask، يتوقف OpenClaw ويطلب الموافقة قبل تشغيل apidog run؛ وافق عليه مرة واحدة، أو أضف الأمر إلى قائمتك البيضاء بحيث يعمل اختبار القراءة فقط مقابل بيئة الاختبار بشكل مستقل. اضبط الوضع تحت tools.exec في openclaw.json.
الخطوة 4: اقرأ التقرير داخل OpenClaw
يطبع مُبلغ -r cli نتيجة خطوة بخطوة في الطرفية: كل طلب، كل تأكيد، وأي منها فشل مع القيمة المتوقعة مقابل القيمة الفعلية. هذا التحديد المباشر هو ما يقرأه OpenClaw لتحديد خطوته التالية، لذا حافظ على cli في القائمة.
عندما تريد تقريرًا يمكنك فتحه في متصفح أو تسليمه لزميل في الفريق، أضف مُبلّغ HTML:
apidog run -t 1234567 -e 890123 -r cli,html
يكتب مُبلغ html ملفًا مستقلاً إلى ./apidog-reports. حافظ على cli بجانبه حتى يظل OpenClaw يحصل على المخرجات المباشرة. لتهيئة JUnit التي تحللها لوحات معلومات CI وكل مُبلغ آخر، راجع دليل تقارير اختبار Apidog CLI.
اختبار OpenClaw داخل حلقته الخاصة
النقطة المهمة هي ما يحدث عندما تتوقف عن السؤال ويقوم OpenClaw بتشغيل السيناريو من تلقاء نفسه لأن AGENTS.md أمره بذلك.
تخيل OpenClaw يقوم بتحرير معالج يقوم ببناء استجابة سحب. تتغير حلقته: يقوم بتحرير الكود، ثم، بدلاً من إعلان النصر، يشغل سيناريو Apidog الخاص بك مقابل بيئة الاختبار (staging)، ويقرأ رمز الخروج، ويتصرف بناءً عليه. إذا كان أخضر، ينتقل. إذا كان أحمر، يفتح التقرير، يقرأ أي تأكيد فشل (رمز الحالة، الحقل المفقود، القيمة الخاطئة)، يحاول الإصلاح، ويعيد التشغيل. يصبح اختبار API جزءًا من نفس حلقة التحرير-الاختبار-الإصلاح التي يشغل OpenClaw من خلالها اختبارات الوحدة الخاصة بك بالفعل. لقد كتبت تعليمات واحدة وقام الوكيل بدمج الأمر في طريقة عمله بالفعل.
هذا هو نموذج التفويض ثم التحقق الذي يجعل أي سير عمل للوكيل آمنًا. يشغل OpenClaw الأمر ويقرأ النتيجة؛ تستمر أنت في تأليف السيناريوهات بصريًا في Apidog وتتحقق بشكل فوري من أن الوكيل يقرأ رموز الخروج بصدق. للنمط الأوسع، راجع كيفية استخدام وكلاء الذكاء الاصطناعي لاختبار API و أداة اختبار Apidog AI.
تحقق من أن OpenClaw يشغل CLI بالفعل
تبلغ الوكلاء عن نجاح لم يحققوه، وOpenClaw ليس استثناءً. ثلاث عمليات تحقق، حسب تكرار اكتشافها للمشاكل.
أولاً، تأكد من تشغيل الأمر على الإطلاق. يعرض سجل OpenClaw أوامر exec التي نفذها ومخرجاتها. ابحث عن السطر الحرفي apidog run ... ونتيجة تحته. إذا قال OpenClaw إنه قام بتشغيل الاختبارات ولكنك لم ترَ الأمر، فقد لخص شيئًا لم يفعله أبدًا. اطلب منه التشغيل مرة أخرى وإظهار المخرجات الخام.
ثانيًا، تأكد من رمز الخروج، وهو الرمز المهم. اسأله مباشرة:
ما هو رمز الخروج لأمر apidog run هذا؟
يخرج apidog run بالرمز 0 عندما تنجح جميع التأكيدات، وبقيمة غير صفرية عندما يفشل أي شيء. يتيح هذا السلوك البسيط لـ OpenClaw، أو مسار العمل، معالجة التشغيل كبوابة نظيفة. عندما يقول النص "تم اجتياز الاختبارات" ولكن رمز الخروج غير صفري، فإن رمز الخروج هو الصحيح.
ثالثًا، تأكد من أنه استخدم السيناريو الحقيقي. إذا فشل التشغيل بعبارة "لم يتم العثور على السيناريو"، فقد يكون OpenClaw قد اخترع أو أخطأ في تذكر المعرف. أعد التحقق من قيم -t و -e مقابل AGENTS.md والأمر الذي أنشأه Apidog في علامة تبويب CI/CD. المعرفات في AGENTS.md هي الحقيقة.
اختياري: قم بتوصيل خادم Apidog MCP
تشغيل apidog run من خلال أداة exec يغطي معظم ما تحتاجه. ولكن هناك مسار واحد يذهب أبعد من ذلك: بروتوكول سياق النموذج (Model Context Protocol).
يدعم OpenClaw خوادم MCP. يمكنك إضافة واحد باستخدام openclaw mcp add، والذي يكتب تعريف الخادم في ~/.openclaw/openclaw.json تحت mcp.servers ويقبل علامات stdio مثل --command و --arg (راجع وثائق MCP الخاصة بـ OpenClaw). يكشف خادم Apidog MCP مواصفات API الخاصة بك عبر MCP، بحيث يمكن لـ OpenClaw قراءة مخططك أثناء كتابة الكود، وليس فقط بعد الواقع. تقسيم العمل واضح: CLI يشغل الاختبارات، وMCP يغذي الوكيل بالمواصفات.
عندما يخطئ OpenClaw
تظهر بعض الأخطاء بشكل متكرر أثناء الإعداد.
يتجاهل كتلة AGENTS.md. إذا كان OpenClaw يشغل أمرًا عامًا أو لا يشغل أي شيء على الإطلاق، فقد لا يتم تحميل الملف في السياق. تأكد من أن الكتلة موجودة في ملف AGENTS.md الذي ينتمي إلى مساحة عمل الوكيل النشطة، وتذكر أن OpenClaw يتصفح ملفات AGENTS.md ذات النطاق حسب الدليل، لذلك يتم تخطي القاعدة المدفونة في الشجرة الفرعية الخاطئة. إعادة تشغيل الجلسة تفرض قراءة جديدة.
لا يشغل أي شيء لأن التنفيذ محظور. نظرًا لتشديد سياسة OpenClaw الافتراضية، يمكن رفض التنفيذ أو الاحتفاظ به خلف قائمة بيضاء. إذا تم تخطي apidog run بصمت، فتحقق من وضع الصلاحيات الخاص بك تحت tools.exec وقم بالتبديل إلى auto أو أضف apidog إلى القائمة البيضاء. راجع دليل تثبيت OpenClaw الآمن لمعرفة كيفية فتح هذا الأمر فقط دون فتح كل شيء.
يمرر رمز وصول على أي حال. إذا حاول OpenClaw إضافة --access-token، فإنه يخمن من الأمثلة العامة. تخبره الكتلة بالفعل بعدم القيام بذلك، نظرًا لأن الجهاز مصادق عليه عبر apidog login. عزز هذا السطر، ولا تضع أبدًا رمزًا حقيقيًا في AGENTS.md؛ للنمط الصحيح، راجع مصادقة Apidog CLI.
يخترع علامة. يعني خطأ "خيار غير معروف" أن OpenClaw خمّن علامة لا يمتلكها إصدارك. اطلب منه تشغيل apidog run --help وانسخ العلامة الدقيقة من هناك، والتي تكون دائمًا صحيحة لإصدارك المثبت.
يبلغ عن نجاح في تشغيل فاشل. هذا هو الأغلى، والسبب في وجود قاعدة رمز الخروج في AGENTS.md الخاص بك وفي خطوة التحقق الخاصة بك. عندما يتعارض الملخص ورمز الخروج، يفوز رمز الخروج. إذا كنت قد استخدمت وكيلًا آخر لهذا الغرض، فإن نفس القاعدة تنطبق؛ يعكس النهج ما نغطيه في Apidog CLI في Codex والاختلافات في Claude Code vs OpenClaw.
من وكيل يومي إلى حلقة اختبارية
هذا هو الإعداد. قم بتثبيت apidog-cli مرة واحدة باتباع دليل التثبيت، أضف كتلة Apidog قصيرة إلى ملف AGENTS.md في مساحة عملك، اضبط وضع صلاحية exec بحيث يمكن تشغيل الأمر، وسيعرف OpenClaw كيفية تشغيل اختبارات API الخاصة بك وقراءة النتيجة داخل نفس الحلقة التي يستخدمها بالفعل لتحرير الكود. يتم اكتشاف نقطة نهاية معطلة بينما لا يزال OpenClaw يعمل على التغيير، وليس بعد شحنه.
يعمل الاختبار الموجود خلف واجهة مستخدم رسومية عندما ينقر إنسان؛ بينما يعمل أمر من سطر واحد كلما قرر OpenClaw ذلك. تستمر أنت في بناء السيناريوهات بصريًا في Apidog، ويشغلها وكيلك حيث لا تشاهد. قم بتنزيل Apidog، ابنِ سيناريو واحدًا، أسقط أمر apidog run الخاص به في AGENTS.md، وشاهد OpenClaw يكتشفه عند التغيير التالي. عندما تريد نفس البوابة في مسار عمل بدون وجود الوكيل، يغطي Apidog CLI في GitHub Actions الأسرار، والمُبلِّغين، وبوابة رمز الخروج.