اجعل Claw يكتب الكود: exec والتصحيحات والموافقات
💡 الخلاصة في سطر واحد: كتابة الكود باستخدام OpenClaw لبناء سير عمل برمجة محلي يقوم على «أوامر قابلة للتنفيذ، وتصحيحات قابلة للمراجعة، وموافقة بشرية قبل التنفيذ» — exec لتشغيل الأوامر، وapply_patch لإنتاج التصحيحات، وسياسة الموافقات لحراسة الحدود.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- اجعل Claw ينفّذ فعليًا في مساحة عملك أوامر مثل
npm testويفهم أسباب الفشل. - اجعل Claw يستخدم
apply_patchلتعديل عدة ملفات وعدة مقاطع برمجية دفعة واحدة، مع إنتاج تصحيح مهيكل. - اضبط
tools.exec.modeسياسة الموافقات بحيث لا تُنفَّذ الأوامر عالية الخطورة إلا بعد تأكيدها واحدًا تلو الآخر. - فعّل Code Mode عند الحاجة ليكتب النموذج برامج JavaScript قصيرة للبحث عن الأدوات واستدعائها.
لماذا OpenClaw وليس ذكاءً اصطناعيًا عبر الويب؟
| القدرة | ذكاء الويب | OpenClaw |
|---|---|---|
| تنفيذ الأوامر | ❌ يقدم اقتراحات فقط وأنت تنسخ وتلصق بنفسك | ✅ exec ينفّذ ضمن الحدود المسموح بها في نظام ملفات المضيف أو الصندوق الرملي المختار |
| تعديلات متعددة الملفات | ❌ لصق ملف واحد في كل مرة مع احتمال إغفال شيء | ✅ apply_patch تصحيح واحد يجمع الإضافة والتعديل والنقل والحذف |
| الحماية الأمنية | ❌ لا توجد سياسة محلية أصلاً | ✅ ثلاث طبقات: policy + قائمة السماح + موافقة المستخدم الاختيارية |
| الاستضافة الذاتية | ❌ يجب رفع الكود إلى خوادم الآخرين | ✅ يعمل Gateway على جهازك وتبقى الأوامر في مساحة العمل المحلية |
معضلتك الحالية
- في كل مرة تطلب من الذكاء الاصطناعي تعديل الكود، تتكرر دورة «لصق الكود → نسخه إلى المحرر → تشغيل الاختبارات يدويًا» بنقل متواصل ذهابًا وإيابًا.
- التعديلات التي يقترحها الذكاء الاصطناعي موزعة على عدة مقاطع حوارية، ولا تدري أي الملفات عدّلها بالضبط.
- تريد أن يشغّل الذكاء الاصطناعي الأوامر مباشرة، لكنك تخشى أن ينفّذ ما لا ينبغي تنفيذه.
متى تستخدم هذه الطريقة
- إصلاح خطأ (bug) يتطلب تعديل الكود المصدري وإضافة اختبارات وتشغيل التحقق في آن واحد.
- إعادة هيكلة تشمل نقل أو إعادة تسمية ملفات متعددة.
- تريد أن يحدث «تشغيل الأوامر» و«تعديل الملفات» على جهازك، وأن تكون كل خطوة قابلة للمراجعة.
🎒 التحضير قبل البدء
- يعمل Gateway على جهازك بالفعل، ومزوّد النموذج متصل (Node 24.16.0+ أو 26.1.0+).
- حدّد بوضوح حدود مساحة العمل: ينفّذ
execضمن النطاق المسموح به في نظام ملفات المضيف أو الصندوق الرملي المختار، ويمكن للأوامر إنشاء الملفات وتعديلها وحذفها. - حدّد معايير الموافقة: ترتبط موافقات OpenClaw 2.0 بطلب وأمر وجلسة وشخص محددين؛ فما يُوافق عليه هو «هذا الأمر بعينه هذه المرة»، وليس منحًا عامًا للأداة بأكملها.
اتبع خطواتي
الخطوة 1: تنفيذ الأوامر باستخدام exec
لماذا: اجعل Claw قادرًا على تشغيل الأوامر أولًا، حتى تكون لديه أسس لتعديل الكود والتحقق لاحقًا.
قل لـ Claw مباشرة:
نفّذ npm test في مساحة العمل، ورتّب لي أسماء الاختبارات الفاشلة ورسائل الأخطاء.ينبغي أن ترى: تعيد الأوامر الأمامية مخرجاتها مباشرة عند اكتمالها. فقط عندما يخبرك exec بأن الأمر ما زال يعمل ويعطيك sessionId، استخدم process لتولي الأمر — فالمعرّف الذي يطبعه الأمر نفسه ليس سوى مخرجات عادية وليس مقبض عملية. عند فشل الأمر، يحمل حقل message تشخيصًا موجزًا، منفصلًا عن مخرجات الأمر الموجودة في aggregated.
الخطوة 2: توليد التصحيحات وتطبيقها
لماذا: التصحيح المهيكل أكثر تركيزًا وقابلية للمراجعة من «إعادة كتابة الملفات بدمج النصوص»، ويغطي عدة ملفات دفعة واحدة.
قل لـ Claw:
استخدم apply_patch لإصلاح الاختبار الفاشل للتو: غيّر قيمة foo في src/index.ts من 1 إلى 2،
وأضف تأكيدًا (assertion) في tests/foo.test.ts.ينبغي أن ترى: يستدعي Claw apply_patch، وهو يقبل وسيطًا واحدًا إلزاميًا هو input، وبتنسيق التصحيح التالي:
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Update File: src/old-name.ts
*** Move to: src/new-name.ts
*** End of File
*** Delete File: obsolete.txt
*** End Patchيكون استدعاء JSON المقابل بالشكل التالي:
{
"tool": "apply_patch",
"input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}*** Move to: يُكتب في السطر التالي لرأس *** Update File: المقابل؛ و*** End of File يشير إلى أن هذا الـ hunk يمتد حتى نهاية الملف. تدعم مسارات الرقعة المسارات النسبية (بالنسبة إلى دليل مساحة العمل) والمسارات المطلقة.
::: نصيحة 💡 هذه هي القيمة الفريدة لـ OpenClaw apply_patch هو أداة فرعية من exec ومُفعّلة افتراضيًا. قيمة tools.exec.applyPatch.workspaceOnly الافتراضية هي false، ويمكن ضبطها على true لحصر الرقع داخل مساحة العمل؛ ويمكن أيضًا استخدام tools.exec.applyPatch.allowModels لتحديد النماذج التي يمكنها استخدامها. ملاحظة: ضبط tools.exec.mode على "full" لا يرفع حد مساحة العمل هذا. :::
الخطوة 3: التنفيذ بعد الموافقة
لماذا: الأمر على وشك تعديل جهازك فعلاً، وهذه الخطوة يراقبها الإنسان.
الأوامر عالية الخطورة تمر عبر الموافقة قبل التنفيذ: موافقة exec تتكون من ثلاث طبقات هي policy + allowlist + موافقة المستخدم (اختيارية)، ولا يعمل الأمر إلا بموافقة الثلاثة جميعًا. أما كتابة الرقع فلا تمر عبر لوحة الموافقة هذه، بل تخضع لسياسة الأدوات وworkspaceOnly ووضع صلاحيات الجلسة (full يرفع القيود، guarded/workspace يشدد، read-only يحجب هذه الأداة تمامًا).
ينبغي أن ترى: اختيار Allow Once في لوحة الموافقة (أو الضغط على Command-Return) يمنح التفويض لهذا التنفيذ فقط؛ أما Always Allow Here فيظهر فقط عندما تسمح السياسة بالموافقات الدائمة، وتأكيده يحفظها كقاعدة سماح دائمة مرتبطة بوسائط الأمر الدقيقة ودليل العمل وقت الموافقة.
الخطوة 4: ضبط سياسة الموافقة
لماذا: السياسة الافتراضية قد لا تناسب معاييرك، فثبّتها عبر حقول الإعداد.
استخدم tools.exec.mode في الإعداد لتحديد السياسة الرئيسية:
| القيمة | السلوك |
|---|---|
deny | منع host exec |
allowlist | تشغيل الأوامر المدرجة في allowlist فقط دون سؤال |
ask | سياسة allowlist + السؤال عند عدم التطابق |
auto | التطابق يعمل مباشرة؛ غير المتطابق يمكن allow (مرة واحدة) أو deny (يُعاد السبب إلى الوكيل) أو ask (موافقة بشرية) |
full | لا يمر عبر مطالبات السياسة الاعتيادية |
الحقول المرافقة: exec.ask (off/on-miss/always، الافتراضي off)، askFallback (خيار احتياطي عند عدم توفر UI أو عند انتهاء المهلة، الافتراضي deny)، tools.exec.strictInlineEval (يصنّف أشكال التقييم المضمّن مثل python -c وnode -e كتتطلب موافقة)، tools.exec.commandHighlighting (يؤثر فقط على التمييز في لوحة الموافقة).
ينبغي أن ترى: بعد تعديل الإعداد، تأخذ السياسة الفعالة الأكثر تشددًا بين tools.exec.* والقيمة الافتراضية لـ approvals — فـ approvals تشدد فقط ولا تخفف السياسة المستنتجة من الإعداد.
الخطوة 5: تفعيل Code Mode عند الحاجة
لماذا: كلما زادت الأدوات زادت مخططات (schema) التي يواجهها النموذج؛ Code Mode يجعله يكتب برامج JavaScript قصيرة للبحث في كتالوج الأدوات ووصفها واستدعائها.
طريقة التفعيل: tools.codeMode يأخذ وضع "auto" افتراضيًا ويسري فقط على النماذج الموسومة كمفضلة لـ Code Mode؛ اختر الإعداد العام في Settings → Agents & Tools → Labs → Code Mode، ويمكن أيضًا التفعيل عبر ثلاث طبقات: global / agent / model.
ينبغي أن ترى: بعد التفعيل يرى النموذج عددًا قليلًا من الأدوات مثل exec وwait، وexec يقبل حمولة JSON هي { code } — لاحظ أن command هنا هو اسم بديل (alias) بلغة JavaScript لـ code وليس أمر shell.
📋 موجه سحري
🔧 شغّل الاختبارات وأصلح
النتيجة المتوقعة: يشغّل Claw الاختبارات أولًا لتحديد مواضع الفشل، ثم يصلح بالرقع، دون المساس بأي مسار خارج مساحة العمل طوال العملية.
الدور: مساعد برمجة محلي
المهمة: شغّل npm test في مساحة العمل، وحدد الاختبارات الفاشلة، وأصلح المصدر أو الاختبارات باستخدام apply_patch
معلومات الإدخال:
### عناصر مطلوبة ###
【رسالة خطأ الاختبارات الفاشلة】
### عناصر اختيارية ###
【قائمة الملفات التي يُمنع تعديلها؟】
مواصفات الإخراج: ابدأ بجملة واحدة تشرح سبب الفشل، ثم محتوى الرقعة، وأخيرًا أعد تشغيل الاختبارات وأظهر النتيجة
شروط القيود:
✅ استخدم apply_patch فقط لتعديل الملفات
✅ حافظ على مسارات الرقع داخل 【دليل مساحة العمل】
❌ لا تعد كتابة الملف بأكمله باستخدام exec
❌ لا تعدل أي مسار خارج مساحة العمل🚀 نقل وإعادة هيكلة
النتيجة المتوقعة: رقعة واحدة تُنجز إعادة التسمية وتحديث المراجع.
الدور: مساعد إعادة هيكلة
المهمة: أعد تسمية src/old-name.ts إلى src/new-name.ts وحدّث جميع المراجع
معلومات الإدخال:
### عناصر مطلوبة ###
【مسار الملف القديم】【مسار الملف الجديد】
### عناصر اختيارية ###
【نطاق الأدلة التي تحتاج تحديثًا متزامنًا؟】
مواصفات الإخراج: رقعة apply_patch واحدة، تُنجز إعادة التسمية باستخدام Move to
شروط القيود:
✅ ضع إعادة التسمية وتحديث المراجع في الرقعة نفسها
✅ شغّل عملية بناء واحدة للتحقق بعد التعديل
❌ لا تترك الملف القديم
❌ لا تعدل ملفات غير ذات صلةنقاط تحقق ✅
- هل انتهى الأمر فعلًا؟ الأوامر التي تُنهى بإشارات النظام على مضيف node بلا واجهة تحمل اسم الإشارة في النتيجة؛ طباعة مخرجات قبل الإنهاء لا تعني نجاح الأمر.
- هل تُشغَّل المهمة الطويلة في الخلفية؟ على Linux يمكن للأوامر الخلفية التي يديرها Gateway تفعيل durable execution لتبقى حية بعد إعادة تشغيل Gateway.
- هل الذاكرة كافية؟ على Linux يكون لـ exec الذي يديره Gateway حد ذاكرة افتراضي: يُؤخذ الأصغر بين ربع ذاكرة المضيف (أو قيد cgroup) ونصف الذاكرة المتبقية بعد الذاكرة المقيمة لـ Gateway نفسه، دون أي إعداد.
تنبيهات من المزالق
execواجهة shell قابلة للتغيير: تعطيلwriteوeditوapply_patchلا يجعلexecللقراءة فقط. لا تستخدم «إغلاق الأدوات» كحل احتياطي؛ فعّل sandbox عندما يجب ذلك.- تنفيذ
host=nodeالبعيد يمر عبرsystem.runالمتزامن ولا ينشئ جلسةprocess؛ وعند منعprocess، يعمل exec المحلي بشكل متزامن متجاهلًاyieldMsوbackground، ويُرفض durable execution. tools.fs.workspaceOnlyوtools.exec.applyPatch.workspaceOnlyيتضمن كل منهماapply_patchبشكل مستقل، فحذف أحدهما قد يبقي الآخر ساريًا.
خلاصة هذا الدرس
باستخدام OpenClaw لكتابة الكود، أتممت في هذا الدرس السلسلة الكاملة: exec يشغّل الأوامر في مساحة العمل المحلية ويعيد تشخيص الفشل، وapply_patch يعدل عدة ملفات دفعة واحدة برقع منظمة، وسياسة الموافقات (tools.exec.mode + allowlist + تأكيد المستخدم) تحرس الأوامر عالية الخطورة، بينما يمنح Code Mode النموذج مسار استدعاء أوفر عندما تكثر الأدوات. كتابة الرقع لا تمر عبر لوحة الموافقة بل تُقيد بـ workspaceOnly ووضع صلاحيات الجلسة وحدود sandbox — خطان منفصلان، لا تخلط بينهما.
استعراض الدرس القادم
انتهى تعديل الكود، والخطوة التالية أن يراقب Claw المستودع: مناوبة GitHub: ملخصات PR والمعالجة الآلية للمشكلات. لتشديد صلاحيات الأدوات، اقرأ التقوية الأمنية (2): صلاحيات الأدوات وsandbox؛ ولتشغيل البرمجة بنماذج صينية أوفر، انظر ربط DeepSeek: التطبيق العملي لإعداد نماذج سلسلة V4.