Bắt đầu nhanh

ClawHub là một registry dành cho Skills và Plugin của OpenClaw.

Sử dụng OpenClaw khi bạn cài đặt nội dung vào OpenClaw. Sử dụng CLI clawhub khi bạn đăng nhập, xuất bản, quản lý các mục niêm yết của riêng mình hoặc sử dụng các quy trình dành riêng cho registry.

Tìm và cài đặt một skill

Tìm kiếm từ OpenClaw:

openclaw skills search "calendar"

Cài đặt một skill:

openclaw skills install @openclaw/demo

Cập nhật các skill đã cài đặt:

openclaw skills update --all

OpenClaw ghi lại nguồn của skill để các bản cập nhật sau này có thể tiếp tục được phân giải thông qua ClawHub.

Tìm và cài đặt một Plugin

Tìm kiếm từ OpenClaw:

openclaw plugins search "calendar"

Cài đặt một Plugin được lưu trữ trên ClawHub với nguồn ClawHub được chỉ định rõ ràng:

openclaw plugins install clawhub:<package>

Cập nhật các Plugin đã cài đặt:

openclaw plugins update --all

Sử dụng tiền tố clawhub: khi bạn muốn OpenClaw phân giải gói thông qua ClawHub thay vì npm hoặc một nguồn khác.

Đăng nhập để xuất bản

Cài đặt CLI ClawHub:

npm i -g clawhub# hoặcpnpm add -g clawhub

Đăng nhập bằng GitHub:

clawhub loginclawhub whoami

Các môi trường không có giao diện có thể sử dụng token API từ giao diện web ClawHub:

clawhub login --token clh_...

Xuất bản một skill

Skill là một thư mục có tệp SKILL.md bắt buộc và các tệp hỗ trợ tùy chọn.

clawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --changelog "Initial release"

Lệnh này bỏ qua nội dung không thay đổi. Skill mới bắt đầu ở 1.0.0; các thay đổi sau đó tự động xuất bản phiên bản vá tiếp theo. Sử dụng --dry-run để xem trước hoặc --version để chọn phiên bản cụ thể.

Trước khi xuất bản, hãy kiểm tra metadata trong SKILL.md. Khai báo các biến môi trường, công cụ và quyền bắt buộc để người dùng có thể hiểu skill cần gì trước khi cài đặt. Xem Định dạng skill.

Đối với các repository chứa nhiều skill, workflow GitHub có thể tái sử dụng sẽ gọi skill publish cho từng thư mục skill trực tiếp bên dưới skills/:

jobs:  preview:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      dry_run: true

Xuất bản một Plugin

Xuất bản một Plugin từ thư mục cục bộ, repository GitHub, ref GitHub hoặc kho lưu trữ hiện có:

clawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin

Trước tiên, hãy sử dụng --dry-run để xem trước metadata gói đã phân giải, các trường tương thích, thông tin nguồn và kế hoạch tải lên mà không xuất bản.

Các Plugin mã phải bao gồm metadata tương thích với OpenClaw trong package.json, bao gồm openclaw.compat.pluginApi và openclaw.build.openclawVersion.

Kiểm tra trước khi cài đặt

Trước khi cài đặt, hãy sử dụng trang web ClawHub hoặc các lệnh chi tiết của CLI để kiểm tra metadata, liên kết nguồn, phiên bản, nhật ký thay đổi và trạng thái quét:

clawhub inspect @openclaw/democlawhub package inspect <package>

Các mục niêm yết công khai hiển thị trạng thái quét mới nhất. Những bản phát hành bị giữ lại hoặc chặn bởi quy trình kiểm duyệt có thể bị ẩn khỏi các giao diện tìm kiếm và cài đặt cho đến khi được giải quyết.