English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Skills

Tạo Skills

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

  • 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

  • Viết SKILL.md

    Tạo 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: hello-world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".

    Dùng dạng hyphen-case với chữ thường, chữ số và dấu gạch nối cho 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.

  • Tải skill

    Bắt đầu một phiên mới để OpenClaw nhận skill:

    # From chat
/new

# Or restart the gateway
openclaw gateway restart

    Xác minh skill đã được tải:

    openclaw skills list

  • Kiểm thử

    Gửi một tin nhắn có thể 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 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