Skills dạy agent cách và thời điểm sử dụng công cụ. Mỗi kỹ năng là một thư mục chứa tệpDocumentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md với YAML frontmatter và hướng dẫn markdown.
Để biết cách tải và ưu tiên Skills, xem Skills.
Tạo kỹ năng đầu tiên của bạn
Viết SKILL.md
Tạo Sử dụng dạng hyphen-case với chữ cái thường, chữ số và dấu gạch nối cho
SKILL.md bên trong thư mục đó. Frontmatter định nghĩa siêu dữ liệu,
và phần thân markdown chứa hướng dẫn cho agent.name của kỹ năng. Giữ tên thư mục và name trong frontmatter khớp nhau.Thêm công cụ (tùy chọn)
Bạn có thể định nghĩa schema công cụ tùy chỉnh trong frontmatter hoặc hướng dẫn agent
sử dụng các công cụ hệ thống hiện có (như
exec hoặc browser). Skills cũng có thể
được phân phối bên trong plugin cùng với các công cụ mà chúng ghi tài liệu.Tham chiếu siêu dữ liệu kỹ năng
YAML frontmatter hỗ trợ các trường này:| Trường | Bắt buộc | Mô tả |
|---|---|---|
name | Có | Mã định danh duy nhất dùng chữ cái thường, chữ số và dấu gạch nối |
description | Có | Mô tả một dòng hiển thị cho agent |
metadata.openclaw.os | Không | Bộ lọc OS (["darwin"], ["linux"], v.v.) |
metadata.openclaw.requires.bins | Không | Binary bắt buộc trên PATH |
metadata.openclaw.requires.config | Không | Khóa cấu hình bắt buộc |
Thực hành tốt nhất
- Ngắn gọn — hướng dẫn mô hình về việc cần làm, không phải cách trở thành AI
- An toàn là trên hết — nếu kỹ năng của bạn dùng
exec, hãy đảm bảo prompt không cho phép chèn lệnh tùy ý từ đầu vào không đáng tin cậy - Kiểm tra cục bộ — dùng
openclaw agent --message "..."để kiểm tra trước khi chia sẻ - Dùng ClawHub — duyệt và đóng góp kỹ năng tại ClawHub
Nơi lưu Skills
| Vị trí | Mức ưu tiên | Phạm vi |
|---|---|---|
\<workspace\>/skills/ | Cao nhất | Theo từng agent |
\<workspace\>/.agents/skills/ | Cao | Agent theo workspace |
~/.agents/skills/ | Trung bình | Hồ sơ agent dùng chung |
~/.openclaw/skills/ | Trung bình | Dùng chung (mọi agent) |
| Được đóng gói kèm (phân phối cùng OpenClaw) | Thấp | Toàn cục |
skills.load.extraDirs | Thấp nhất | Thư mục dùng chung tùy chỉnh |
Liên quan
- Tham chiếu Skills — quy tắc tải, mức ưu tiên và gating
- Cấu hình Skills — schema cấu hình
skills.* - ClawHub — registry kỹ năng công khai
- Xây dựng Plugins — plugin có thể phân phối Skills