> ## 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.

# Skills

Skills là các tệp hướng dẫn markdown dạy agent cách và thời điểm sử dụng
công cụ. Mỗi skill nằm trong một thư mục chứa tệp `SKILL.md` có YAML
frontmatter và phần thân markdown. OpenClaw tải các skill đi kèm cùng mọi phần
ghi đè cục bộ, rồi lọc chúng khi tải dựa trên môi trường, cấu hình và sự hiện
diện của binary.

<CardGroup cols={2}>
  <Card title="Creating skills" href="/vi/tools/creating-skills" icon="hammer">
    Xây dựng và kiểm thử một skill tùy chỉnh từ đầu.
  </Card>

  <Card title="Skill Workshop" href="/vi/tools/skill-workshop" icon="flask">
    Rà soát và phê duyệt các đề xuất skill do agent soạn thảo.
  </Card>

  <Card title="Skills config" href="/vi/tools/skills-config" icon="gear">
    Lược đồ cấu hình `skills.*` đầy đủ và allowlist cho agent.
  </Card>

  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Duyệt và cài đặt skill cộng đồng.
  </Card>
</CardGroup>

## Thứ tự tải

OpenClaw tải từ các nguồn này, **theo thứ tự ưu tiên cao nhất trước**. Khi cùng
một tên skill xuất hiện ở nhiều nơi, nguồn có độ ưu tiên cao nhất sẽ thắng.

| Mức ưu tiên   | Nguồn                       | Đường dẫn                              |
| ------------- | --------------------------- | -------------------------------------- |
| 1 — cao nhất  | Skill workspace             | `<workspace>/skills`                   |
| 2             | Skill agent dự án           | `<workspace>/.agents/skills`           |
| 3             | Skill agent cá nhân         | `~/.agents/skills`                     |
| 4             | Skill được quản lý / cục bộ | `~/.openclaw/skills`                   |
| 5             | Skill đi kèm                | đi kèm với bản cài đặt                 |
| 6 — thấp nhất | Thư mục bổ sung             | `skills.load.extraDirs` + skill plugin |

Các gốc skill hỗ trợ bố cục theo nhóm. OpenClaw phát hiện một skill bất cứ khi
nào `SKILL.md` xuất hiện ở bất kỳ đâu dưới một gốc đã cấu hình:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
<workspace>/skills/research/SKILL.md          ✓ found as "research"
<workspace>/skills/personal/research/SKILL.md ✓ also found as "research"
```

Đường dẫn thư mục chỉ dùng để tổ chức. Tên skill, lệnh slash và khóa allowlist
đều lấy từ trường frontmatter `name` (hoặc tên thư mục khi thiếu `name`).

<Note>
  Thư mục `$CODEX_HOME/skills` gốc của Codex CLI **không** phải là gốc skill
  của OpenClaw. Dùng `openclaw migrate plan codex` để kiểm kê các skill đó, rồi
  `openclaw migrate codex` để sao chép chúng vào workspace OpenClaw của bạn.
</Note>

## Skill theo từng agent so với skill dùng chung

Trong thiết lập nhiều agent, mỗi agent có workspace riêng. Hãy dùng đường dẫn
khớp với phạm vi hiển thị bạn muốn:

| Phạm vi                 | Đường dẫn                    | Hiển thị với               |
| ----------------------- | ---------------------------- | -------------------------- |
| Theo agent              | `<workspace>/skills`         | Chỉ agent đó               |
| Agent dự án             | `<workspace>/.agents/skills` | Chỉ agent của workspace đó |
| Agent cá nhân           | `~/.agents/skills`           | Tất cả agent trên máy này  |
| Dùng chung được quản lý | `~/.openclaw/skills`         | Tất cả agent trên máy này  |
| Thư mục bổ sung         | `skills.load.extraDirs`      | Tất cả agent trên máy này  |

## Allowlist cho agent

**Vị trí** skill (độ ưu tiên) và **khả năng hiển thị** skill (agent nào có thể
dùng nó) là các cơ chế kiểm soát riêng biệt. Dùng allowlist để giới hạn những
skill mà một agent nhìn thấy, bất kể chúng được tải từ đâu.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      skills: ["github", "weather"], // shared baseline
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults entirely
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}
```

