Skills

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.

​

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

​

Kỹ năng theo từng agent so với kỹ năng dùng chung

​

Danh sách cho phép kỹ năng của agent

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // kế thừa github, weather
      { id: "docs", skills: ["docs-search"] }, // thay thế giá trị mặc định
      { id: "locked-down", skills: [] }, // không có kỹ năng
    ],
  },
}

​

Plugin và kỹ năng

​

Skill Workshop

​

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

​

Bảo mật

• Phát hiện kỹ năng trong workspace và thư mục bổ sung chỉ chấp nhận các gốc kỹ năng và tệp SKILL.md có realpath đã phân giải vẫn nằm trong gốc đã cấu hình.
• Cài đặt kho lưu trữ riêng qua Gateway tắt theo mặc định. Khi được bật rõ ràng, chúng yêu cầu một bản upload zip đã commit chứa SKILL.md và tái sử dụng cùng các biện pháp bảo vệ trích xuất kho lưu trữ, path traversal, symlink, force và rollback như cài đặt kỹ năng ClawHub. Chúng được kiểm soát bởi skills.install.allowUploadedArchives; các cài đặt ClawHub thông thường không yêu cầu thiết lập đó.
• Cài đặt phụ thuộc kỹ năng dựa trên Gateway (skills.install, onboarding và giao diện cài đặt Skills) chạy bộ quét mã nguy hiểm tích hợp trước khi thực thi metadata trình cài đặt. Phát hiện critical bị chặn theo mặc định trừ khi caller đặt rõ ghi đè nguy hiểm; phát hiện đáng ngờ vẫn chỉ cảnh báo.
• openclaw skills install <slug> thì khác - nó tải thư mục kỹ năng ClawHub xuống workspace và không dùng đường dẫn metadata trình cài đặt ở trên.
• skills.entries.*.env và skills.entries.*.apiKey tiêm secret vào tiến trình host cho lượt agent đó (không phải sandbox). Không đưa secret vào prompt và log.

​

Định dạng SKILL.md

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

​

Khóa frontmatter tùy chọn

​

Chặn tải (bộ lọc tại thời điểm tải)

---
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",
      },
  }
---

​

Ghi chú về sandbox

• requires.bins được kiểm tra trên máy chủ tại thời điểm tải kỹ năng.
• Nếu một agent chạy trong 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. Việc cài đặt gói cũng yêu cầu egress mạng, root FS 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 ở đó.

​

Thông số trình cài đặt

---
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)",
            },
          ],
      },
  }
---

​

Ghi đè cấu hình

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

​

Tiêm môi trường

1. Đọc siêu dữ liệu kỹ năng.
2. Áp dụng skills.entries.<key>.env và skills.entries.<key>.apiKey vào process.env.
3. Xây dựng system prompt với các kỹ năng đủ điều kiện.
4. Khôi phục môi trường ban đầu sau khi lượt chạy kết thúc.

​

Ảnh chụp và làm mới

• Trình theo dõi kỹ năng được bật.
• Một node từ xa đủ điều kiện mới xuất hiện.

​

Trình theo dõi Skills

{
  skills: {
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

Node macOS từ xa (gateway Linux)

​

Tác động token

• Chi phí cơ sở (chỉ khi ≥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 XML-escape.

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

​

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

​

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

​

Liên quan

• ClawHub - registry kỹ năng công khai
• Tạo kỹ năng - xây dựng kỹ năng tùy chỉnh
• Plugins - tổng quan hệ thống Plugin
• Plugin Skill Workshop - tạo kỹ năng từ công việc của agent
• Cấu hình Skills - tham chiếu cấu hình kỹ năng
• Lệnh slash - tất cả lệnh slash có sẵn