Tạo Skills

Skills hướng dẫn agent cách thức và thời điểm sử dụng các công cụ. Mỗi skill là một thư mục chứa tệp SKILL.md với phần đầu YAML và các hướng dẫn bằng Markdown. OpenClaw tải các skill từ nhiều thư mục gốc theo một thứ tự ưu tiên xác định.

Tạo skill đầu tiên của bạn

mkdir -p ~/.openclaw/workspace/skills/hello-world

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# tên skill vẫn là "hello-world", được gọi bằng /hello-world

---name: hello-worlddescription: Một skill đơn giản in ra lời chào.--- # Xin chào thế giới Khi người dùng yêu cầu lời chào, hãy dùng công cụ `exec` để chạy: ```bashecho "Xin chào từ skill tùy chỉnh của bạn!"

 Quy tắc đặt tên:- Dùng chữ cái viết thường, chữ số và dấu gạch nối cho `name`.- Giữ tên thư mục và `name` trong phần đầu nhất quán.- `description` được hiển thị cho agent và trong kết quả khám phá lệnh gạch chéo —  hãy viết trên một dòng và dưới 160 ký tự.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSJYw6FjIG1pbmggc2tpbGwgxJHDoyDEkcaw4bujYyB04bqjaSI ```bashopenclaw skills list

# Từ cuộc trò chuyện — lưu trữ phiên hiện tại và bắt đầu phiên mới/new # Hoặc khởi động lại Gatewayopenclaw gateway restart

openclaw agent --message "hãy gửi cho tôi một lời chào"

Tham chiếu SKILL.md

Các trường bắt buộc

Các khóa phần đầu tùy chọn

Đối với các trường kiểm soát điều kiện (requires.bins, requires.env, v.v.), xem Skills — Kiểm soát điều kiện.

Sử dụng {baseDir}

Tham chiếu các tệp bên trong thư mục skill mà không mã hóa cứng đường dẫn — agent phân giải {baseDir} theo chính thư mục của skill:

Chạy tập lệnh hỗ trợ tại `{baseDir}/scripts/run.sh`.

Thêm kích hoạt có điều kiện

Đặt điều kiện cho skill để skill chỉ được tải khi các phần phụ thuộc khả dụng:

---name: gemini-searchdescription: Tìm kiếm bằng 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" },      },    },  },}

Đề xuất qua Skill Workshop

Đối với các skill do agent soạn thảo hoặc khi bạn muốn người vận hành xem xét trước khi một skill được đưa vào sử dụng, hãy dùng đề xuất của Skill Workshop thay vì viết trực tiếp SKILL.md.

# Đề xuất một skill hoàn toàn mớiopenclaw skills workshop propose-create \  --name "hello-world" \  --description "Một skill đơn giản in ra lời chào." \  --proposal ./PROPOSAL.md # Đề xuất cập nhật cho một skill hiện cóopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Skill lời chào đã cập nhật"

Dùng --proposal-dir khi đề xuất bao gồm các tệp hỗ trợ:

openclaw skills workshop propose-create \  --name "hello-world" \  --description "Một skill đơn giản in ra lời chào." \  --proposal-dir ./hello-world-proposal/

Thư mục phải chứa PROPOSAL.md tại thư mục gốc. Các tệp hỗ trợ được đặt trong assets/, examples/, references/, scripts/ hoặc templates/.

Sau khi xem xét:

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

Xem Skill Workshop để biết toàn bộ vòng đời đề xuất.

Xuất bản lên ClawHub

npm i -g clawhubclawhub login

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

Các phương pháp hay nhất

Nội dung liên quan