<AccordionGroup>
  <Accordion title="Allowlist rules">
    * Bỏ qua `agents.defaults.skills` để mặc định không hạn chế skill nào.
    * Bỏ qua `agents.list[].skills` để kế thừa `agents.defaults.skills`.
    * Đặt `agents.list[].skills: []` để không cung cấp skill nào cho agent đó.
    * Danh sách `agents.list[].skills` không rỗng là tập **cuối cùng** — nó không
      hợp nhất với mặc định.
    * Allowlist có hiệu lực áp dụng trên quá trình xây dựng prompt, phát hiện
      lệnh slash, đồng bộ sandbox và snapshot skill.
    * Đây không phải là ranh giới ủy quyền shell host. Nếu cùng agent đó có thể
      dùng `exec`, hãy ràng buộc shell đó riêng bằng sandboxing, cô lập người dùng
      OS, deny/allowlist cho exec và thông tin xác thực theo từng tài nguyên.
  </Accordion>
</AccordionGroup>

## Plugin và skill

Plugin có thể đi kèm skill riêng bằng cách liệt kê các thư mục `skills` trong
`openclaw.plugin.json` (đường dẫn tương đối với gốc plugin). Skill plugin tải
khi plugin được bật — ví dụ, plugin trình duyệt đi kèm skill
`browser-automation` để điều khiển trình duyệt nhiều bước.

Các thư mục skill plugin được hợp nhất ở cùng mức ưu tiên thấp như
`skills.load.extraDirs`, vì vậy skill đi kèm, được quản lý, agent hoặc workspace
trùng tên sẽ ghi đè chúng. Kiểm soát chúng qua `metadata.openclaw.requires.config`
trên mục cấu hình của plugin.

Xem [Plugin](/vi/tools/plugin) và [Công cụ](/vi/tools) để biết toàn bộ hệ thống plugin.

## Skill Workshop

