KLIK / 008 / Paperclip
Paperclip: نظم خدمة AI Agents بالأهداف والميزانية، ماشي بوهم شركة كتربح بوحدها
أول استعمال لـ Paperclip: إعداد محلي، Agent واحد، مهام وموافقات وميزانية، مع الفرق بين المنسق وModels اللي كتخدم فعلاً.

عندك Agent كيجمع المصادر، واحد كيكتب، وآخر كيراجع. كل واحد فمحادثة، والملفات بين المجلدات، وماعارفش شكون كيتسنى شكون. زيادة Agent رابع ماشي بالضرورة الحل. يمكن اللي ناقص هو بلاصة فيها الهدف، المسؤول، المهمة، الموافقة والمصاريف باينين مع بعضهم.
Paperclip كيدير هاد الدور: نظام باش تنظم Agents والعمل ديالهم، ماشي Model جديد ولا عامل رقمي كيفهم التجارة بلا توجيه. الواجهة كتستعمل لغة الشركة، الأدوار والميزانية، ولكن إنشاء Company داخل البرنامج ماكيخلقش مشروع تجاري مربح. هاد الدليل مبني على الوثائق المراجعة نهار 25 أكتوبر 2026، ولكن ماجربناش تشغيل شركة مستقلة به.
فرق بين المنسق واللي كينفذ
Paperclip كيخزن الأهداف والمهام، كيربط Agents بـ Adapters، وكيتابع Runs وقرارات ومصاريف. الـ Agent اللي كيدير البحث أو الكود يقدر يكون Claude Code أو Codex أو Runtime آخر مدعوم. الـ Model والاشتراك والصلاحيات ديال هاد Runtime ماكيوليوش مجانيين غير حيث ربطتيهم بلوحة واحدة.
هاد الفصل مهم فالتشخيص. إلا المهمة ماتحركاتش، واش المشكلة فـ Queue؟ Adapter؟ حساب Model؟ Permissions؟ ولا Task مكتوبة بشكل غامض؟ حتى إلا Status باين بالخضر، حل الملف الناتج وقارنو بالمطلوب. إلا شي حاجة ناقصة، رجع للـ Log باش تعرف فين وقفات الخدمة.
قبل التثبيت: شنو باغي تنظم؟
بدا بعملية صغيرة كتعاودها وعارف كيفاش تراجعها. مثلاً تحضير مذكرة داخلية من مصادر رسمية، بلا إرسال ولا نشر. عرف Input، النتيجة المطلوبة وحدود التصرف: لا تعديل Production، لا شراء، لا مراسلة Accounts. كل ربط جديد كيزيد قدرة على الفعل، ماشي غير معلومة فالواجهة.
إلا خدمتك غير سؤال وجواب مع Agent واحد، Paperclip يقدر يزيد إعداد أكثر من الحاجة. القيمة كتبان ملي المهام كتحتاج تتبع، صلاحيات ومراجعة بين مراحل. ماخاصكش تبني Org chart فيه عشرة أدوار قبل ما تعرف واش مهمة واحدة كتخرج مزيانة.
المتطلبات والمسار المحلي
دليل CLI الحالي كيطلب Node.js 24.11.0 أو أحدث. تحذير على Node أقدم ماكيعنيش أنه مدعوم. المسار المحلي المعتاد يقدر يجهز Embedded PostgreSQL، لذلك ماخاصكش تفترض أن سيرفر Database خارجي مطلوب من أول دقيقة. إلا عندك PostgreSQL خاص بك، اتبع الإعداد الموثق وما تخلطش بيانات التجربة مع خدمة حية.
دعم النظام والـ Adapter والـ Runtime خاصو يتراجع مع المسار اللي اخترتي. توفر Node بوحدو ماكيضمنش أن جميع الأدوات المحلية موجودة فكل Windows أو macOS أو Linux. ماكاينش حد RAM ولا GPU واحد لهاد الاختيارات كاملة؛ متطلبات Agent وSandbox وModels المحلية كتزيد على متطلبات المنسق.
- فتح الوثائق الرسمية وقارن إصدار Node المطلوب مع الجهاز.
- استعمل Terminal عادي ومكان تجربة منفصل، وراجع Package اللي غادي يتنزل من npm.
- أمر Quick start الرسمي هو:
npx paperclipai@latest onboard --yes- كمل الإعداد المحلي، واحتافظ بمكان Config وData اللي كيبينو Setup. اختيار
--yesكيسمح بالتأكيدات الافتراضية ديال المسار؛ استعملو غير من بعد قراءة الدليل. - إلا Setup ماطلقش Instance، اتبع خطوة
runالموثقة فدليل CLI، وماتشغلش نسختين على نفس البيانات بالصدفة.
التجربة بـ npx مختلفة على Managed install وخدمة Background. ماخاصكش Service دائمة باش تتأكد من أول Task. إلا بغيتي تخليه خدام باستمرار، دوز لمسار الصيانة الرسمي، وقرا Update وRollback وBackup قبل الانتقال.
أول Company وأول Agent
الدليل الرسمي كيبدا بإنشاء Company، ومن بعد CEO Agent مرتبط بـ Adapter مناسب. الاسم CEO هنا دور تنظيمي؛ ماشي شخص كيتحمل عنك المسؤولية. كتب هدف صغير: «وجد مذكرة من ثلاث مصادر رسمية، كل معلومة معاها الرابط ديال المصدر، بلا نشر.» خليه يقترح خطة، وقراها قبل الموافقة.
ضبط Company budget وPer-agent budget قبل Heartbeats. Heartbeat هي فرصة تشغيل كيراجع فيها Agent العمل الموكول ليه؛ إلا كتخليه يتكرر، ممكن يدير Calls حتى وأنت ماجالسش قدام الجهاز. الميزانية وتوقيف Agents كيساعدو فالتحكم، ولكن راجع كذلك سقوف الفوترة فـ Provider نفسه، ماشي لوحة Paperclip بوحدها.
شغل تجربة محدودة وراقب Runs. شوف واش Task عندها مسؤول وOutput ومراجعة، وواش Agent كيتوقف ملي خاص إذن أو معلومة. إلا بدا كيوسع النطاق، صحح المهمة قبل إضافة زملاء ليه. الغموض اللي فـ Brief كيقدر يتضاعف ملي كيتقسم بين Agents.
كيفاش تكتب Task قابلة للمراجعة؟
بدل «دير Marketing»، كتب شنو خاص يتسلم وفين. فمذكرتنا: لائحة مصادر، ملخص قصير، النقط اللي مازال ما تأكداتش، واسم الملف اللي غادي يحفظ فيه النتيجة. وضح فوقاش تعتبر المهمة سالات، وشنو خاص Agent يرجع يسولك عليه قبل ما يديرو. هاد الوضوح كيسهل تعرف الفرق بين نشاط كاين ونتيجة نافعة.
من بعد ما تمر مهمة وحدة، تقدر تزيد Reviewer بدور محدد: يقارن المعلومات بالمصادر، ومايعطيش الموافقة غير حيث النص مرتب. ماتخليش Reviewer يعاود يبني المشروع أو يبدل الهدف بلا سبب. مشاركة نفس الخطأ بين جوج Agents ماكاتحولوش لحقيقة.
الصلاحيات والبيانات ماشي تفاصيل ثانوية
استعمل مفاتيح وصلاحيات على قد الحاجة. ربط GitHub، Files أو خدمة نشر يقدر يعطي وصول لمعلومات أو أفعال مهمة. راجع شنو كل Agent يقدر يقرا أو يكتب، وفين كاتتم الموافقة. Human approval مفيد غير إلا العملية اللي محتاجة موافقة فعلاً كتوقف قبل التنفيذ.
المشروع كيفرق بين Trusted local وAuthenticated deployment. ماتعرضش Instance محلية على الإنترنت بافتراض أن إعدادها الافتراضي مناسب للعموم. Secrets وLogs والمرفقات والنسخ الاحتياطية كيبقاو مخزنين حتى من بعد ما تسالي المحادثة؛ راجع شكون يقدر يوصل ليهم. README كيذكر Telemetry وإعدادات Opt-out؛ راجعها مع سياسة الفريق بدل افتراض أن Self-hosted كتعني ماكاين حتى اتصال خارجي.
المصاريف والنجاح اللي تقدر تقيس
ملي Task كتبقى كاتدور بلا نتيجة، ماتجاوبش مباشرة بزيادة Budget. شوف آخر Run: واش كيتسنى Approval؟ واش Input ناقصة؟ واش كيعيد نفس الخطأ؟ عطّل التكرار اللي ماعندو حتى فائدة حتى تفهم السبب، وخلي سجل مختصر للي وقع. من بعد صحح شرط البداية أو تعريف Done وجرّب من جديد على نفس المثال المحدود. هاد المراجعة كتخليك تفرق بين مهمة كبيرة فعلاً ومهمة غامضة غير كاتستهلك Calls، قبل ما تنسخ المشكل لباقي الفريق.
Paperclip مرخص بـ MIT، لكن التنفيذ ممكن يجمع Model calls، Agent subscriptions، Sandbox، تخزين واستضافة. راجع Cost events مع Provider billing، خصوصاً ملي Task كتعاود المحاولة. ماكاينش عدد Agents كيضمن الربح، ولا Budget صغير كيصلح بوحدو طريقة خدمة ناقصة.
قيس واش المهمة تسلمات بالدقة اللي طلبتي، واش قدرت تعرف شكون دار شنو، وواش المصاريف معقولة بالنسبة لها. إلا ماقدرتش تجاوب على هاد الأسئلة فمشروع صغير، مازال الوقت بكري للتشغيل المستمر. قبل خدمة حقيقية، استعمل لائحة Deploy للنسخ الاحتياطي، المراقبة والرجوع، وخلي القرار الأخير عند الإنسان.


