مشبك الورق: كيفية إدارة شركة فردية باستخدام هذا الإطار مفتوح المصدر

Paperclip هو إطار عمل مفتوح المصدر لشركة الشخص الواحد يقوم بتنسيق وكلاء الذكاء الاصطناعي كالموظفين: الهياكل التنظيمية، الميزانيات، جدولة نبضات القلب، الموافقات الإدارية، وسجل تدقيق كامل. أمر واحد يشغّله محليًا. وكلاؤك يقومون بالعمل؛ وأنت تدير اجتماع مجلس الإدارة.

لم يعد إدارة شركة الشخص الواحد في عام 2026 يعني القيام بكل شيء بنفسك، بل يعني توجيه فريق من وكلاء الذكاء الاصطناعي الذين يقومون بالعمل بينما تركز أنت على الاستراتيجية. **Paperclip** هو إطار عمل مفتوح المصدر لشركة الشخص الواحد تم بناؤه لتحقيق ذلك. يمنح المؤسسين المنفردين هيكلاً تنظيميًا ونظام ميزانية وطبقة حوكمة ومتتبع مهام لوكلاء الذكاء الاصطناعي الخاصين بهم، كل ذلك في لوحة تحكم واحدة مستضافة ذاتيًا. إذا كنت تستخدم أيضًا **Apidog** لتصميم واختبار واجهات برمجة التطبيقات (APIs) التي يتفاعل معها وكلاؤك وإنشاء نماذج وهمية لها، فإن Paperclip يكمل المجموعة: Apidog يمتلك عقد واجهة برمجة التطبيقات، وPaperclip يمتلك الوكلاء الذين يستدعونها. يرشدك هذا الدليل بالضبط إلى كيفية عمل Paperclip وكيفية دمجه في عملية شركة الشخص الواحد بدءًا من اليوم.

ما هو Paperclip ولماذا يهم إطار عمل شركة الشخص الواحد لمستخدمي Apidog؟

شعار Paperclip يقولها مباشرة: "إذا كان OpenClaw موظفًا، فـ Paperclip هي الشركة."

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

إليك سبب أهمية إطار عمل شركة الشخص الواحد هذا الآن.

معظم المؤسسين المنفردين الذين يستخدمون وكلاء الذكاء الاصطناعي في عام 2026 يديرون الفوضى. عشرون علامة تبويب Claude Code مفتوحة. لا يوجد سجل لأي وكيل قام بلمس أي ملف. لا يوجد سقف للإنفاق على الرموز. لا توجد طريقة لمعرفة ما إذا كان الوكيل قد أنهى المهمة أو هلوس بإكمالها. يحل Paperclip كل هذا من خلال معاملة الوكلاء بنفس الطريقة التي تعامل بها الشركة الحقيقية الموظفين:

• **الهيكل التنظيمي** — للوكلاء أدوار وألقاب ومدير
• **المشكلات / المهام** — يتم تتبع كل قطعة عمل بالحالة والأولوية والمسؤول
• **الأهداف** — تتتبع كل مهمة إلى مهمة الشركة بحيث يعرف الوكلاء دائمًا *السبب*
• **نبضات القلب** — يستيقظ الوكلاء في موعد محدد، يتحققون من صندوق مهامهم، يقومون بالعمل، يبلغون بالنتائج
• **الميزانيات** — حدود الإنفاق الرمزي الشهري لكل وكيل؛ عندما يصلون إلى الحد الأقصى، يتوقفون
• **الحوكمة** — أنت توافق على تعيين الوكلاء والقرارات الاستراتيجية الرئيسية قبل تنفيذها

بالنسبة للفرق التي تستخدم Apidog لتحديد واجهات برمجة التطبيقات التي يستدعيها وكلاؤها وإنشاء نماذج وهمية لها، يضيف Paperclip طبقة التنسيق المفقودة. يخبر Apidog الوكيل *ما هو عقد واجهة برمجة التطبيقات*. يخبر Paperclip الوكيل *ما هي الوظيفة التي يجب القيام بها، ومتى، وكم يُسمح له بالإنفاق*.

لماذا يختار المؤسسون المنفردون إطار عمل شركة الشخص الواحد هذا على نهج Apidog وحده

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

