دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

كيفاش تثبّت وتستعمل مهارات وكيل genspark-claw مع OpenClaw وHermes وClaude Code وCursor

تعلّم كيفاش تثبّت genspark-claw، تفحص المهارات المدمجة معاه، تنشرها فبيئات تشغيل الوكلاء المتوافقة، تستعمل خادم MCP، تتحقق من المهارات المخصصة، وتخدم مع المشروع برمجياً.

حوالي 17 دقايق ديال القراية
كيفاش تثبّت وتستعمل مهارات genspark-claw مع OpenClaw وHermes وClaude Code وCursor

شنو هو genspark-claw؟

genspark-claw هو حزمة مهارات وواجهة سطر الأوامر مبنيين من طرف المجتمع على حساب Genspark Claw وOpenClaw وHermes وClaude Code وCursor. كيوفّر خمسة ديال المسارات القابلة للقراية فـ SKILL.md، اللي كيزيدو إمكانيات عملية للوكلاء المتوافقين مع الذكاء الاصطناعي بلا ما يحتاجو تبعيات وقت التشغيل ولا مرحلة بناء.

المشروع مستقل وما عندوش علاقة رسمية بـ Genspark ولا OpenClaw ولا Nous Research. وحيت المهارات غير ملفات Markdown عادية فيها YAML frontmatter، تقدر تفحصها وتتحقق منها وتبدلها وتثبتها فبيئات التشغيل المدعومة.

الخصائص الرئيسية

  • خمسة ديال المهارات واجدين للإنتاج: البحث المعمق، إنشاء التقارير، تخطيط العروض، أتمتة المتصفح، والتحضير للمكالمات الهاتفية.
  • التوافق مع بيئات تشغيل مختلفة: ثبت نفس المهارات فـ OpenClaw أو Hermes أو Claude Code أو Cursor أو مساحة عمل محلية.
  • بلا تبعيات وقت التشغيل: الواجهة كتستعمل المكتبة القياسية ديال Node.js وكتحتاج Node.js 18 ولا أحدث.
  • التحقق الأمني: أداة التحقق كتراجع بنية المهارات وكتنبه لأنماط بحال التنفيذ عن بُعد عبر pipe، وحمولات base64، والأوامر التخريبية.
  • دعم MCP: خَلّي حزمة المهارات متاحة لعملاء MCP بحال Claude Desktop وCursor وWindsurf.
  • الاختبارات وCI: المشروع فيه اختبارات آلية وتغطية CI لـ Node.js 18 و20 و22 على Ubuntu وmacOS وWindows.

فهم المهارات المضمنة

الحزمة فيها خمسة ديال المهارات، وكل وحدة مخزنة فمجلد خاص بها وفيه ملف SKILL.md.

  • super-research: كيفكك السؤال، كيدير عمليات بحث متوازية، كيتحقق من الادعاءات بمقارنتها مع مصادر مستقلة، وكيخرج تقرير موثق بالمراجع.
  • spark-report: كيحوّل البحث ولا الملاحظات ولا المحادثات لتقرير منظم، فيه ملخص تنفيذي، وجداول للمقارنة، ومراجع، والخطوات الجاية.
  • spark-slides: كيحوّل البحث ولا الفكرة لمخطط سردي ديال عرض شرائح، بعناوين مبنية على الادعاءات، وملاحظات المتحدث، والمصادر.
  • claw-browser-anchor: كيخلي أتمتة المتصفح أكثر صموداً باستعمال محددات DOM وأدوار ARIA بلاصت إحداثيات الشاشة الهشة، مع التحقق واسترجاع الانحرافات.
  • call-prep: كيحضّر مكالمة هاتفية بالذكاء الاصطناعي من خلال البحث على الشخص اللي غادي يتصلو به، وتحديد الأهداف والبدائل، وكتابة سيناريو متشعب، وتنظيم ملخص ما بعد المكالمة.

ثبت وجرّب الواجهة

المتطلبات المسبقة

ثبت Node.js 18 ولا أحدث. المشروع كينصح باستعمال تعليمات التحميل الرسمية ديال Node.js. فـ macOS، ثبت أدوات سطر الأوامر ديال Apple قبل:

xcode-select --install

المستخدمين ديال Linux وWindows يقدرو يتجاوزو خطوة أدوات سطر الأوامر ديال macOS. ما كايناش حاجة لاشتراك Genspark، حيت تقدر تستعمل الحزمة مع OpenClaw ولا Hermes ولا Claude Code ولا Cursor مستضافين ذاتياً.

التثبيت من GitHub

صايب مجلد للخدمة، ثبت المستودع مباشرة من GitHub، وشغّل فحص السلامة:

mkdir -p 'gensparkclaw' && cd 'gensparkclaw'
npm install github:breakstageaxe61/genspark-claw
npx genspark-claw doctor
npx genspark-claw list

الأمر doctor كيراجع البيئة وبيئات التشغيل ديالك. والأمر list كيعرض المهارات الخمسة المضمنة والوصف ديال كل وحدة.

ثبت المهارات فبيئة تشغيل وكيل

OpenClaw ولا Genspark Claw

ثبت جميع المهارات المضمنة فمجلد المهارات الافتراضي ديال OpenClaw:

npx genspark-claw install all --target openclaw

هاد الأمر كينسخ المهارات لـ ~/.openclaw/skills/. إلا كنت كتستعمل بوابة OpenClaw مستضافة ذاتياً، عاود شغّل البوابة ولا بدا جلسة جديدة باش تولي المهارات متاحة. فـ Genspark Claw، استورد ملفات SKILL.md من خلال لوحة المهارات، ولا نسخهم من node_modules/genspark-claw/skills/.

Hermes

ثبت جميع المهارات فـ Hermes بهاد الأمر:

npx genspark-claw install all --target hermes

المكان الافتراضي هو ~/.hermes/skills/.

Claude Code وCursor

استعمل الأهداف الخاصة بكل بيئة تشغيل باش تثبت الملفات فمجلدات المهارات القياسية ديالها:

npx genspark-claw install all --target claude
npx genspark-claw install all --target cursor

هاد الأوامر كتوصل لـ ~/.claude/skills/ و~/.cursor/skills/ بالترتيب.

التثبيت فمساحة عمل ديال مشروع

إلا بغيتي تثبيت محلي داخل المشروع، ثبت مهارة وحدة ولا الحزمة كاملة فمجلد مخصص:

npx genspark-claw install super-research
npx genspark-claw install all --dir ~/my-agent/skills

استعمل --dry-run إلا بغيتي تشوف شنو غادي يدير المثبت بلا ما يكتب الملفات:

npx genspark-claw install all --target openclaw --dry-run

استعمل أوامر الواجهة

الواجهة كتدعم اكتشاف المهارات، والتثبيت، والتحقق، والتشخيص، وتشغيل MCP:

genspark-claw <command> [options]
  • list كيعرض جميع المهارات المضمنة.
  • info <skill> كيعرض التفاصيل والتعليمات الكاملة ديال مهارة.
  • install [skill] كيثبت مهارة وحدة ولا جميع المهارات.
  • validate [path] كيتحقق من ملفات SKILL.md، وبشكل افتراضي كيراجع المهارات المضمنة.
  • doctor كيراجع البيئة المحلية وبيئات التشغيل المكتشفة.
  • runtimes كيعرض بيئات تشغيل الوكلاء المكتشفة.
  • mcp كيشغّل خادم MCP عبر stdio.
  • version كيطبع النسخة المثبتة.

مثلاً، عاين المهارة قبل ما تثبّتها:

npx genspark-claw info super-research

قرا تعليمات المهارة اللّولة كايعتبر ممارسة مفيدة فالأمان والتوافق، خصوصاً ملي كتخدم بمهارات ديال الوكلاء من جهات خارجية.

ربط خادم MCP

genspark-claw فيه خادم Model Context Protocol بلا حتى تبعية. كايعرض ثلاثة ديال الأدوات: list_skills وget_skill وvalidate_skill.

زيد الخادم لإعدادات MCP ديال Claude Desktop باستعمال المسار المطلق ديال الخادم المثبّت:

{
  "mcpServers": {
    "genspark-claw": {
      "command": "node",
      "args": ["/absolute/path/to/gensparkclaw/node_modules/genspark-claw/mcp/mcp-server.js"]
    }
  }
}

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

node node_modules/genspark-claw/mcp/mcp-server.js --test

الاختبار الذاتي ديال MCP داز: initialize وtools/list وtools/call كاملين خدامين مزيان.

تحقّق من المهارات بأمان

دير التحقق على الملفات المرفقة قبل ما تستعملها:

npx genspark-claw validate

وتقدر حتى تتحقق من مجلد مخصّص:

npx genspark-claw validate ./my-skills

أداة التحقق كاتراجع مخطط المهارة المتوقع وكاتدير تدقيق أمني. كاتعلّم على أنماط منها curl | bash، وحمولات base64، والأوامر التخريبية. التحقق كاينقص من المخاطر، ولكن خاصك باقي تقرا SKILL.md كامل وتستعمل أدوات التدقيق أو الطبيب الخاصة بالوكيل ديالك.

صايب مهارة مخصّصة وساهم بها

المهارة المخصّصة هي مجلد فيه ملف SKILL.md. خاص الـ frontmatter يحدّد حقول بحال name وdescription وversion وtriggers وcompatibility وبيانات وصفية JSON فسطّر واحد. خاص متن الوثيقة يكون فيه تعليمات مرقّمة، وقواعد، ومعالجة الأخطاء، وصيغة الإخراج.

  1. صايب مجلداً وملفاً.
  2. تبع البنية ديال المهارة المشروحة فـ دليل المساهمة ديال المستودع.
  3. شغّل npm run validate باش تراجع المخطط وقواعد الأمان.
  4. شغّل npm test باش تنفّذ الحزمة الآلية ديال الاختبارات.
  5. حلّ طلب دمج إلا بغيتي تشارك المهارة.

المستودع كايدعم حتى نشر مهارة متوافقة فـ ClawHub باستعمال clawhub publish. نفس الصيغة البسيطة ديال الملفات مصمّمة باش تخدم مع Hermes وأدوات متوافقة مع agentskills.io.

استعمل الواجهة البرمجية

إلا كنت كاتدمج genspark-claw فشي تطبيق آخر بـ Node.js، حمّل الحزمة وعيّط على الواجهة البرمجية العامة ديالها:

const gclaw = require('genspark-claw');

gclaw.listBundledSkills();
gclaw.findSkill('super-research');
gclaw.installSkills({ skill: 'all', target: 'hermes' });
gclaw.validateTarget('./my-skills/');
gclaw.runDoctor();

الأساليب كاترَجّع سجلات المهارات، أو نتائج التحقق، أو بيانات فحص البيئة اللي تقدر تستعملها فالأدوات ديالك.

طوّر محلياً

باش تخدم على المشروع براسو، نسخ المستودع وشغّل أوامر الاختبار والتحقق ديالو:

git clone https://github.com/breakstageaxe61/genspark-claw.git
cd genspark-claw
npm test
npm run validate
node examples/quickstart.js
node mcp/mcp-server.js --test

ما كايناش حاجة لـ npm install فالتطوير، حيث المشروع مصمّم عمداً بلا تبعيات. من بين المناطق المهمة كاين مدخل CLI فـ bin/، والواجهة البرمجية العامة فـ src/index.js، والمهارات فـ skills/، وخادم MCP فـ mcp/، والاختبارات فـ test/.

الخلاصة

genspark-claw كايقدّم طريقة مباشرة باش تزيد سيرورات عمل قابلة لإعادة الاستعمال وقابلة للمعاينة فعدة بيئات ديال وكلاء الذكاء الاصطناعي. ثبّتو من GitHub، واستعمل doctor وlist باش تتحقق من الإعداد، ونشّر المهارات مع هدف التشغيل، واستعمل validate قبل ما تدخل تعليمات مخصّصة أو جاية من جهات خارجية. وبالنسبة للدمج، خادم MCP المدمج وواجهة Node.js كايخلّيو نفس حزمة المهارات متاحة عبر الأدوات والتطبيقات.