Skills

• Bỏ qua agents.defaults.skills để mặc định không hạn chế bất kỳ Skills nào.
• Bỏ qua agents.list[].skills để kế thừa agents.defaults.skills.
• Đặt agents.list[].skills: [] để không cung cấp Skills nào cho tác nhân đó.
• Danh sách agents.list[].skills không rỗng là tập hợp cuối cùng — nó không hợp nhất với các giá trị mặc định.
• Danh sách cho phép có hiệu lực được áp dụng xuyên suốt quá trình tạo lời nhắc, phát hiện lệnh dấu gạch chéo, đồng bộ sandbox và ảnh chụp nhanh Skills.
• Đây không phải là ranh giới ủy quyền cho shell của máy chủ. Nếu cùng tác nhân đó có thể dùng exec, hãy hạn chế riêng shell bằng sandbox, cô lập người dùng hệ điều hành, danh sách từ chối/cho phép thực thi và thông tin xác thực riêng cho từng tài nguyên.

Theo mặc định, openclaw skills install cài đặt vào thư mục skills/ của không gian làm việc đ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 mọi tác nhân cục bộ trừ khi danh sách cho phép của tác nhân thu hẹp phạm vi đó.

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

openclaw skills verify @owner/<slug> yêu cầu ClawHub cung cấp phạm vi tin cậy clawhub.skill.verify.v1 của Skills. Các Skills ClawHub đã cài đặt được xác minh theo phiên bản và kho đăng ký được ghi trong .clawhub/origin.json. Các slug trần vẫn được chấp nhận đối với Skills đã cài đặt hoặc không mơ hồ, nhưng tham chiếu kèm chủ sở hữu giúp tránh nhập nhằng về nhà phát hành.

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

Các máy khách Gateway cần phương thức phân phối ngoài ClawHub có thể chuẩn bị một kho lưu trữ Skills dạng zip bằng skills.upload.begin, skills.upload.chunk và skills.upload.commit, sau đó cài đặt bằng skills.install({ source: "upload", ... }). Đường dẫn này mặc định bị tắt và yêu cầu skills.install.allowUploadedArchives: true trong openclaw.json. Các bản cài đặt ClawHub thông thường không bao giờ cần cài đặt đó.

Việc phát hiện Skills trong không gian làm việc, tác nhân của dự án và thư mục bổ sung chỉ chấp nhận các thư mục gốc Skills có đường dẫn thực đã phân giải nằm bên trong thư mục gốc được cấu hình, trừ khi skills.load.allowSymlinkTargets tin cậy rõ ràng một thư mục gốc đích. Xưởng Skills chỉ ghi thông qua các đích tin cậy đó khi skills.workshop.allowSymlinkTargetWrites được bật. Thư mục được quản lý ~/.openclaw/skills và thư mục cá nhân ~/.agents/skills có thể chứa các thư mục Skills được liên kết tượng trưng, nhưng đường dẫn thực của mọi SKILL.md vẫn phải nằm bên trong thư mục Skills đã phân giải tương ứng.

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 Skills. Chính sách nhận siêu dữ liệu và đường dẫn nguồn đã chuẩn bị, áp dụng cho các đường dẫn ClawHub, tải lên, Git, cục bộ, cập nhật và trình cài đặt phần phụ thuộc, đồng thời từ chối theo mặc định khi lệnh không thể trả về một quyết định hợp lệ.

skills.entries.*.env và skills.entries.*.apiKey chỉ chèn bí mật vào tiến trình máy chủ trong lượt tác nhân đó — không chèn vào sandbox. Không đưa bí mật vào lời nhắc và nhật ký.

• Khi liệt kê nhiều trình cài đặt, Gateway chọn một phương án ưu tiên (brew nếu khả dụng, nếu không thì node).
• Nếu tất cả trình cài đặt đều là download, OpenClaw liệt kê từng mục để bạn có thể xem tất cả tạo tác khả dụng.
• Đặc tả có thể bao gồm os: ["darwin"|"linux"|"win32"] để lọc theo nền tảng.
• Các bản cài đặt Node tuân theo skills.install.nodeManager trong openclaw.json (mặc định: npm; các tùy chọn: npm / pnpm / yarn / bun). Điều này chỉ ảnh hưởng đến việc cài đặt skill; môi trường chạy Gateway vẫn nên là Node.
• Thứ tự ư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.

• Homebrew: OpenClaw không tự động cài đặt Homebrew hoặc chuyển đổi các công thức brew thành lệnh gói hệ thống. Trong các bộ chứa Linux không có brew, trình cài đặt chỉ hỗ trợ brew sẽ bị ẩn; hãy dùng ảnh tùy chỉnh hoặc cài đặt phần phụ thuộc theo cách thủ công.
• Go: OpenClaw yêu cầu Go 1.21 trở lên để tự động cài đặt skill. Nếu thiếu go và có Homebrew, OpenClaw sẽ cài đặt Go qua Homebrew trước; trên Linux không có Homebrew, hệ thống có thể dùng apt-get với quyền root hoặc thông qua sudo không cần mật khẩu nếu ứng viên golang-go sau khi làm mới đáp ứng phiên bản tối thiểu. Lệnh go install thực tế cho phần phụ thuộc luôn nhắm đến một thư mục bin chuyên dụng do OpenClaw quản lý (bin của Homebrew trên bản cài đặt mới, nếu không thì ~/.local/bin) thay vì GOBIN đã cấu hình của bạn — các biến môi trường GOBIN, GOPATH và GOTOOLCHAIN của bạn được đọc nhưng không bao giờ bị ghi đè.
• Tải xuống: url (bắt buộc), archive (tar.gz | tar.bz2 | zip), extract (mặc định: tự động khi phát hiện tệp lưu trữ), stripComponents, targetDir (mặc định: ~/.openclaw/tools/<skillKey>).

requires.bins được kiểm tra trên máy chủ tại thời điểm tải skill. Nếu tác tử chạy trong môi trường cách ly, tệp nhị phân cũng phải tồn tại bên trong bộ chứa. Hãy cài đặt tệp đó qua agents.defaults.sandbox.docker.setupCommand hoặc một ảnh tùy chỉnh. setupCommand chạy một lần sau khi tạo bộ chứa và yêu cầu quyền truy cập mạng ra ngoài, hệ thống tệp gốc có thể ghi và người dùng root trong môi trường cách ly.

Theo mặc định, OpenClaw theo dõi các thư mục skill và cập nhật bản chụp khi các tệp SKILL.md thay đổi. Cấu hình trong skills.load:

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

Dùng allowSymlinkTargets cho các bố cục liên kết tượng trưng có chủ đích, trong đó liên kết tượng trưng gốc của skill trỏ ra ngoài thư mục 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 cần áp dụng các đề xuất thông qua những đường dẫn liên kết tượng trưng đáng tin cậy đó.

Nếu Gateway chạy trên Linux nhưng một node macOS được kết nối và cho phép system.run, OpenClaw có thể coi các skill chỉ dành cho macOS là đủ điều kiện khi các tệp nhị phân cần thiết có trên node đó. Tác tử nên chạy các skill này qua công cụ exec với host=node.

Các node ngoại tuyến không làm cho các skill chỉ dùng từ xa hiển thị. Nếu một node ngừng phản hồi các phép dò tệp nhị phân, OpenClaw sẽ xóa các kết quả khớp tệp nhị phân đã lưu trong bộ nhớ đệm của node đó.