الميزات الأساسية لإطار عمل شركة الشخص الواحد من Paperclip ومكان Apidog فيه

نبضات القلب: حلقة تفعيل الوكيل المتوافقة مع Apidog

نبضة القلب هي الوحدة الأساسية للتنفيذ في Paperclip. في كل نبضة قلب، يقوم الوكيل بما يلي:

1. يستدعي GET /api/agents/me لتأكيد هويته
2. يستدعي GET /api/companies/:id/issues?status=todo,in_progress لقراءة صندوق مهامه
3. يستدعي GET /api/issues/:id للحصول على السياق الكامل بما في ذلك تسلسل الأهداف الأصلية
4. يقوم بالعمل (يكتب التعليمات البرمجية، يستدعي واجهات برمجة التطبيقات، ينشئ المحتوى)
5. يستدعي PATCH /api/issues/:id مع تحديث الحالة وتعليق يشرح ما قام به

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

الهيكل التنظيمي وهرمية الأهداف: Apidog كطبقة واجهة برمجة التطبيقات

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

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

تطبيق الميزانية: إيقاف الإنفاق الجامح في سير عملك مع Apidog

يمتلك كل وكيل في Paperclip حقلاً باسم budgetMonthlyCents. عندما يصل spentMonthlyCents الخاص بالوكيل إلى هذا السقف، يتوقف عن قبول المهام. لا توجد تجاوزات، ولا استثناءات. بالنسبة لشركة الشخص الواحد التي تعمل بكفاءة، هذه هي الميزة التي تجعل البقية ممكنة — يمكنك منح وكيل ميزانية قدرها 20 دولارًا شهريًا وتعرف على وجه اليقين أنه لن يتجاوزها أبدًا.

عندما تقترن هذا بخوادم Apidog الوهمية، يمكنك تشغيل دورة كاملة من عمل الوكلاء مقابل النماذج الوهمية (بتكلفة رمزية صفرية) قبل التحول إلى موفري الذكاء الاصطناعي الحقيقيين. يكون بناء النماذج الأولية مجانيًا؛ ويكون الإنتاج مُدرجًا في الميزانية.

