Skills hướng dẫn agent cách và thời điểm sử dụng công cụ. Mỗi skill là một thư mục chứa tệpDocumentation Index
Fetch the complete documentation index at: https://docs.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 skill đầu tiên của bạn
Viết SKILL.md
Tạo Dùng dạng hyphen-case với chữ thường, chữ số và dấu gạch nối cho
SKILL.md bên trong thư mục đó. Frontmatter định nghĩa metadata,
còn phần thân markdown chứa hướng dẫn cho agent.name của skill. Giữ tên thư mục và name trong frontmatter đồng nhất.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 đóng gói trong plugins cùng với các công cụ mà chúng ghi tài liệu.Tham chiếu metadata của skill
YAML frontmatter hỗ trợ các trường sau:| Trường | Bắt buộc | Mô tả |
|---|---|---|
name | Có | Định danh duy nhất dùng chữ 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 | Các binary bắt buộc trên PATH |
metadata.openclaw.requires.config | Không | Các 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 model về việc cần làm, không phải cách trở thành AI
- An toàn trước tiên — nếu skill của bạn dùng
exec, hãy bảo đảm prompt không cho phép chèn lệnh tùy ý từ đầu vào không đáng tin cậy - Kiểm thử cục bộ — dùng
openclaw agent --message "..."để kiểm thử trước khi chia sẻ - Dùng ClawHub — duyệt và đóng góp skills 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 từng workspace |
~/.agents/skills/ | Trung bình | Hồ sơ agent dùng chung |
~/.openclaw/skills/ | Trung bình | Dùng chung (mọi agent) |
| Đi kèm (phát hành với 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 skill công khai
- Xây dựng Plugins — plugins có thể đóng gói skills