CLI commands
Skills
openclaw skills
Kiểm tra Skills cục bộ, tìm kiếm ClawHub, cài đặt kỹ năng từ ClawHub/Git/thư mục cục bộ, xác minh kỹ năng ClawHub, và cập nhật các bản cài đặt được ClawHub theo dõi.
Liên quan:
- Hệ thống Skills: Skills
- Xưởng kỹ năng: Xưởng kỹ năng
- Cấu hình Skills: Cấu hình Skills
- Bản cài đặt ClawHub: ClawHub
Lệnh
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update, và verify dùng trực tiếp ClawHub. install @owner/<slug>
cài đặt một kỹ năng ClawHub, install git:owner/repo[@ref] sao chép một kỹ năng Git, và
install ./path sao chép một thư mục kỹ năng cục bộ. Theo mặc định, install, update,
và verify nhắm tới thư mục skills/ của không gian làm việc đang hoạt động; với --global,
chúng nhắm tới thư mục Skills được quản lý dùng chung. list/info/check vẫn
kiểm tra các kỹ năng cục bộ mà không gian làm việc và cấu hình hiện tại có thể thấy.
Các lệnh dựa trên không gian làm việc phân giải không gian làm việc đích từ --agent <id>, rồi đến
thư mục làm việc hiện tại khi nó nằm trong một không gian làm việc tác tử đã cấu hình,
rồi đến tác tử mặc định.
Các bản cài đặt Git và thư mục cục bộ yêu cầu SKILL.md ở gốc nguồn. Slug
cài đặt lấy từ frontmatter name của SKILL.md khi hợp lệ, sau đó đến
thư mục nguồn hoặc tên kho lưu trữ; dùng --as <slug> để ghi đè. --version
chỉ dành cho ClawHub. Các bản cài đặt kỹ năng không hỗ trợ đặc tả gói npm hoặc
đường dẫn zip/lưu trữ, và openclaw skills update chỉ cập nhật các bản cài đặt được ClawHub theo dõi.
Các bản cài đặt phụ thuộc kỹ năng dựa trên Gateway được kích hoạt từ quá trình onboarding hoặc phần cài đặt Skills
dùng đường dẫn yêu cầu skills.install riêng.
Ghi chú:
search [query...]chấp nhận truy vấn tùy chọn; bỏ qua để duyệt nguồn tìm kiếm ClawHub mặc định.search --limit <n>giới hạn số kết quả trả về.install git:owner/repo[@ref]cài đặt một kỹ năng Git. Tham chiếu nhánh có thể chứa dấu gạch chéo, chẳng hạngit:owner/repo@feature/foo.install ./path/to/skillcài đặt một thư mục cục bộ có gốc chứaSKILL.md.install --as <slug>ghi đè slug được suy ra cho các bản cài đặt từ Git và thư mục cục bộ.install --version <version>chỉ áp dụng cho tham chiếu kỹ năng ClawHub.install --forceghi đè thư mục kỹ năng hiện có trong không gian làm việc cho cùng slug.- Các bản cài đặt và cập nhật kỹ năng ClawHub cộng đồng kiểm tra độ tin cậy trước khi tải xuống.
Các bản phát hành lưu trữ cộng đồng có phiên bản dùng siêu dữ liệu tin cậy theo đúng bản phát hành.
Các kỹ năng GitHub dựa trên bộ phân giải dựa vào bộ phân giải cài đặt của ClawHub để thực thi
chính sách quét và buộc cài đặt trước khi trả về một commit đã ghim. Các bản phát hành cộng đồng độc hại hoặc
bị chặn sẽ bị từ chối. Các bản phát hành cộng đồng rủi ro yêu cầu
xem xét và
--acknowledge-clawhub-riskkhi một lệnh không tương tác cần tiếp tục sau quá trình xem xét đó. Nhà xuất bản kỹ năng ClawHub chính thức và các nguồn kỹ năng OpenClaw đi kèm bỏ qua lời nhắc tin cậy bản phát hành này. --globalnhắm tới thư mục Skills được quản lý dùng chung và không thể kết hợp với--agent <id>.--agent <id>nhắm tới một không gian làm việc tác tử đã cấu hình và ghi đè suy luận thư mục làm việc hiện tại.update @owner/<slug>cập nhật một kỹ năng được theo dõi. Thêm--globalđể nhắm tới thư mục Skills được quản lý dùng chung thay vì không gian làm việc.update --allcập nhật các bản cài đặt ClawHub được theo dõi trong không gian làm việc đã chọn, hoặc trong thư mục Skills được quản lý dùng chung khi kết hợp với--global.verify @owner/<slug>mặc định in phong bì JSONclawhub.skill.verify.v1của ClawHub. Không có cờ--jsonvì JSON đã là mặc định. Slug trần vẫn được chấp nhận để tương thích khi kỹ năng đã được cài đặt hoặc không mơ hồ, nhưng tham chiếu có chủ sở hữu tránh nhầm lẫn nhà xuất bản.- Khi ClawHub trả về nguồn gốc mã nguồn do máy chủ phân giải, JSON xác minh cũng
bao gồm
openclaw.verifiedSourceUrlđược ghim theo commit. URL nguồn không khả dụng hoặc tự khai báo chỉ ở lại trong phong bì nguồn gốc thô và không được nâng cấp. verifydùng.clawhub/origin.jsoncho các kỹ năng ClawHub đã cài đặt, nên nó xác minh phiên bản đã cài đặt theo registry nguồn của nó.--versionvà--tagghi đè bộ chọn phiên bản nhưng vẫn giữ registry đã cài đặt đó khi có siêu dữ liệu nguồn gốc.verify --cardin Markdown Thẻ kỹ năng được tạo thay vì JSON. Lệnh thoát khác 0 khi ClawHub trả vềok: falsehoặcdecision: "fail"; chữ ký chưa ký chỉ mang tính thông tin trừ khi chính sách ClawHub thay đổi.- Các gói ClawHub đã cài đặt có thể bao gồm
skill-card.mdđược tạo. OpenClaw xem xác minh là quyết định của máy chủ ClawHub và không từ chối một kỹ năng đã cài đặt chỉ vì thẻ được tạo đó thay đổi dấu vân tay của gói. check --agent <id>kiểm tra không gian làm việc của tác tử đã chọn và báo cáo những kỹ năng sẵn sàng nào thật sự hiển thị với prompt hoặc bề mặt lệnh của tác tử đó.listlà hành động mặc định khi không cung cấp lệnh con.list,info, vàcheckghi đầu ra đã kết xuất vào stdout. Với--json, điều đó nghĩa là payload máy đọc được vẫn nằm trên stdout cho pipe và script.
Xưởng kỹ năng
openclaw skills workshop quản lý các đề xuất kỹ năng đang chờ trong
không gian làm việc đã chọn. Đề xuất chưa phải là kỹ năng hoạt động cho đến khi được áp dụng. Để biết về nơi lưu trữ đề xuất,
biện pháp bảo vệ tệp hỗ trợ, phương thức Gateway, và chính sách phê duyệt, xem
Xưởng kỹ năng.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"