[Skill Workshop](/vi/tools/skill-workshop) là hàng đợi đề xuất giữa agent và các
tệp skill đang hoạt động của bạn. Khi agent phát hiện công việc có thể tái sử
dụng, nó soạn một đề xuất thay vì ghi trực tiếp vào `SKILL.md`. Bạn rà soát và
phê duyệt trước khi có bất kỳ thay đổi nào.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
```

Xem [Skill Workshop](/vi/tools/skill-workshop) để biết toàn bộ vòng đời, tham chiếu
CLI và cấu hình.

## Cài đặt từ ClawHub

[ClawHub](https://clawhub.ai) là registry skill công khai. Dùng các lệnh
`openclaw skills` để cài đặt và cập nhật, hoặc CLI `clawhub` để phát hành và
đồng bộ.

| Hành động                                     | Lệnh                                                   |
| --------------------------------------------- | ------------------------------------------------------ |
| Cài đặt skill vào workspace                   | `openclaw skills install @owner/<slug>`                |
| Cài đặt từ kho Git                            | `openclaw skills install git:owner/repo@ref`           |
| Cài đặt thư mục skill cục bộ                  | `openclaw skills install ./path/to/skill --as my-tool` |
| Cài đặt cho tất cả agent cục bộ               | `openclaw skills install @owner/<slug> --global`       |
| Cập nhật tất cả skill workspace               | `openclaw skills update --all`                         |
| Cập nhật skill dùng chung được quản lý        | `openclaw skills update @owner/<slug> --global`        |
| Cập nhật tất cả skill dùng chung được quản lý | `openclaw skills update --all --global`                |
| Xác minh phong bì tin cậy của skill           | `openclaw skills verify @owner/<slug>`                 |
| In Skill Card đã tạo                          | `openclaw skills verify @owner/<slug> --card`          |
| Phát hành / đồng bộ qua ClawHub CLI           | `clawhub sync --all`                                   |

<AccordionGroup>
  <Accordion title="Install details">
    Theo mặc định, `openclaw skills install` cài đặt vào thư mục `skills/` của
    workspace đang hoạt động. Thêm `--global` để cài đặt vào thư mục dùng chung
    `~/.openclaw/skills`, hiển thị với tất cả agent cục bộ trừ khi allowlist của
    agent thu hẹp phạm vi đó.

    Cài đặt Git và cục bộ yêu cầu `SKILL.md` ở gốc nguồn. Slug lấy từ
    frontmatter `name` của `SKILL.md` khi hợp lệ, rồi fallback về tên thư mục
    hoặc kho. Dùng `--as <slug>` để ghi đè. `openclaw skills update` chỉ theo dõi
    các bản cài đặt ClawHub — hãy cài đặt lại nguồn Git hoặc cục bộ để làm mới.
  </Accordion>

  <Accordion title="Verification and security scanning">
    `openclaw skills verify @owner/<slug>` yêu cầu ClawHub cung cấp phong bì tin
    cậy `clawhub.skill.verify.v1` của skill. Các skill ClawHub đã cài đặt được
    xác minh dựa trên phiên bản và registry ghi trong `.clawhub/origin.json`.
    Slug trần vẫn được chấp nhận cho các skill đã cài đặt hiện có hoặc không mơ
    hồ, nhưng ref có chủ sở hữu giúp tránh nhầm lẫn nhà phát hành.

    Trang skill ClawHub hiển thị trạng thái quét bảo mật mới nhất trước khi cài
    đặt, với các trang chi tiết cho VirusTotal, ClawScan và phân tích tĩnh. Lệnh
    thoát khác 0 khi ClawHub đánh dấu xác minh là thất bại. Nhà phát hành xử lý
    dương tính giả qua bảng điều khiển ClawHub hoặc
    `clawhub skill rescan @owner/<slug>`.
  </Accordion>

  <Accordion title="Private archive installs">
    Gateway client cần phân phối không qua ClawHub có thể stage một kho lưu trữ
    skill dạng zip bằng `skills.upload.begin`, `skills.upload.chunk` và
    `skills.upload.commit`, rồi cài đặt bằng
    `skills.install({ source: "upload", ... })`. Đường dẫn này mặc định tắt và
    yêu cầu `skills.install.allowUploadedArchives: true` trong `openclaw.json`.
    Cài đặt ClawHub thông thường không bao giờ cần thiết lập đó.
  </Accordion>
</AccordionGroup>

## Bảo mật

<Warning>
  Hãy xem skill bên thứ ba là **mã không đáng tin cậy**. Đọc chúng trước khi
  bật. Ưu tiên chạy trong sandbox cho đầu vào không đáng tin cậy và công cụ rủi
  ro. Xem [Sandboxing](/vi/gateway/sandboxing) để biết các kiểm soát phía agent.
</Warning>

<AccordionGroup>
  <Accordion title="Path containment">
    Phát hiện skill trong workspace, agent dự án và thư mục bổ sung chỉ chấp
    nhận các gốc skill có realpath đã phân giải vẫn nằm trong gốc đã cấu hình,
    trừ khi `skills.load.allowSymlinkTargets` tin cậy rõ ràng một gốc đích.
    Skill Workshop chỉ ghi qua các đích đáng tin cậy đó khi
    `skills.workshop.allowSymlinkTargetWrites` được bật. `~/.openclaw/skills`
    được quản lý và `~/.agents/skills` cá nhân có thể chứa thư mục skill symlink,
    nhưng mọi realpath của `SKILL.md` vẫn phải nằm trong thư mục skill đã phân
    giải của nó.
  </Accordion>

  <Accordion title="Operator install policy">
    Cấu hình `security.installPolicy` để chạy một lệnh chính sách cục bộ đáng
    tin cậy trước khi tiếp tục cài đặt skill. Chính sách nhận metadata và đường
    dẫn nguồn đã stage, áp dụng cho ClawHub, upload, Git, cục bộ, cập nhật và
    các đường dẫn trình cài đặt phụ thuộc, đồng thời fail closed khi lệnh không
    thể trả về quyết định hợp lệ.
  </Accordion>

  <Accordion title="Secret injection scope">
    `skills.entries.*.env` và `skills.entries.*.apiKey` tiêm secret vào tiến
    trình **host** chỉ cho lượt agent đó — không vào sandbox. Giữ secret khỏi
    prompt và log.
  </Accordion>
</AccordionGroup>

Để biết mô hình đe dọa rộng hơn và checklist bảo mật, xem
[Bảo mật](/vi/gateway/security).

## Định dạng SKILL.md

Mỗi skill tối thiểu cần có `name` và `description` trong frontmatter:

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

When the user asks to generate an image, use the `image_generate` tool...
```

