Skills สอน agent ว่าควรใช้เครื่องมืออย่างไรและเมื่อใด skill แต่ละรายการคือไดเรกทอรี ที่มีไฟล์Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md พร้อม YAML frontmatter และคำแนะนำแบบ markdown
สำหรับวิธีโหลดและจัดลำดับความสำคัญของ Skills โปรดดู Skills
สร้าง skill แรกของคุณ
เขียน SKILL.md
สร้าง ใช้รูปแบบ hyphen-case ด้วยตัวอักษรพิมพ์เล็ก ตัวเลข และยัติภังค์สำหรับ
SKILL.md ภายในไดเรกทอรีนั้น frontmatter จะกำหนด metadata
และเนื้อหา markdown จะมีคำแนะนำสำหรับ agentname ของ skill ให้ชื่อโฟลเดอร์และ name ใน frontmatter ตรงกันเพิ่มเครื่องมือ (ไม่บังคับ)
คุณสามารถกำหนด schema ของเครื่องมือแบบกำหนดเองใน frontmatter หรือสั่งให้ agent
ใช้เครื่องมือระบบที่มีอยู่ (เช่น
exec หรือ browser) Skills ยังสามารถ
มากับ plugins พร้อมกับเครื่องมือที่มันจัดทำเอกสารประกอบได้ด้วยข้อมูลอ้างอิง metadata ของ skill
YAML frontmatter รองรับฟิลด์เหล่านี้:| ฟิลด์ | จำเป็น | คำอธิบาย |
|---|---|---|
name | ใช่ | ตัวระบุเฉพาะที่ใช้ตัวอักษรพิมพ์เล็ก ตัวเลข และยัติภังค์ |
description | ใช่ | คำอธิบายหนึ่งบรรทัดที่แสดงให้ agent เห็น |
metadata.openclaw.os | ไม่ | ตัวกรอง OS (["darwin"], ["linux"] ฯลฯ) |
metadata.openclaw.requires.bins | ไม่ | ไบนารีที่จำเป็นต้องมีบน PATH |
metadata.openclaw.requires.config | ไม่ | คีย์ config ที่จำเป็น |
แนวทางปฏิบัติที่ดี
- กระชับ — สั่ง model ว่าต้องทำ อะไร ไม่ใช่ว่าต้องเป็น AI อย่างไร
- ความปลอดภัยมาก่อน — หาก skill ของคุณใช้
execให้แน่ใจว่า prompt ไม่อนุญาตให้มีการแทรกคำสั่งโดยอำเภอใจจากอินพุตที่ไม่น่าเชื่อถือ - ทดสอบในเครื่อง — ใช้
openclaw agent --message "..."เพื่อทดสอบก่อนแชร์ - ใช้ ClawHub — เรียกดูและร่วมเพิ่ม skills ได้ที่ ClawHub
Skills อยู่ที่ไหน
| ตำแหน่ง | ลำดับความสำคัญ | ขอบเขต |
|---|---|---|
\<workspace\>/skills/ | สูงสุด | ต่อ agent |
\<workspace\>/.agents/skills/ | สูง | agent ต่อ workspace |
~/.agents/skills/ | ปานกลาง | โปรไฟล์ agent ที่แชร์ |
~/.openclaw/skills/ | ปานกลาง | แชร์ (agent ทั้งหมด) |
| รวมมาในชุด (มาพร้อมกับ OpenClaw) | ต่ำ | ทั่วทั้งระบบ |
skills.load.extraDirs | ต่ำสุด | โฟลเดอร์ที่แชร์แบบกำหนดเอง |
ที่เกี่ยวข้อง
- ข้อมูลอ้างอิง Skills — กฎการโหลด ลำดับความสำคัญ และการ gating
- config ของ Skills — schema ของ config
skills.* - ClawHub — registry สาธารณะของ skill
- การสร้าง Plugins — plugins สามารถมาพร้อมกับ skills ได้