การสร้าง Skills

Skills สอนเอเจนต์ว่าจะใช้เครื่องมืออย่างไรและเมื่อใด แต่ละ skill เป็นไดเรกทอรี ที่มีไฟล์ SKILL.md พร้อม YAML frontmatter และคำแนะนำแบบ markdown OpenClaw โหลด skills จากหลาย root ตามลำดับความสำคัญที่กำหนดไว้

สร้าง skill แรกของคุณ

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` จะแสดงให้เอเจนต์เห็นและใน slash-command discovery —  ให้เป็นบรรทัดเดียวและไม่เกิน 160 อักขระ  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSJWZXJpZnkgdGhlIHNraWxsIGxvYWRlZCI ```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 ที่ไม่บังคับ

สำหรับฟิลด์ gating (requires.bins, requires.env และอื่นๆ) โปรดดู Skills — Gating

การใช้ {baseDir}

ใช้ {baseDir} ใน body ของ skill เพื่ออ้างอิงไฟล์ภายในไดเรกทอรีของ skill โดยไม่ต้อง hardcode path:

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

การเพิ่มการเปิดใช้งานแบบมีเงื่อนไข

ตั้ง gate ให้ skill ของคุณเพื่อให้โหลดเฉพาะเมื่อ dependencies พร้อมใช้งาน:

---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

สำหรับ skills ที่เอเจนต์ร่างขึ้น หรือเมื่อคุณต้องการให้ operator review ก่อนที่ skill จะ ใช้งานจริง ให้ใช้ proposals ของ 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 เมื่อ proposal มีไฟล์สนับสนุน:

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/

หลัง review:

openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

ดู Skill Workshop สำหรับ lifecycle ของ proposal ฉบับเต็ม

การเผยแพร่ไปยัง ClawHub

openclaw skills install @openclaw/clawhub-publish

clawhub publish

แนวปฏิบัติที่ดีที่สุด

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