> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Tạo Skills Skills dạy tác nhân cách thức 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. OpenClaw tải skills từ nhiều gốc theo [thứ tự ưu tiên](/vi/tools/skills#loading-order) đã định nghĩa. ## Tạo skill đầu tiên của bạn Skills nằm trong thư mục `skills/` của workspace. Tạo một thư mục cho skill mới của bạn: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/hello-world ``` Bạn có thể nhóm skills trong các thư mục con để tổ chức — skill vẫn được đặt tên bằng frontmatter của `SKILL.md`, không phải đường dẫn thư mục: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/personal/hello-world # skill name is still "hello-world", invoked as /hello-world ``` Tạo `SKILL.md` bên trong thư mục. Frontmatter định nghĩa siêu dữ liệu; phần thân cung cấp hướng dẫn cho tác nhân. ````markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: hello-world description: A simple skill that prints a greeting. --- # Hello World When the user asks for a greeting, use the `exec` tool to run: ```bash echo "Hello from your custom skill!" ```` ```` Quy tắc đặt tên: - Dùng chữ cái thường, chữ số và dấu gạch nối cho `name`. - Giữ tên thư mục và `name` trong frontmatter khớp nhau. - `description` được hiển thị cho tác nhân và trong phần khám phá slash-command — giữ trong một dòng và dưới 160 ký tự. ```bash openclaw skills list ```` OpenClaw mặc định theo dõi các tệp `SKILL.md` dưới các gốc skills. Nếu trình theo dõi bị tắt hoặc bạn đang tiếp tục một phiên hiện có, hãy bắt đầu một phiên mới để tác nhân nhận danh sách đã làm mới: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # From chat — archive current session and start fresh /new # Or restart the gateway openclaw gateway restart ``` Gửi một tin nhắn sẽ kích hoạt skill: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --message "give me a greeting" ``` Hoặc mở một cuộc trò chuyện và hỏi trực tiếp tác nhân. Dùng `/skill hello-world` để gọi rõ ràng theo tên. ## Tham chiếu SKILL.md ### Trường bắt buộc | Trường | Mô tả | | ------------- | ------------------------------------------------------------- | | `name` | Slug duy nhất dùng chữ cái thường, chữ số và dấu gạch nối | | `description` | Mô tả một dòng hiển thị cho tác nhân và trong đầu ra khám phá | ### Khóa frontmatter tùy chọn | Trường | Mặc định | Mô tả | | -------------------------- | -------- | -------------------------------------------------------------------------------------- | | `user-invocable` | `true` | Hiển thị skill dưới dạng slash command của người dùng | | `disable-model-invocation` | `false` | Không đưa skill vào system prompt của tác nhân (vẫn chạy qua `/skill`) | | `command-dispatch` | — | Đặt thành `tool` để định tuyến slash command trực tiếp đến một công cụ, bỏ qua mô hình | | `command-tool` | — | Tên công cụ cần gọi khi đã đặt `command-dispatch: tool` | | `command-arg-mode` | `raw` | Với điều phối công cụ, chuyển tiếp chuỗi đối số thô đến công cụ | | `homepage` | — | URL hiển thị dưới dạng "Trang web" trong giao diện macOS Skills | Để biết các trường gating (`requires.bins`, `requires.env`, v.v.), xem [Skills — Gating](/vi/tools/skills#gating). ### Sử dụng `{baseDir}` Dùng `{baseDir}` trong phần thân skill để 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: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} Run the helper script at `{baseDir}/scripts/run.sh`. ``` ## Thêm kích hoạt có điều kiện Gate skill của bạn để skill chỉ tải khi các phụ thuộc của nó có sẵn: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: gemini-search description: Search using Gemini CLI. metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } } --- ``` | Khóa | Mô tả | | ------------------ | -------------------------------------------------------- | | `requires.bins` | Tất cả binary phải tồn tại trên `PATH` | | `requires.anyBins` | Ít nhất một binary phải tồn tại trên `PATH` | | `requires.env` | Mỗi biến env phải tồn tại trong tiến trình hoặc cấu hình | | `requires.config` | Mỗi đường dẫn `openclaw.json` phải có giá trị truthy | | `os` | Bộ lọc nền tảng: `["darwin"]`, `["linux"]`, `["win32"]` | | `always` | Đặt `true` để bỏ qua mọi gate và luôn đưa skill vào | Tham chiếu đầy đủ: [Skills — Gating](/vi/tools/skills#gating). Nối một khóa API vào một mục skill trong `openclaw.json`: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { skills: { entries: { "gemini-search": { enabled: true, apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, }, }, }, } ``` Khóa chỉ được tiêm vào tiến trình host cho lượt tác nhân đó. Khóa không đi vào sandbox — xem [biến env trong sandbox](/vi/tools/skills-config#sandboxed-skills-and-env-vars). ## Đề xuất qua Xưởng Skill Đối với skills do tác nhân 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 đi vào hoạt động, hãy dùng đề xuất [Xưởng Skill](/vi/tools/skill-workshop) thay vì viết trực tiếp `SKILL.md`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Propose a brand-new skill openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal ./PROPOSAL.md # Propose an update to an existing skill openclaw skills workshop propose-update hello-world \ --proposal ./PROPOSAL.md \ --description "Updated greeting skill" ``` Dùng `--proposal-dir` khi đề xuất bao gồm các tệp hỗ trợ: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal-dir ./hello-world-proposal/ ``` Thư mục phải chứa `PROPOSAL.md`. Các tệp hỗ trợ có thể nằm trong `assets/`, `examples/`, `references/`, `scripts/`, hoặc `templates/`. Sau khi xem xét: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop inspect openclaw skills workshop apply ``` Xem [Xưởng Skill](/vi/tools/skill-workshop) để biết toàn bộ vòng đời đề xuất. ## Xuất bản lên ClawHub Đảm bảo `name`, `description` và mọi trường gating `metadata.openclaw` đã được đặt. Thêm URL `homepage` nếu bạn có trang dự án. Skill ClawHub ghi lại dạng lệnh xuất bản hiện tại và siêu dữ liệu bắt buộc: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills install @openclaw/clawhub-publish ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub publish ``` Xem [ClawHub — Xuất bản](/vi/clawhub/publishing) để biết toàn bộ quy trình. ## 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 trước tiên** — nếu skill 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 thử cục bộ** — dùng `openclaw agent --message "..."` trước khi chia sẻ. * **Dùng ClawHub** — duyệt skills cộng đồng tại [clawhub.ai](https://clawhub.ai) trước khi xây dựng từ đầu. ## Liên quan Thứ tự tải, gating, allowlist và định dạng SKILL.md. Hàng đợi đề xuất cho skills do tác nhân soạn thảo. Lược đồ cấu hình `skills.*` đầy đủ. Duyệt và xuất bản skills trên registry công khai. Plugins có thể phát hành skills cùng với các công cụ mà chúng ghi lại.