ایجاد Skills

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

نخستین مهارت خود را بسازید

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

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# skill name is still "hello-world", invoked as /hello-world

---name: hello-worlddescription: A simple skill that prints a greeting.--- # Hello World When the user asks for a greeting, use the `exec` tool to run: ```bashecho "Hello from your custom skill!"

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

# From chat — archive current session and start fresh/new # Or restart the gatewayopenclaw gateway restart

openclaw agent --message "give me a greeting"

مرجع SKILL.md

فیلدهای الزامی

کلیدهای اختیاری frontmatter

برای فیلدهای دروازه‌گذاری (requires.bins، requires.env و غیره) به Skills — دروازه‌گذاری مراجعه کنید.

استفاده از {baseDir}

برای ارجاع به فایل‌های داخل دایرکتوری مهارت بدون hardcode کردن مسیرها، از {baseDir} در بدنه مهارت استفاده کنید:

Run the helper script at `{baseDir}/scripts/run.sh`.

افزودن فعال‌سازی شرطی

مهارت خود را دروازه‌گذاری کنید تا فقط وقتی وابستگی‌هایش در دسترس هستند بارگذاری شود:

---name: gemini-searchdescription: Search using 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

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

# Propose a brand-new skillopenclaw skills workshop propose-create \  --name "hello-world" \  --description "A simple skill that prints a greeting." \  --proposal ./PROPOSAL.md # Propose an update to an existing skillopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Updated greeting skill"

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

openclaw skills workshop propose-create \  --name "hello-world" \  --description "A simple skill that prints a greeting." \  --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

openclaw skills install @openclaw/clawhub-publish

clawhub publish

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

مرتبط