การสร้าง Skills

Skills สอนเอเจนต์ว่าควรใช้เครื่องมืออย่างไรและเมื่อใด แต่ละทักษะเป็นไดเรกทอรี ที่มีไฟล์ SKILL.md พร้อม YAML frontmatter และคำแนะนำแบบ 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 อักขระ </Step> <Step title="ตรวจสอบว่าโหลดทักษะแล้ว">```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}

อ้างอิงไฟล์ภายในไดเรกทอรีของทักษะโดยไม่ต้องกำหนดพาธตายตัว โดย เอเจนต์จะแปลง {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 Workshop แทนการเขียน SKILL.md โดยตรง

# 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

npm i -g clawhubclawhub login

clawhub skill publish ./path/to/hello-world

แนวทางปฏิบัติที่ดี

เนื้อหาที่เกี่ยวข้อง