Chuyển đến nội dung chính

Tạo Skills

Skills hướng dẫn agent cách và khi nào sử dụng công cụ. Mỗi skill là một thư mục chứa file SKILL.md với phần đầu YAML và hướng dẫn markdown. Để biết cách skills được tải và ưu tiên, xem Skills.

Tạo skill đầu tiên

1

Tạo thư mục skill

Skills nằm trong workspace của bạn. Tạo một thư mục mới:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

Viết SKILL.md

Tạo file SKILL.md trong thư mục đó. Phần đầu YAML định nghĩa metadata, và phần thân markdown chứa hướng dẫn cho agent.
---
name: hello_world
description: Một skill đơn giản để chào hỏi.
---

# Skill Hello World

Khi người dùng yêu cầu một lời chào, sử dụng công cụ `echo` để nói
"Hello từ skill tùy chỉnh của bạn!".
3

Thêm công cụ (tùy chọn)

Bạn có thể định nghĩa các schema công cụ tùy chỉnh trong phần đầu YAML hoặc hướng dẫn agent sử dụng các công cụ hệ thống có sẵn (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 tài liệu.
4

Tải skill

Bắt đầu một phiên mới để OpenClaw nhận diện skill:
# Từ chat
/new

# Hoặc khởi động lại gateway
openclaw gateway restart
Kiểm tra skill đã được tải:
openclaw skills list
5

Kiểm tra

Gửi một tin nhắn để kích hoạt skill:
openclaw agent --message "give me a greeting"
Hoặc chỉ cần trò chuyện với agent và yêu cầu một lời chào.

Tham khảo metadata của skill

Phần đầu YAML hỗ trợ các trường sau:
TrườngBắt buộcMô tả
nameĐịnh danh duy nhất (snake_case)
descriptionMô tả ngắn gọn hiển thị cho agent
metadata.openclaw.osKhôngBộ lọc hệ điều hành (["darwin"], ["linux"], v.v.)
metadata.openclaw.requires.binsKhôngCác binary cần thiết trên PATH
metadata.openclaw.requires.configKhôngCác khóa cấu hình cần thiết

Thực hành tốt nhất

  • Ngắn gọn — hướng dẫn model làm gì, không phải cách trở thành AI
  • An toàn là trên hết — nếu skill sử dụng exec, đảm bảo không cho phép chèn lệnh tùy ý từ đầu vào không tin cậy
  • Kiểm tra cục bộ — sử dụng openclaw agent --message "..." để kiểm tra trước khi chia sẻ
  • Sử dụng ClawHub — duyệt và đóng góp skills tại ClawHub

Nơi lưu trữ skills

Vị tríƯu tiênPhạm vi
\<workspace\>/skills/Cao nhấtTheo từng agent
~/.openclaw/skills/Trung bìnhChia sẻ (tất cả agents)
Đóng gói (kèm theo OpenClaw)Thấp nhấtToàn cầu
skills.load.extraDirsThấp nhấtThư mục chia sẻ tùy chỉnh

Liên quan

Last modified on March 22, 2026