--- name: paperclip description: Document Management System (DMS) لإدارة وتنظيم الوثائق الهندسية والإدارية. يستخدم OCR للعربية + Voyage embeddings + LanceDB للبحث الدلالي + R2 للتخزين. يُستخدم عند إدارة الوثائق (PDFs, scans, contracts, method statements, drawings, invoices)، البحث الذكي بالعربية والإنجليزية، التصنيف التلقائي، وربط الوثائق بالمشاريع. يدعم: ingest, search, list, view, tag, classify, export. license: MIT ---

Paperclip — Document Management for OpenClaw

نظام إدارة وثائق متكامل يعمل داخل OpenClaw بدون Docker. مبني على:

• R2 للتخزين الدائم للملفات الأصلية (mounted at: kiloclaw/paperclip/)
• LanceDB محلي للـ embeddings + metadata + full-text search
• Voyage-3 للـ semantic embeddings (1024-dim, عربي ممتاز)
• Tesseract + Mathpix + PyMuPDF لاستخراج النص
• Mistral / Claude للتصنيف الذكي وفهم نوع الوثيقة

When to Use

• ✅ رفع وثيقة (PDF, image, scan) للأرشيف
• ✅ البحث في آلاف الوثائق بسؤال طبيعي بالعربي/الإنجليزي
• ✅ تصنيف وثائق KCPC تلقائياً (عقد، method statement, مخطط, RFI)
• ✅ ربط وثائق بمشروع معيّن
• ✅ استخراج معلومات محددة من وثيقة (تاريخ انتهاء، قيمة عقد)
• ✅ مزامنة من OneDrive

Commands

paperclip ingest <file> [--tag <tag>] [--type <type>] [--project <name>]

رفع وثيقة. يقوم تلقائياً بـ: 1. حساب SHA256 + التحقق من التكرار 2. استخراج النص (PDF: pdftotext, Image: Tesseract+Mathpix) 3. تصنيف ذكي عبر Mistral 4. توليد embedding عبر Voyage 5. رفع للـ R2 6. حفظ metadata في LanceDB

paperclip search "<query>" [--top <N>] [--type <type>]

بحث دلالي بالـ vector similarity.

paperclip list [--type <type>] [--tag <tag>] [--limit <N>]

قائمة الوثائق مع الـ metadata.

paperclip view <id>

عرض تفاصيل وثيقة + النص + اللينك للتنزيل من R2.

paperclip tag <id> <tag> / paperclip untag <id> <tag>

إدارة الـ tags.

paperclip stats

إحصائيات: عدد الوثائق، الأنواع، المساحة.

paperclip export [--format json|csv]

تصدير قاعدة البيانات.

Document Types (Auto-classified)

• method_statement — وثائق منهجية البناء
• contract — عقود
• invoice — فواتير
• drawing — مخططات هندسية
• rfi — طلبات معلومات
• submittal — تقديمات
• report — تقارير
• correspondence — مراسلات
• specification — مواصفات فنية
• permit — تصاريح
• other

Configuration

البيئة تأخذ من /data/.openclaw/secrets/env.sh:

• VOYAGE_API_KEY (للـ embeddings)
• MISTRAL_API_KEY (للتصنيف)
• R2_* keys (للتخزين)
• MATHPIX_APP_ID/KEY (اختياري للـ OCR الرياضي)

التخزين المحلي:

• LanceDB: /data/.openclaw/workspace/paperclip/db/
• R2 prefix: kiloclaw/paperclip/<sha>/<filename>

Quick Start

bash
cd /data/.openclaw/workspace/skills/paperclip
Initialize DB (one time)
python3 paperclip.py init
Ingest a document
python3 paperclip.py ingest /path/to/contract.pdf --tag KCPC --project "Hawally Tower"
Search semantically (Arabic or English)
python3 paperclip.py search "بنود التأخير في العقد"
python3 paperclip.py search "concrete pouring procedure"
List all
python3 paperclip.py list --limit 20
View one
python3 paperclip.py view <doc-id>