Cấu hình 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.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
      allowUploadedArchives: false,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• Thiết lập tích hợp sẵn kiểu Nano Banana Pro: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• Thiết lập fal tích hợp sẵn: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

Danh sách cho phép Skills của tác tử

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits defaults -> github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

• agents.defaults.skills: danh sách cho phép cơ sở dùng chung cho các tác tử bỏ qua agents.list[].skills.
• Bỏ qua agents.defaults.skills để mặc định không hạn chế Skills.
• agents.list[].skills: tập Skills cuối cùng rõ ràng cho tác tử đó; nó không hợp nhất với mặc định.
• agents.list[].skills: []: không hiển thị Skills nào cho tác tử đó.

​

Trường

• Các gốc Skills tích hợp sẵn luôn bao gồm ~/.openclaw/skills, ~/.agents/skills, <workspace>/.agents/skills, và <workspace>/skills.
• allowBundled: danh sách cho phép tùy chọn chỉ dành cho Skills đóng gói kèm. Khi được đặt, chỉ các Skills đóng gói kèm trong danh sách mới đủ điều kiện (Skills được quản lý, của tác tử, và của không gian làm việc không bị ảnh hưởng).
• load.extraDirs: các thư mục Skills bổ sung cần quét (độ ưu tiên thấp nhất).
• load.allowSymlinkTargets: các thư mục đích thực đáng tin cậy mà những thư mục Skills được liên kết tượng trưng có thể phân giải vào, ngay cả khi liên kết tượng trưng nằm bên ngoài gốc đích đó. Dùng mục này cho các bố cục kho lưu trữ ngang hàng có chủ ý, chẳng hạn như ~/.agents/skills/manager -> ~/Projects/manager/skills.
• load.watch: theo dõi các thư mục Skills và làm mới ảnh chụp Skills (mặc định: true).
• load.watchDebounceMs: thời gian gom sự kiện cho trình theo dõi Skills, tính bằng mili giây (mặc định: 250).
• install.preferBrew: ưu tiên trình cài đặt brew khi có sẵn (mặc định: true).
• install.nodeManager: lựa chọn ưu tiên trình cài đặt Node (npm | pnpm | yarn | bun, mặc định: npm). Điều này chỉ ảnh hưởng đến cài đặt Skills; runtime Gateway vẫn nên là Node (không khuyến nghị dùng Bun cho WhatsApp/Telegram).
  • openclaw setup --node-manager có phạm vi hẹp hơn và hiện chấp nhận npm, pnpm, hoặc bun. Đặt skills.install.nodeManager: "yarn" thủ công nếu bạn muốn các lượt cài đặt Skills dựa trên Yarn.
• install.allowUploadedArchives: cho phép các máy khách Gateway operator.admin đáng tin cậy cài đặt kho nén zip riêng tư được chuẩn bị thông qua skills.upload.* (mặc định: false). Điều này chỉ bật luồng kho nén đã tải lên; các lượt cài đặt ClawHub thông thường không cần nó.
• entries.<skillKey>: ghi đè theo từng Skills.
• agents.defaults.skills: danh sách cho phép Skills mặc định tùy chọn được các tác tử kế thừa khi bỏ qua agents.list[].skills.
• agents.list[].skills: danh sách cho phép Skills cuối cùng tùy chọn theo từng tác tử; các danh sách rõ ràng thay thế mặc định kế thừa thay vì hợp nhất.

​

Kho lưu trữ ngang hàng được liên kết tượng trưng

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

• enabled: đặt false để tắt một Skills ngay cả khi nó được đóng gói kèm/đã cài đặt.
• env: các biến môi trường được chèn cho lượt chạy của tác tử (chỉ khi chưa được đặt).
• apiKey: tiện ích tùy chọn cho Skills khai báo một biến môi trường chính. Hỗ trợ chuỗi văn bản thuần hoặc đối tượng SecretRef ({ source, provider, id }).

​

Ghi chú

• Theo mặc định, các khóa dưới entries ánh xạ tới tên Skills. Nếu một Skills định nghĩa metadata.openclaw.skillKey, hãy dùng khóa đó thay thế.
• Thứ tự ưu tiên tải là <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → Skills đóng gói kèm → skills.load.extraDirs.
• Các thay đổi với Skills được nhận ở lượt tác tử tiếp theo khi trình theo dõi được bật.

​

Skills chạy trong môi trường cách ly và biến môi trường

• agents.defaults.sandbox.docker.env cho nền tảng Docker (hoặc agents.list[].sandbox.docker.env theo từng tác tử).
• Đưa biến môi trường vào ảnh môi trường cách ly tùy chỉnh hoặc môi trường cách ly từ xa của bạn.

​

Liên quan