​

Kỹ năng (OpenClaw)

​

Vị trí và thứ tự ưu tiên

1. Kỹ năng đi kèm: đi kèm với cài đặt (gói npm hoặc OpenClaw.app)
2. Kỹ năng quản lý/cục bộ: ~/.openclaw/skills
3. Kỹ năng workspace: <workspace>/skills

​

Kỹ năng theo agent vs kỹ năng chia sẻ

• Kỹ năng theo agent nằm trong <workspace>/skills chỉ dành cho agent đó.
• Kỹ năng chia sẻ nằm trong ~/.openclaw/skills (quản lý/cục bộ) và có thể truy cập bởi tất cả các agent trên cùng một máy.
• Thư mục chia sẻ cũng có thể được thêm qua skills.load.extraDirs (thấp nhất) nếu bạn muốn một gói kỹ năng chung được sử dụng bởi nhiều agent.

​

Plugin + kỹ năng

​

ClawHub (cài đặt + đồng bộ)

• Cài đặt một kỹ năng vào workspace:
  • clawhub install <skill-slug>
• Cập nhật tất cả các kỹ năng đã cài đặt:
  • clawhub update --all
• Đồng bộ (quét + xuất bản cập nhật):
  • clawhub sync --all

​

Ghi chú bảo mật

• Xem kỹ năng từ bên thứ ba như mã không đáng tin cậy. Đọc kỹ trước khi kích hoạt.
• Ưu tiên chạy trong môi trường sandbox cho các đầu vào không đáng tin cậy và công cụ rủi ro. Xem Sandboxing.
• Khám phá kỹ năng workspace và extra-dir chỉ chấp nhận gốc kỹ năng và các file SKILL.md có đường dẫn thực được giải quyết nằm trong gốc đã cấu hình.
• skills.entries.*.env và skills.entries.*.apiKey tiêm bí mật vào quá trình host cho lượt agent đó (không phải sandbox). Giữ bí mật khỏi các prompt và log.
• Để có mô hình mối đe dọa rộng hơn và danh sách kiểm tra, xem Security.

​

Định dạng (AgentSkills + Pi-compatible)

---
name: image-lab
description: Tạo hoặc chỉnh sửa hình ảnh thông qua quy trình làm việc hình ảnh hỗ trợ nhà cung cấp
---

• Chúng tôi tuân theo đặc tả AgentSkills cho bố cục/mục đích.
• Bộ phân tích cú pháp được sử dụng bởi agent nhúng chỉ hỗ trợ các khóa frontmatter một dòng.
• metadata nên là một đối tượng JSON một dòng.
• Sử dụng {baseDir} trong hướng dẫn để tham chiếu đường dẫn thư mục kỹ năng.
• Các khóa frontmatter tùy chọn:
  • homepage — URL được hiển thị là “Website” trong giao diện kỹ năng macOS (cũng được hỗ trợ qua metadata.openclaw.homepage).
  • user-invocable — true|false (mặc định: true). Khi true, kỹ năng được hiển thị như một lệnh slash của người dùng.
  • disable-model-invocation — true|false (mặc định: false). Khi true, kỹ năng bị loại khỏi prompt mô hình (vẫn có sẵn qua lệnh người dùng).
  • command-dispatch — tool (tùy chọn). Khi được đặt là tool, lệnh slash bỏ qua mô hình và gửi trực tiếp đến công cụ.
  • command-tool — tên công cụ để gọi khi command-dispatch: tool được đặt.
  • command-arg-mode — raw (mặc định). Đối với gửi công cụ, chuyển tiếp chuỗi args thô đến công cụ (không phân tích cú pháp cốt lõi). Công cụ được gọi với các tham số: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

Gating (bộ lọc khi tải)