<Note>
  OpenClaw tuân theo đặc tả [AgentSkills](https://agentskills.io). Trình phân
  tích frontmatter chỉ hỗ trợ **khóa một dòng** — `metadata` phải là một đối
  tượng JSON một dòng. Dùng `{baseDir}` trong phần thân để tham chiếu đường dẫn
  thư mục skill.
</Note>

### Khóa frontmatter tùy chọn

<ParamField path="homepage" type="string">
  URL hiển thị là "Trang web" trong giao diện macOS Skills. Cũng được hỗ trợ qua
  `metadata.openclaw.homepage`.
</ParamField>

<ParamField path="user-invocable" type="boolean" default="true">
  Khi là `true`, skill được hiển thị dưới dạng lệnh slash mà người dùng có thể
  gọi.
</ParamField>

<ParamField path="disable-model-invocation" type="boolean" default="false">
  Khi là `true`, OpenClaw không đưa hướng dẫn của skill vào prompt thông thường
  của agent. Skill vẫn khả dụng dưới dạng lệnh slash khi `user-invocable` cũng
  là `true`.
</ParamField>

<ParamField path="command-dispatch" type="&#x22;tool&#x22;">
  Khi đặt thành `tool`, lệnh slash bỏ qua model và điều phối trực tiếp đến một
  công cụ đã đăng ký.
</ParamField>

<ParamField path="command-tool" type="string">
  Tên công cụ cần gọi khi đặt `command-dispatch: tool`.
</ParamField>

<ParamField path="command-arg-mode" type="&#x22;raw&#x22;" default="raw">
  Đối với việc điều phối công cụ, chuyển tiếp chuỗi đối số thô đến công cụ mà
  không phân tích cú pháp ở lõi. Công cụ nhận
  `{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }`.
</ParamField>

## Kiểm soát điều kiện

OpenClaw lọc skills tại thời điểm tải bằng `metadata.openclaw` (JSON một dòng
trong frontmatter). Một skill không có khối `metadata.openclaw` luôn đủ điều
kiện trừ khi bị tắt rõ ràng.

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---
```

<ParamField path="always" type="boolean">
  Khi là `true`, luôn bao gồm skill và bỏ qua mọi cổng điều kiện khác.
</ParamField>

<ParamField path="emoji" type="string">
  Emoji tùy chọn hiển thị trong giao diện Skills của macOS.
</ParamField>

<ParamField path="homepage" type="string">
  URL tùy chọn hiển thị dưới dạng "Website" trong giao diện Skills của macOS.
</ParamField>

<ParamField path="os" type="&#x22;darwin&#x22; | &#x22;linux&#x22; | &#x22;win32&#x22;">
  Bộ lọc nền tảng. Khi được đặt, skill chỉ đủ điều kiện trên các hệ điều hành được liệt kê.
</ParamField>

<ParamField path="requires.bins" type="string[]">
  Mỗi tệp nhị phân phải tồn tại trên `PATH`.
</ParamField>

<ParamField path="requires.anyBins" type="string[]">
  Ít nhất một tệp nhị phân phải tồn tại trên `PATH`.
</ParamField>

<ParamField path="requires.env" type="string[]">
  Mỗi biến môi trường phải tồn tại trong tiến trình hoặc được cung cấp qua cấu hình.
</ParamField>

<ParamField path="requires.config" type="string[]">
  Mỗi đường dẫn `openclaw.json` phải có giá trị truthy.
</ParamField>

<ParamField path="primaryEnv" type="string">
  Tên biến môi trường liên kết với `skills.entries.<name>.apiKey`.
</ParamField>

<ParamField path="install" type="object[]">
  Đặc tả trình cài đặt tùy chọn được giao diện Skills của macOS sử dụng (brew / node / go / uv / download).
</ParamField>

<Note>
  Các khối `metadata.clawdbot` cũ vẫn được chấp nhận khi không có
  `metadata.openclaw`, để các skills đã cài đặt cũ vẫn giữ cổng phụ thuộc và
  gợi ý trình cài đặt của chúng. Skills mới nên dùng `metadata.openclaw`.
</Note>

### Đặc tả trình cài đặt

Đặc tả trình cài đặt cho giao diện Skills của macOS biết cách cài đặt một phụ thuộc:

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---
```

<AccordionGroup>
  <Accordion title="Installer selection rules">
    * Khi liệt kê nhiều trình cài đặt, gateway chọn một tùy chọn ưu tiên
      (brew khi có sẵn, nếu không thì node).
    * Nếu tất cả trình cài đặt là `download`, OpenClaw liệt kê từng mục để bạn
      có thể xem mọi hiện vật có sẵn.
    * Đặc tả có thể bao gồm `os: ["darwin"|"linux"|"win32"]` để lọc theo nền tảng.
    * Cài đặt Node tuân theo `skills.install.nodeManager` trong `openclaw.json`
      (mặc định: npm; tùy chọn: npm / pnpm / yarn / bun). Điều này chỉ ảnh hưởng
      đến việc cài đặt skill; thời gian chạy Gateway vẫn nên là Node.
    * Ưu tiên trình cài đặt của Gateway: Homebrew → uv → trình quản lý node đã cấu hình →
      go → download.
  </Accordion>

  <Accordion title="Per-installer details">
    * **Homebrew:** OpenClaw không tự động cài đặt Homebrew hoặc chuyển đổi
      công thức brew thành lệnh gói hệ thống. Trong container Linux không có
      `brew`, các trình cài đặt chỉ dùng brew sẽ bị ẩn; hãy dùng image tùy chỉnh
      hoặc cài đặt phụ thuộc thủ công.
    * **Go:** OpenClaw yêu cầu Go 1.21 trở lên cho việc cài đặt skill tự động và
      giữ nguyên các thiết lập `GOBIN`, `GOPATH`, và `GOTOOLCHAIN` hiện có. Nếu
      toolchain đã cấu hình không thể đáp ứng phiên bản Go mà một module yêu cầu,
      onboarding sẽ nhóm skill với các điều kiện tiên quyết Go thủ công sau lần thử
      cài đặt. Nếu thiếu `go` và Homebrew có sẵn, OpenClaw cài đặt Go qua Homebrew
      trước và đặt `GOBIN` thành `bin` của Homebrew. Trên Linux,
      OpenClaw có thể thay vào đó dùng `apt-get` với quyền root hoặc qua `sudo`
      không cần mật khẩu khi ứng viên `golang-go` đã làm mới đáp ứng phiên bản tối thiểu.
    * **Download:** `url` (bắt buộc), `archive` (`tar.gz` | `tar.bz2` | `zip`),
      `extract` (mặc định: tự động khi phát hiện archive), `stripComponents`,
      `targetDir` (mặc định: `~/.openclaw/tools/<skillKey>`).
  </Accordion>

  <Accordion title="Sandboxing notes">
    `requires.bins` được kiểm tra trên **máy chủ** tại thời điểm tải skill. Nếu một agent
    chạy trong sandbox, tệp nhị phân cũng phải tồn tại **bên trong container**.
    Cài đặt nó qua `agents.defaults.sandbox.docker.setupCommand` hoặc một image
    tùy chỉnh. `setupCommand` chạy một lần sau khi tạo container và yêu cầu
    kết nối mạng ra ngoài, hệ thống tệp root có thể ghi, và người dùng root trong sandbox.
  </Accordion>
</AccordionGroup>

## Ghi đè cấu hình

Bật/tắt và cấu hình các skills được đóng gói hoặc quản lý dưới `skills.entries` trong
`~/.openclaw/openclaw.json`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}
```

<ParamField path="enabled" type="boolean">
  `false` tắt skill ngay cả khi được đóng gói hoặc đã cài đặt. Skill đóng gói `coding-agent`
  là tùy chọn tham gia — đặt `skills.entries.coding-agent.enabled: true`
  và bảo đảm một trong `claude`, `codex`, `opencode`, hoặc CLI được hỗ trợ khác
  đã được cài đặt và xác thực.
</ParamField>

<ParamField path="apiKey" type="string | { source, provider, id }">
  Trường tiện lợi cho skills khai báo `metadata.openclaw.primaryEnv`.
  Hỗ trợ chuỗi văn bản thuần hoặc đối tượng SecretRef.
</ParamField>

<ParamField path="env" type="Record<string, string>">
  Biến môi trường được chèn cho lần chạy agent. Chỉ được chèn khi biến
  chưa được đặt trong tiến trình.
</ParamField>

<ParamField path="config" type="object">
  Túi tùy chọn cho các trường cấu hình tùy chỉnh theo từng skill.
</ParamField>

<ParamField path="allowBundled" type="string[]">
  Danh sách cho phép tùy chọn chỉ dành cho skills **được đóng gói**. Khi được đặt,
  chỉ các skills được đóng gói trong danh sách mới đủ điều kiện. Skills được quản lý
  và workspace không bị ảnh hưởng.
</ParamField>

<Note>
  Theo mặc định, khóa cấu hình khớp với **tên skill**. Nếu một skill định nghĩa
  `metadata.openclaw.skillKey`, hãy dùng khóa đó dưới `skills.entries`. Đặt
  tên có dấu gạch nối trong dấu nháy: JSON5 cho phép khóa được trích dẫn.
</Note>

## Chèn môi trường

Khi một lần chạy agent bắt đầu, OpenClaw:

<Steps>
  <Step title="Reads skill metadata">
    OpenClaw phân giải danh sách skill hiệu lực cho agent, áp dụng các quy tắc
    kiểm soát điều kiện, danh sách cho phép, và ghi đè cấu hình.
  </Step>

  <Step title="Injects env and API keys">
    `skills.entries.<key>.env` và `skills.entries.<key>.apiKey` được áp dụng vào
    `process.env` trong thời lượng của lần chạy.
  </Step>

  <Step title="Builds the system prompt">
    Skills đủ điều kiện được biên dịch thành một khối XML gọn và chèn vào
    system prompt.
  </Step>

  <Step title="Restores the environment">
    Sau khi lần chạy kết thúc, môi trường ban đầu được khôi phục.
  </Step>
</Steps>

<Warning>
  Việc chèn env chỉ giới hạn trong lần chạy agent trên **máy chủ**, không phải sandbox. Bên trong
  sandbox, `env` và `apiKey` không có hiệu lực. Xem
  [Cấu hình Skills](/vi/tools/skills-config#sandboxed-skills-and-env-vars) để biết cách
  truyền secrets vào các lần chạy trong sandbox.
</Warning>

Đối với backend `claude-cli` được đóng gói, OpenClaw cũng vật chất hóa cùng
snapshot skill đủ điều kiện dưới dạng một Plugin Claude Code tạm thời và truyền nó qua
`--plugin-dir`. Các backend CLI khác chỉ dùng danh mục prompt.

## Snapshot và làm mới

OpenClaw chụp snapshot skills đủ điều kiện **khi một phiên bắt đầu** và tái sử dụng
danh sách đó cho mọi lượt tiếp theo trong phiên. Thay đổi đối với skills hoặc cấu hình có
hiệu lực ở phiên mới tiếp theo.

Skills làm mới giữa phiên trong hai trường hợp:

* Trình theo dõi skills phát hiện thay đổi `SKILL.md`.
* Một node từ xa mới đủ điều kiện kết nối.

Danh sách đã làm mới được dùng ở lượt agent tiếp theo. Nếu danh sách cho phép hiệu lực
của agent thay đổi, OpenClaw làm mới snapshot để giữ các skills hiển thị
được căn chỉnh.

<AccordionGroup>
  <Accordion title="Skills watcher">
    Theo mặc định, OpenClaw theo dõi các thư mục skill và tăng snapshot khi
    tệp `SKILL.md` thay đổi. Cấu hình dưới `skills.load`:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      skills: {
        load: {
          extraDirs: ["~/Projects/agent-scripts/skills"],
          allowSymlinkTargets: ["~/Projects/manager/skills"],
          watch: true,
          watchDebounceMs: 250,
        },
      },
    }
    ```

    Dùng `allowSymlinkTargets` cho các bố cục symlink có chủ ý, nơi một symlink
    gốc skill trỏ ra ngoài gốc đã cấu hình, ví dụ
    `<workspace>/skills/manager -> ~/Projects/manager/skills`.
    Chỉ bật `skills.workshop.allowSymlinkTargetWrites` khi Skill Workshop
    cũng nên áp dụng đề xuất thông qua các đường dẫn symlink đáng tin cậy đó.
  </Accordion>

  <Accordion title="Remote macOS nodes (Linux gateway)">
    Nếu Gateway chạy trên Linux nhưng một **node macOS** được kết nối với
    `system.run` được phép, OpenClaw có thể coi skills chỉ dành cho macOS là đủ điều kiện khi
    các tệp nhị phân bắt buộc hiện diện trên node đó. Agent nên chạy các
    skills đó qua công cụ `exec` với `host=node`.

    Các node ngoại tuyến **không** làm cho skills chỉ từ xa hiển thị. Nếu một node ngừng
    trả lời các probe bin, OpenClaw xóa các kết quả khớp bin đã lưu cache của node đó.
  </Accordion>
