ایجاد Skills

Skills به عامل می‌آموزند چگونه و چه زمانی از ابزارها استفاده کند. هر Skill یک پوشه است که شامل فایل SKILL.md با فرانت‌متر YAML و دستورالعمل‌های Markdown می‌شود. OpenClaw، Skills را از چندین ریشه و طبق یک ترتیب تقدم مشخص بارگیری می‌کند.

نخستین Skill خود را ایجاد کنید

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

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# نام Skill همچنان "hello-world" است و به‌شکل /hello-world فراخوانی می‌شود

---name: hello-worlddescription: یک Skill ساده که پیام خوشامدگویی را چاپ می‌کند.--- # سلام دنیا هنگامی که کاربر پیام خوشامدگویی می‌خواهد، از ابزار `exec` برای اجرای دستور زیر استفاده کنید: ```bashecho "سلام از Skill سفارشی شما!"

 قواعد نام‌گذاری:- برای `name` از حروف کوچک، ارقام و خط تیره استفاده کنید.- نام پوشه و `name` موجود در فرانت‌متر را هماهنگ نگه دارید.- مقدار `description` به عامل و در بخش کشف فرمان‌های اسلش نمایش داده می‌شود —  آن را در یک خط و کمتر از ۱۶۰ نویسه نگه دارید.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSLYqNin2LHar9uM2LHbjCBTa2lsbCDYsdinINio2LHYsdiz24wg2qnZhtuM2K8i ```bashopenclaw skills list

# از داخل گفت‌وگو — نشست فعلی را بایگانی کنید و نشستی تازه آغاز کنید/new # یا Gateway را راه‌اندازی مجدد کنیدopenclaw 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

برای Skills پیش‌نویس‌شده توسط عامل یا زمانی که می‌خواهید پیش از عملیاتی‌شدن یک Skill، اپراتور آن را بررسی کند، به‌جای نوشتن مستقیم SKILL.md از پیشنهادهای کارگاه Skill استفاده کنید.

# پیشنهاد یک Skill کاملاً جدیدopenclaw skills workshop propose-create \  --name "hello-world" \  --description "یک Skill ساده که پیام خوشامدگویی را چاپ می‌کند." \  --proposal ./PROPOSAL.md # پیشنهاد به‌روزرسانی یک Skill موجودopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Skill خوشامدگویی به‌روزشده"

هنگامی که پیشنهاد شامل فایل‌های پشتیبان است، از --proposal-dir استفاده کنید:

openclaw skills workshop propose-create \  --name "hello-world" \  --description "یک Skill ساده که پیام خوشامدگویی را چاپ می‌کند." \  --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 مراجعه کنید.

انتشار در ClawHub

npm i -g clawhubclawhub login

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

بهترین شیوه‌ها

مطالب مرتبط