إنشاء Skills

تُعلِّم Skills الوكيل كيف ومتى يستخدم الأدوات. وكل Skill عبارة عن دليل يحتوي على ملف SKILL.md يتضمن ترويسة YAML أمامية وتعليمات بصيغة Markdown. يحمّل OpenClaw المهارات من عدة جذور وفق ترتيب أسبقية محدد.

أنشئ أول Skill لك

mkdir -p ~/.openclaw/workspace/skills/hello-world

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# يظل اسم Skill هو "hello-world"، ويُستدعى باستخدام /hello-world

---name: hello-worlddescription: مهارة بسيطة تطبع تحية.--- # مرحبًا بالعالم عندما يطلب المستخدم تحية، استخدم أداة `exec` لتشغيل: ```bashecho "مرحبًا من مهارتك المخصصة!"

 قواعد التسمية:- استخدم الأحرف اللاتينية الصغيرة والأرقام والواصلات في `name`.- حافظ على تطابق اسم الدليل مع قيمة `name` في الترويسة الأمامية.- تظهر قيمة `description` للوكيل وفي اكتشاف أوامر الشرطة المائلة؛  اجعلها في سطر واحد وبأقل من 160 محرفًا.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSLYqtit2YLZgiDZhdmGINiq2K3ZhdmK2YQgU2tpbGwi ```bashopenclaw skills list

# من الدردشة — أرشف الجلسة الحالية وابدأ جلسة جديدة/new # أو أعد تشغيل Gatewayopenclaw gateway restart

openclaw agent --message "قدّم لي تحية"

مرجع SKILL.md

الحقول المطلوبة

مفاتيح الترويسة الأمامية الاختيارية

للاطلاع على حقول التقييد (requires.bins وrequires.env وغيرها)، راجع Skills — التقييد.

استخدام {baseDir}

أشِر إلى الملفات داخل دليل Skill من دون ترميز المسارات بصورة ثابتة؛ يحل الوكيل {baseDir} بالاستناد إلى دليل Skill نفسها:

شغّل البرنامج النصي المساعد الموجود في `{baseDir}/scripts/run.sh`.

إضافة التفعيل المشروط

قيّد Skill بحيث لا تُحمّل إلا عند توفر تبعياتها:

---name: gemini-searchdescription: البحث باستخدام Gemini CLI.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---

{  skills: {    entries: {      "gemini-search": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },      },    },  },}

الاقتراح عبر Skill Workshop

بالنسبة إلى Skills التي يصوغها الوكيل، أو عندما تريد مراجعة المشغّل قبل تشغيل Skill فعليًا، استخدم اقتراحات Skill Workshop بدلًا من كتابة SKILL.md مباشرةً.

# اقترح Skill جديدة كليًاopenclaw skills workshop propose-create \  --name "hello-world" \  --description "مهارة بسيطة تطبع تحية." \  --proposal ./PROPOSAL.md # اقترح تحديثًا لـ Skill موجودةopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "مهارة تحية محدّثة"

استخدم --proposal-dir عندما يتضمن الاقتراح ملفات دعم:

openclaw skills workshop propose-create \  --name "hello-world" \  --description "مهارة بسيطة تطبع تحية." \  --proposal-dir ./hello-world-proposal/

يجب أن يحتوي الدليل على PROPOSAL.md في جذره. وتوضع ملفات الدعم ضمن assets/ أو examples/ أو references/ أو scripts/ أو templates/.

بعد المراجعة:

openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

راجع Skill Workshop للاطلاع على دورة حياة الاقتراح كاملةً.

النشر إلى ClawHub

npm i -g clawhubclawhub login

clawhub skill publish ./path/to/hello-world

أفضل الممارسات

ذو صلة