</AccordionGroup>

## Tác động token

Khi skills đủ điều kiện, OpenClaw chèn một khối XML gọn vào system
prompt. Chi phí là xác định:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
total = 195 + Σ (97 + len(name) + len(description) + len(filepath))
```

* **Chi phí nền** (chỉ khi ≥ 1 skill): \~195 ký tự
* **Mỗi skill:** \~97 ký tự + độ dài các trường `name`, `description`, và `location` của bạn
* Escape XML mở rộng `& < > " '` thành thực thể, thêm vài ký tự cho mỗi lần xuất hiện
* Với \~4 ký tự/token, 97 ký tự ≈ 24 token cho mỗi skill trước độ dài trường

Giữ mô tả ngắn gọn và có tính mô tả để giảm thiểu chi phí prompt.

## Liên quan

<CardGroup cols={2}>
  <Card title="Creating skills" href="/vi/tools/creating-skills" icon="hammer">
    Hướng dẫn từng bước để viết một skill tùy chỉnh.
  </Card>

  <Card title="Skill Workshop" href="/vi/tools/skill-workshop" icon="flask">
    Hàng đợi đề xuất cho skills do agent soạn thảo.
  </Card>

  <Card title="Skills config" href="/vi/tools/skills-config" icon="gear">
    Lược đồ cấu hình `skills.*` đầy đủ và danh sách cho phép agent.
  </Card>

  <Card title="Slash commands" href="/vi/tools/slash-commands" icon="terminal">
    Cách đăng ký và định tuyến slash command của skill.
  </Card>

  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Duyệt và xuất bản skills trên registry công khai.
  </Card>

  <Card title="Plugins" href="/vi/tools/plugin" icon="plug">
    Plugins có thể phân phối skills cùng với các công cụ mà chúng ghi tài liệu.
  </Card>
</CardGroup>