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 ต่ำสุด โฟลเดอร์ที่ใช้ร่วมกันแบบกำหนดเอง

    ที่เกี่ยวข้อง