المادة 4
تغطي هذه المقالة التنفيذ الفني الكامل لـ SafeClaw — من واجهة تيليجرام وصولاً إلى طبقة API الخاصة بـ Binance.
━━━ نظرة عامة على النظام ━━━
SafeClaw هو نظام متعدد الطبقات:
الطبقة 1 — واجهة المستخدم
API بوت تيليجرام (وضع السحب الطويل)
لا حاجة لويب هوك. يعمل خلف NAT.
يعيد الاتصال تلقائيًا عند انقطاع الشبكة.
الطبقة 2 — بوابة الذكاء الاصطناعي
OpenClaw 2026.3.13
يعمل على AWS EC2 t3.small (أوبونتو 24.04 LTS)
خدمة Systemd — تبدأ تلقائيًا عند الإقلاع، وإعادة التشغيل تلقائيًا عند التعطل
المنفذ 18789 (للعودة فقط، غير مكشوف علنًا)
المستوى 3 — طبقة نموذج الذكاء الاصطناعي
الأساسي: claude-haiku-4.5 عبر openrouter/anthropic/claude-haiku-4.5
البديل 1: claude-sonnet-4-5 (دقة أعلى، تكلفة أعلى)
البديل 2: meta-llama/llama-3.3-70b-instruct:free (نسخة احتياطية مجانية)
التبديل التلقائي يفشل عند حدود المعدّل أو الأخطاء
المستوى 4 — طبقة المهارات (10 مهارات)
كل مهارة هي ملف SKILL.md بصياغات إرشادات بلغة طبيعية.
لا يوجد كود مُجمّع. لا يوجد خط نشر.
إضافة أو تحديث مهارة = تعديل ملف + إعادة تشغيل البوابة.
المستوى 5 — طبقة تكامل واجهة برمجة التطبيقات
6 بيئات Binance + 3 مصادر بيانات خارجية
━━━ طبقة المهارات بالتفصيل ━━━
يعمل نظام مهارات OpenClaw عن طريق حقن محتوى ملف SKILL.md في سياق الوكيل عند تفعيلها بواسطة كلمات مفتاحية أو أوامر ذات صلة.
مهارات SafeClaw الـ 10:
1. api-router
طبقة التوجيه الداخلية. تقرأ نوع حساب المستخدم من الجلسة وتُرجع عنوان URL الأساسي الصحيح والمعلومات اللازمة للاعتماد. يتم استدعاؤه من جميع المهارات التي تحتاج وصولاً إلى Binance API.
2. p2p-safefinder
يستدعي Binance P2P search API مع رؤوس طلب مضغوطة. يطبق نموذج تسجيل. يُرجع قائمة التجار مرتبة حسب التقييم.
3. guardianclaw
يجلب بيانات تيكر حية لآخر 24 ساعة، وعمق دفتر الأوامر، والصفقات الأخيرة. يشغّل استبياناً نفسياً. يحسب درجة أمان مركبة.
4. smartdca
يجلب Fear & Greed Index. يحسب مُضاعِفاً تكيفياً. يستدعي api-router لنقطة النهاية الصحيحة. ينفذ أمر سوق. يسجل إلى سجل تاريخ الجلسة.
5. briefing
يجلب بشكل دفعي 5 تيكرات لأهم الأصول. يجلب أفضل المتحركين. يجلب سعر P2P المحلي. يجلب Fear & Greed. يصيغ ملخصاً سوقياً منظمًا.
6. safeclaw-academy
يوجه إلى وضع العرض أو testnet بناءً على نوع حساب المستخدم. ينفذ أوامر حقيقية على Binance Demo API. يحسب أسعار التصفية. يسجل نقاطاً لقرارات التداول. يربط بموارد Binance Academy.
7. yield-monitor
يستدعي نقاط نهاية Binance Earn API. يقارن المعدلات الحالية بالمعدلات المتاحة. يحسب فرص تحسين العائد.
8. square-content-engine
يجلب عدة تغذيات RSS ومعلومات السوق في وقت واحد. يولد 3 مسودات مع اختلاف ملفات تعريف التحسين. ينشر عبر Binance Square OpenAPI.
9. user-onboarding
معالج من 5 خطوات. يتحقق من مفاتيح API مقابل النهايات الصحيحة. يخزن نوع الحساب والتفضيلات في الجلسة. يتعامل مع حسابات حقيقية وعرضية (demo) وtestnet.
10. profile
يقرأ الإعدادات من الجلسة. يجلب الرصيد الحي من النهاية الصحيحة في Binance. يعرض صفحة ملف شخصي موحدة.
━━━ استخدام Binance API ━━━
يستخدم SafeClaw عدداً أكبر من Binance APIs مقارنة بأي مشروع OpenClaw آخر نعلم به:
واجهات عامة (بدون مصادقة):
• GET /api/v3/ticker/24hr — بيانات السعر والحجم
• GET /api/v3/ticker/price — السعر الحالي
• GET /api/v3/depth — دفتر الأوامر
• GET /api/v3/trades — الصفقات الأخيرة
• POST p2p.binance.com/.../adv/search — قائمة تجار P2P
واجهات مصادق عليها (مفتاح المستخدم الخاص):
• GET /api/v3/account — التحقق من الرصيد والأذونات
• POST /api/v3/order — تنفيذ أمر تداول فوري (spot)
• POST /fapi/v1/leverage — إعداد الرافعة للعقود الآجلة
• POST /fapi/v1/order — أمر سوق للعقود الآجلة
• GET /fapi/v2/account — رصيد العقود الآجلة
• GET /fapi/v2/positionRisk — مراكز العقود الآجلة المفتوحة
• GET /sapi/v1/lending/union/account — نظرة عامة على Earn
• GET /sapi/v1/lending/daily/product/list — معدلات Earn
• GET /sapi/v1/staking/position — مراكز Staking
Binance Demo APIs:
• demo-api.binance.com — مطابق لواجهة spot المباشرة
• demo-fapi.binance.com — مطابق لواجهة futures المباشرة
Binance Square API:
• POST /bapi/composite/v1/public/pgc/openApi/content/add
توقيع الطلب: HMAC SHA256 مع timestamp + سلسلة المعاملات.
كل الطلبات الموقعة تستخدم مفتاح API الخاص بالمستخدم — وليس أبداً مفتاحاً مشتركاً للخادم.
━━━ البنية التحتية ━━━
الخادم: AWS EC2 t3.small
• وحدات vCPU: 2
• الذاكرة RAM: 2GB + 2GB swap
• التخزين: 30GB gp3 EBS
• نظام التشغيل: Ubuntu 24.04 LTS
• التكلفة: حوالي 15$ شهرياً (مؤهل للشريحة المجانية لمدة 12 شهراً)
وقت التشغيل: Node.js 22.22.1 (حزمة نظام، وليس nvm)
الحزمة: تم تثبيت OpenClaw عبر npm global
الخدمة: خدمة systemd user مع تفعيل lingering
المراقبة: حالة بوابة openclaw + سجلات openclaw
GitHub: https://github.com/bnbnepalbinanceangel/SafeClaw
قالب الإعدادات: config.template.json (بدون أسرار)
المهارات: مجلد skills/ (10 ملفات SKILL.md)
مساحة العمل: workspace/ (SOUL.md, AGENTS.md, IDENTITY.md)
━━━ بنية النشر ━━━
التطوير المحلي:
WSL2 Ubuntu على Windows 11
تثبيت OpenClaw أصلي (وليس Docker)
روبوت اختبار محلي برمز (token) منفصل
Binance Testnet لاختبار التداول بأمان
الإنتاج:
AWS EC2 t3.small يعمل دائماً (always-on)
رمز روبوت الإنتاج (token)
Binance Demo API لميزة الأكاديمية
Binance API الحقيقي للمستخدمين المباشرين
خط النشر:
git push → SSH إلى الخادم → git pull → cp skills → إعادة تشغيل البوابة
(سكريبت تحديث آلي: ~/update-safeclaw.sh)
━━━ كفاءة التكلفة ━━━
استدلال الذكاء الاصطناعي: Claude Haiku 4.5 ≈ 0.001$ لكل رسالة
الخادم: حوالي 15$ شهرياً لـ AWS EC2 t3.small
OpenRouter: الدفع حسب الاستخدام، بدون حد أدنى
الإجمالي لـ 1,000 مستخدم يومياً: حوالي 16$ شهرياً
هذا يجعل SafeClaw واحداً من أكثر روبوتات الذكاء الاصطناعي كفاءة من ناحية التكلفة على بنية Binance.
━━━ مسار قابلية التوسع ━━━
البنية الحالية تدعم مئات المستخدمين المتزامنين على t3.small.
مسار التوسّع الأفقي:
→ t3.small → t3.medium → t3.large (عمودي، بسيط)
→ عدة مثيلات OpenClaw خلف موازن تحميل (أفقي)
→ مخزن جلسات Redis للحالة المشتركة (متعدد المثيلات)
→ عقد عمل منفصلة للـ subagents الثقيلة (SmartDCA، Academy)
الاستدعاء الأصلي متعدد الوكلاء في OpenClaw (sessions_spawn) مُهيأ مسبقاً لتزامن subagent حتى 8 وكلاء بالتوازي لكل منسق رئيسي.
روابط سريعة:
المقال 1 المقال 2 المقال 3 المقال 5 المقال 6 المقال 7 المقال 8
المصدر: https://github.com/bnbnepalbinanceangel/SafeClaw
#AIBinance #SafeClaw #TechStack #OpenClaw #Binance