إعداد Paperclip كإطار عمل لشركتك الفردية مع إعداد Apidog {#setup}

تشغيل محلي بدون تهيئة: Apidog يتصل فورًا

تشغيل Paperclip يتم بأمر واحد:

npx paperclipai onboard --yes

يقوم هذا بتهيئة قاعدة بيانات PostgreSQL مدمجة، وينشئ مفتاح تشفير رئيسي، ويطبق جميع ترحيلات قاعدة البيانات، ويبدأ الخادم على http://localhost:3100. لا يتطلب Docker، ولا يحتاج إلى خدمات خارجية.

بمجرد تشغيله، افتح واجهة المستخدم، أنشئ شركة، وحدد هدفك الأول:

"Build the #1 AI-powered API monitoring tool to $1M MRR."

ثم أنشئ وكيلك الأول — على سبيل المثال، وكيل "مهندس خلفية" يستخدم محول claude_local:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

وجّه مهام الوكيل إلى خادم Apidog الوهمي الخاص بك. في وصف المهمة، اشر إلى عنوان URL لمجموعة Apidog بحيث يتوفر للوكيل عقد واجهة برمجة التطبيقات الكامل كسياق.

ربط نماذج Apidog الوهمية بمهام الوكيل

في Paperclip، أوصاف المهام هي markdown غنية بسياق الأجداد الكامل. يمكنك تضمين عنوان URL الأساسي لنموذج Apidog الوهمي مباشرة:

## المهمة: إضافة ترقيم للصفحات إلى نقطة النهاية /users

**قاعدة نموذج Apidog الوهمي:** http://localhost:4523/m1/123456/users
**معايير القبول:**
- نقطة النهاية تقبل معلمات الاستعلام `page` و `limit`
- تُرجع مغلف `{ data: [], total: 0, page: 1 }`
- تغطية اختبار الوحدة للحالات القصوى (page=0, limit>100)

يقرأ الوكيل هذا، يستدعي نموذج Apidog الوهمي للتحقق من شكل الاستجابة الحالي، يكتب التنفيذ، ويبلغ بالنتائج مع تعليق.

تشغيل الوكلاء والمهام ونبضات القلب في إطار عمل شركة الشخص الواحد من Paperclip مع Apidog

إدارة المشكلات عبر خط أنابيب Paperclip Apidog

تمنحك واجهة سطر الأوامر (CLI) الخاصة بـ Paperclip تحكمًا كاملاً في دورة حياة المهمة دون فتح واجهة المستخدم:

# إنشاء مهمة لوكيل لتنفيذ نقطة نهاية جديدة معرفة بواسطة Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "تطبيق نقطة النهاية POST /webhooks وفقًا لمواصفات Apidog" \
  --description "راجع مجموعة Apidog: http://localhost:4523/..."

# التحقق من حالة المهمة
pnpm paperclipai issue list --company-id <id> --status in_progress

# تحرير مهمة إذا علق الوكيل
pnpm paperclipai issue release <issue-id>

يتم تسجيل كل تغيير في الحالة في سجل النشاط غير القابل للتغيير، بحيث تعرف دائمًا بالضبط أي وكيل قام بلمس مهمة وماذا قال.

الحوكمة والموافقات في إطار عمل شركة الشخص الواحد المتكامل مع Apidog

يضع نموذج حوكمة Paperclip دورك في مجلس الإدارة. قبل توظيف أي وكيل أو الموافقة على أي استراتيجية رئيسية، يمكن لـ Paperclip أن يطلب موافقتك الصريحة:

# مراجعة الموافقات المعلقة
pnpm paperclipai approval list --company-id <id>

# الموافقة على تعيين وكيل جديد
pnpm paperclipai approval approve <approval-id> \
  --decision-note "تمت الموافقة. استخدم نموذج Apidog الوهمي لأول دورة."

هذا يمنع إطار عمل شركة الشخص الواحد من أن يصبح كارثة استقلالية. الوكلاء يقترحون؛ وأنت تقرر.

الاختبار، والحوكمة، والتحكم في التكلفة في مجموعة إطار عمل شركة الشخص الواحد Paperclip + Apidog

تشغيل حزمة اختبار الوحدة Paperclip Apidog

يأتي Paperclip مزودًا بحزمة اختبار وحدة كاملة مدعومة بـ Vitest واختبارات شاملة مدعومة بـ Playwright. تشغيلها بسيط ومباشر:

# تشغيل جميع اختبارات الوحدة
pnpm test:run

# تشغيل اختبارات النهاية إلى النهاية
pnpm test:e2e

# فحص الصحة — تحقق من إمكانية الوصول إلى الخادم ونموذج Apidog الوهمي
curl http://localhost:3100/api/health

تغطي حزمة اختبار الوحدة منطق العمل الأساسي: انتقالات حالة المشكلة، وتطبيق الميزانية، ودورة تشغيل نبضات القلب، ومصادقة الوكيل. عند إضافة محول مخصص لربط موفر ذكاء اصطناعي جديد، يؤكد تشغيل حزمة اختبار الوحدة أن سلوك التنسيق الحالي لم يتغير.

في إطار عمل شركة الشخص الواحد، هذا يهم أكثر مما هو عليه في فريق تقليدي. ليس لديك مراجع للتعليمات البرمجية. حزمة اختبار الوحدة واختبارات عقود Apidog الخاصة بك هي شبكة الأمان الخاصة بك.

مكدس الجودة ثلاثي الطبقات: Paperclip + Apidog + اختبارات الوحدة

نمط جودة عملي للمؤسسين المنفردين:

1. **Apidog** يحدد عقد واجهة برمجة التطبيقات ويُجري اختبارات العقود الآلية مع كل دفع
2. تتضمن مشكلات **Paperclip** معايير قبول تشير إلى مواصفات Apidog
3. **اختبارات الوحدة** (Vitest) تتحقق من أن التنفيذ يتطابق مع كليهما

يعني هذا النهج ثلاثي الطبقات أن المؤسس المنفرد يحصل على نفس ضمان الجودة الذي سيحصل عليه فريق من خمسة أشخاص من مراجعة الأقران دون الحاجة إلى الاجتماعات.

الخلاصة

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

بالنسبة للمطورين الذين يستخدمون **Apidog** بالفعل لتصميم واختبار واجهات برمجة التطبيقات، فإن إضافة Paperclip تكمل المجموعة. يتولى Apidog ما تفعله واجهة برمجة التطبيقات. يتولى Paperclip من يستدعيها، ومتى، ولماذا، وبأي تكلفة. معًا، يشكلان إطار عمل لشركة الشخص الواحد جاهزًا للإنتاج من اليوم الأول: خوادم Apidog الوهمية تدعم تطوير الوكلاء، واختبارات عقود Apidog الخاصة بك تتحقق من مخرجات الوكلاء، وتضمن طبقة حوكمة Paperclip عدم اتخاذ أي وكيل إجراءً لم توافق عليه.

**ابدأ:**

• ابدأ محليًا: npx paperclipai onboard --yes
• افتح واجهة المستخدم على http://localhost:3100، أنشئ شركة، وحدد هدفك الأول
• أضف وكيلاً بميزانية قدرها 20 دولارًا شهريًا ووجهه إلى خادم Apidog الوهمي الخاص بك
• قم بتشغيل pnpm test:run للتحقق من اجتياز حزمة اختبار الوحدة قبل أول نبضة قلب إنتاجية
• وافق على المهمة الأولى، راقب عمل الوكيل، راجع سجل التدقيق

شركة الشخص الواحد لم تعد مجرد استعارة. مع Paperclip و Apidog، إنها بنية.

الأسئلة الشائعة

**ما هو Paperclip؟** Paperclip هو إطار عمل مفتوح المصدر لشركة الشخص الواحد — خادم Node.js وواجهة مستخدم React يقوم بتنسيق وكلاء الذكاء الاصطناعي باستخدام الهياكل التنظيمية، والميزانيات، وجدولة نبضات القلب، والحوكمة. إنه لوحة التحكم لتشغيل شركة برمجيات بوكلاء الذكاء الاصطناعي بدلاً من الموظفين البشر.

**كيف يتكامل Paperclip مع Apidog؟** يحدد Apidog عقود واجهة برمجة التطبيقات التي يعمل عليها وكلاؤك. يمكنك تضمين عناوين URL الوهمية لـ Apidog في أوصاف مهام Paperclip، يستدعي الوكلاء تلك النماذج الوهمية أثناء التطوير، وتتحقق اختبارات عقود Apidog من التنفيذ النهائي. يتعامل Paperclip مع التنسيق؛ ويتعامل Apidog مع مواصفات واجهة برمجة التطبيقات.

**هل Paperclip مناسب لشركة شخص واحد حقيقية؟** نعم. الإعداد المحلي بدون تهيئة (npx paperclipai onboard --yes) لا يتطلب أي بنية تحتية. تحد الميزانية من التكاليف المفرطة. يتعامل نظام نبضات القلب مع العمل المتكرر تلقائيًا. يتيح لك تكامل Tailscale إدارة وكلاءك من هاتفك. يتوسع من المحلية إلى السحابة بنفس التهيئة.

**كيف أقوم بتشغيل اختبارات الوحدة؟** قم بتشغيل pnpm test:run لحزمة اختبار الوحدة Vitest، أو pnpm test:e2e لاختبارات النهاية إلى النهاية Playwright. يفحص اختبار الصحة مقابل http://localhost:3100/api/health للتأكد من أن الخادم يعمل بشكل صحيح قبل الاختبار.

**ما هي وكلاء الذكاء الاصطناعي التي يدعمها Paperclip؟** يدعم Paperclip Claude (محليًا وعبر OpenClaw)، وCodex، وCursor، وGemini، وOpenCode، وأي وكيل يستخدم HTTP أو يعمل كعملية محلية. نظام المحولات مفتوح؛ إذا كان وكيلك يمكنه استقبال نبضة قلب، فيمكن توظيفه.

**هل Paperclip مفتوح المصدر؟** نعم. Paperclip مرخص بموجب MIT ويتم صيانته بنشاط على github.com/paperclipai/paperclip. يتم نشر حزمة SDK للمكونات الإضافية، وحزم المحولات، وتعريفات المهارات جميعها كحزم NPM محددة ضمن @paperclipai/*.