ایجاد 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: یک Skill ساده که پیام خوشامدگویی چاپ می‌کند.--- # سلام دنیا وقتی کاربر پیام خوشامدگویی می‌خواهد، از ابزار `exec` برای اجرای دستور زیر استفاده کنید: ```bashecho "سلام از Skill سفارشی شما!"

 قواعد نام‌گذاری:- برای `name` از حروف کوچک، ارقام و خط تیره استفاده کنید.- نام دایرکتوری و `name` فرانت‌متر را هم‌خوان نگه دارید.- `description` به عامل و در بخش کشف فرمان‌های اسلش نمایش داده می‌شود —  آن را تک‌خطی و کوتاه‌تر از 160 نویسه نگه دارید.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSLYqNin2LHar9iw2KfYsduMIFNraWxsINix2Kcg2KrYo9uM24zYryDaqdmG24zYryI ```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

روش‌های برتر

مرتبط