---
name: image-lab
description: Tạo hoặc chỉnh sửa hình ảnh thông qua quy trình làm việc hình ảnh hỗ trợ nhà cung cấp
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — luôn bao gồm kỹ năng (bỏ qua các cổng khác).
• emoji — emoji tùy chọn được sử dụng bởi giao diện kỹ năng macOS.
• homepage — URL tùy chọn được hiển thị là “Website” trong giao diện kỹ năng macOS.
• os — danh sách tùy chọn các nền tảng (darwin, linux, win32). Nếu được đặt, kỹ năng chỉ đủ điều kiện trên các hệ điều hành đó.
• requires.bins — danh sách; mỗi cái phải tồn tại trên PATH.
• requires.anyBins — danh sách; ít nhất một cái phải tồn tại trên PATH.
• requires.env — danh sách; biến môi trường phải tồn tại hoặc được cung cấp trong cấu hình.
• requires.config — danh sách các đường dẫn openclaw.json phải đúng.
• primaryEnv — tên biến môi trường liên kết với skills.entries.<name>.apiKey.
• install — mảng tùy chọn các đặc tả cài đặt được sử dụng bởi giao diện kỹ năng macOS (brew/node/go/uv/download).

• requires.bins được kiểm tra trên host khi tải kỹ năng.
• Nếu một agent được sandbox, binary 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 container được tạo. Cài đặt gói cũng yêu cầu egress mạng, FS gốc có thể ghi, và người dùng root trong sandbox. Ví dụ: kỹ năng summarize (skills/summarize/SKILL.md) cần CLI summarize trong container sandbox để chạy ở đó.

---
name: gemini
description: Sử dụng Gemini CLI để hỗ trợ mã hóa và tra cứu tìm kiếm Google.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Cài đặt Gemini CLI (brew)",
            },
          ],
      },
  }
---

• Nếu nhiều cài đặt được liệt kê, gateway chọn một tùy chọn ưu tiên duy nhất (brew khi có sẵn, nếu không thì node).
• Nếu tất cả các cài đặt là download, OpenClaw liệt kê từng mục để bạn có thể thấy các artifact có sẵn.
• Các đặc tả cài đặt có thể bao gồm os: ["darwin"|"linux"|"win32"] để lọc tùy chọn 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 cài đặt kỹ năng; runtime Gateway vẫn nên là Node (Bun không được khuyến nghị cho WhatsApp/Telegram).
• Cài đặt Go: nếu go bị thiếu và brew có sẵn, gateway cài đặt Go qua Homebrew trước và đặt GOBIN vào bin của Homebrew khi có thể.
• Cài đặt 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>).

​

Ghi đè cấu hình (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // hoặc chuỗi plaintext
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• enabled: false vô hiệu hóa kỹ năng ngay cả khi nó được đi kèm/cài đặt.
• env: chỉ được tiêm nếu biến chưa được đặt trong quá trình.
• apiKey: tiện lợi cho các kỹ năng khai báo metadata.openclaw.primaryEnv. Hỗ trợ chuỗi plaintext hoặc đối tượng SecretRef ({ source, provider, id }).
• config: túi tùy chọn cho các trường tùy chỉnh theo kỹ năng; các khóa tùy chỉnh phải nằm ở đây.
• allowBundled: danh sách cho phép tùy chọn chỉ dành cho kỹ năng đi kèm. Nếu được đặt, chỉ các kỹ năng đi kèm trong danh sách mới đủ điều kiện (kỹ năng quản lý/workspace không bị ảnh hưởng).

​

Tiêm môi trường (mỗi lần chạy agent)

1. Đọc metadata kỹ năng.
2. Áp dụng bất kỳ skills.entries.<key>.env hoặc skills.entries.<key>.apiKey vào process.env.
3. Xây dựng prompt hệ thống với các kỹ năng đủ điều kiện.
4. Khôi phục môi trường gốc sau khi lượt chạy kết thúc.

​

Ảnh chụp phiên (hiệu suất)

​

Node macOS từ xa (gateway Linux)

​

Trình theo dõi kỹ năng (tự động làm mới)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

Tác động token (danh sách kỹ năng)

• Chi phí cơ bản (chỉ khi có ≥1 kỹ năng): 195 ký tự.
• Mỗi kỹ năng: 97 ký tự + độ dài của các giá trị <name>, <description>, và <location> đã được escape XML.

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• Escape XML mở rộng & < > " ' thành các thực thể (&, <, v.v.), tăng độ dài.
• Số lượng token thay đổi theo bộ phân tích cú pháp mô hình. Ước tính kiểu OpenAI là ~4 ký tự/token, vì vậy 97 ký tự ≈ 24 token mỗi kỹ năng cộng với độ dài trường thực tế của bạn.

​

Vòng đời kỹ năng quản lý

​

Tham chiếu cấu hình

​

Tìm kiếm thêm kỹ năng?