Skills
การสร้าง Skills
Skills สอนเอเจนต์ว่าควรใช้เครื่องมืออย่างไรและเมื่อใด แต่ละทักษะคือไดเรกทอรี
ที่มีไฟล์ SKILL.md พร้อม YAML frontmatter และคำแนะนำแบบ markdown
สำหรับวิธีโหลดและจัดลำดับความสำคัญของทักษะ โปรดดู Skills
สร้างทักษะแรกของคุณ
สร้างไดเรกทอรีทักษะ
Skills อยู่ในเวิร์กสเปซของคุณ สร้างโฟลเดอร์ใหม่:
mkdir -p ~/.openclaw/workspace/skills/hello-world
เขียน SKILL.md
สร้าง SKILL.md ภายในไดเรกทอรีนั้น frontmatter กำหนดเมทาดาทา
และเนื้อหา markdown มีคำแนะนำสำหรับเอเจนต์
---
name: hello-world
description: A simple skill that says hello.
---
# Hello World Skill
When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".
ใช้รูปแบบ hyphen-case ด้วยตัวพิมพ์เล็ก ตัวเลข และขีดกลางสำหรับ name
ของทักษะ ให้ชื่อโฟลเดอร์และ name ใน frontmatter ตรงกัน
เพิ่มเครื่องมือ (ไม่บังคับ)
คุณสามารถกำหนดสคีมาของเครื่องมือแบบกำหนดเองใน frontmatter หรือสั่งให้เอเจนต์
ใช้เครื่องมือระบบที่มีอยู่ (เช่น exec หรือ browser) ได้ Skills ยังสามารถ
จัดส่งอยู่ภายใน plugins ควบคู่กับเครื่องมือที่เอกสารนั้นอธิบายได้ด้วย
โหลดทักษะ
เริ่มเซสชันใหม่เพื่อให้ OpenClaw ตรวจพบทักษะ:
# From chat
/new
# Or restart the gateway
openclaw gateway restart
ตรวจสอบว่าโหลดทักษะแล้ว:
openclaw skills list
ทดสอบ
ส่งข้อความที่ควรทริกเกอร์ทักษะ:
openclaw agent --message "give me a greeting"
หรือเพียงแชตกับเอเจนต์และขอคำทักทาย
อ้างอิงเมทาดาทาของทักษะ
YAML frontmatter รองรับฟิลด์เหล่านี้:
| ฟิลด์ | จำเป็น | คำอธิบาย |
|---|---|---|
name |
ใช่ | ตัวระบุไม่ซ้ำที่ใช้ตัวพิมพ์เล็ก ตัวเลข และขีดกลาง |
description |
ใช่ | คำอธิบายบรรทัดเดียวที่แสดงให้เอเจนต์เห็น |
metadata.openclaw.os |
ไม่ | ตัวกรอง OS (["darwin"], ["linux"] เป็นต้น) |
metadata.openclaw.requires.bins |
ไม่ | ไบนารีที่จำเป็นบน PATH |
metadata.openclaw.requires.config |
ไม่ | คีย์ config ที่จำเป็น |
แนวทางปฏิบัติที่ดีที่สุด
- กระชับ — สั่งโมเดลว่าต้องทำ อะไร ไม่ใช่ว่าต้องเป็น AI อย่างไร
- ความปลอดภัยมาก่อน — หากทักษะของคุณใช้
execให้แน่ใจว่าพรอมป์ไม่เปิดให้มีการแทรกคำสั่งตามอำเภอใจจากอินพุตที่ไม่น่าเชื่อถือ - ทดสอบในเครื่อง — ใช้
openclaw agent --message "..."เพื่อทดสอบก่อนแชร์ - ใช้ ClawHub — เรียกดูและร่วมส่งทักษะได้ที่ ClawHub
ตำแหน่งที่เก็บทักษะ
| ตำแหน่ง | ลำดับความสำคัญ | ขอบเขต |
|---|---|---|
\<workspace\>/skills/ |
สูงสุด | ต่อเอเจนต์ |
\<workspace\>/.agents/skills/ |
สูง | เอเจนต์ต่อเวิร์กสเปซ |
~/.agents/skills/ |
ปานกลาง | โปรไฟล์เอเจนต์ที่ใช้ร่วมกัน |
~/.openclaw/skills/ |
ปานกลาง | ใช้ร่วมกัน (ทุกเอเจนต์) |
| ที่มาพร้อมแพ็กเกจ (จัดส่งพร้อม OpenClaw) | ต่ำ | ทั่วโลก |
skills.load.extraDirs |
ต่ำสุด | โฟลเดอร์ที่ใช้ร่วมกันแบบกำหนดเอง |
ที่เกี่ยวข้อง
- อ้างอิง Skills — การโหลด ลำดับความสำคัญ และกฎการ gate
- การกำหนดค่า Skills — สคีมา config ของ
skills.* - ClawHub — รีจิสทรีทักษะสาธารณะ
- การสร้าง Plugins — plugins สามารถจัดส่งทักษะได้