​

ClawHub

​

ClawHub là gì

• Đăng ký công khai cho các kỹ năng của OpenClaw.
• Kho lưu trữ phiên bản của các gói kỹ năng và metadata.
• Nền tảng khám phá cho tìm kiếm, thẻ và tín hiệu sử dụng.

​

Cách hoạt động

1. Người dùng xuất bản một gói kỹ năng (file + metadata).
2. ClawHub lưu trữ gói, phân tích metadata và gán phiên bản.
3. Đăng ký lập chỉ mục kỹ năng để tìm kiếm và khám phá.
4. Người dùng duyệt, tải xuống và cài đặt kỹ năng trong OpenClaw.

​

Bạn có thể làm gì

• Xuất bản kỹ năng mới và phiên bản mới của kỹ năng hiện có.
• Khám phá kỹ năng theo tên, thẻ hoặc tìm kiếm.
• Tải xuống gói kỹ năng và kiểm tra các file của chúng.
• Báo cáo kỹ năng có nội dung lạm dụng hoặc không an toàn.
• Nếu bạn là người điều hành, có thể ẩn, hiện, xóa hoặc cấm.

​

Dành cho ai (thân thiện với người mới bắt đầu)

• Tìm kiếm kỹ năng bằng ngôn ngữ đơn giản.
• Cài đặt kỹ năng vào workspace.
• Cập nhật kỹ năng sau này chỉ với một lệnh.
• Sao lưu kỹ năng của mình bằng cách xuất bản chúng.

​

Bắt đầu nhanh (không cần kỹ thuật)

1. Cài đặt CLI (xem phần tiếp theo).
2. Tìm kiếm thứ bạn cần:
   • clawhub search "calendar"
3. Cài đặt một kỹ năng:
   • clawhub install <skill-slug>
4. Bắt đầu một phiên OpenClaw mới để nhận kỹ năng mới.

​

Cài đặt CLI

npm i -g clawhub

pnpm add -g clawhub

​

Cách tích hợp vào OpenClaw

​

Tổng quan về hệ thống kỹ năng

• File SKILL.md với mô tả chính và cách sử dụng.
• Các cấu hình, script hoặc file hỗ trợ tùy chọn được sử dụng bởi kỹ năng.
• Metadata như thẻ, tóm tắt và yêu cầu cài đặt.

​

Dịch vụ cung cấp (tính năng)

• Duyệt công khai các kỹ năng và nội dung SKILL.md.
• Tìm kiếm được hỗ trợ bởi embeddings (tìm kiếm vector), không chỉ từ khóa.
• Phiên bản với semver, changelogs và thẻ (bao gồm latest).
• Tải xuống dưới dạng zip cho mỗi phiên bản.
• Sao và bình luận để phản hồi từ cộng đồng.
• Công cụ điều hành cho phê duyệt và kiểm tra.
• API thân thiện với CLI cho tự động hóa và scripting.

​

Bảo mật và điều hành

• Bất kỳ người dùng đã đăng nhập nào cũng có thể báo cáo một kỹ năng.
• Lý do báo cáo là bắt buộc và được ghi lại.
• Mỗi người dùng có thể có tối đa 20 báo cáo hoạt động cùng lúc.
• Kỹ năng có hơn 3 báo cáo duy nhất sẽ tự động bị ẩn theo mặc định.
• Người điều hành có thể xem kỹ năng bị ẩn, hiện chúng, xóa hoặc cấm người dùng.
• Lạm dụng tính năng báo cáo có thể dẫn đến cấm tài khoản.

​

Lệnh và tham số CLI

• --workdir <dir>: Thư mục làm việc (mặc định: thư mục hiện tại; sử dụng workspace OpenClaw nếu có).
• --dir <dir>: Thư mục kỹ năng, tương đối với workdir (mặc định: skills).
• --site <url>: URL cơ sở của trang web (đăng nhập trình duyệt).
• --registry <url>: URL cơ sở của API đăng ký.
• --no-input: Tắt nhắc nhở (không tương tác).
• -V, --cli-version: In phiên bản CLI.

• clawhub login (dòng trình duyệt) hoặc clawhub login --token <token>
• clawhub logout
• clawhub whoami

• --token <token>: Dán một token API.
• --label <label>: Nhãn lưu trữ cho token đăng nhập trình duyệt (mặc định: CLI token).
• --no-browser: Không mở trình duyệt (yêu cầu --token).

• clawhub search "query"
• --limit <n>: Kết quả tối đa.

• clawhub install <slug>
• --version <version>: Cài đặt một phiên bản cụ thể.
• --force: Ghi đè nếu thư mục đã tồn tại.

• clawhub update <slug>
• clawhub update --all
• --version <version>: Cập nhật lên một phiên bản cụ thể (chỉ một slug).
• --force: Ghi đè khi file cục bộ không khớp với bất kỳ phiên bản nào đã xuất bản.

• clawhub list (đọc .clawhub/lock.json)

• clawhub publish <path>
• --slug <slug>: Slug kỹ năng.
• --name <name>: Tên hiển thị.
• --version <version>: Phiên bản semver.
• --changelog <text>: Văn bản changelog (có thể để trống).
• --tags <tags>: Thẻ phân tách bằng dấu phẩy (mặc định: latest).

• clawhub delete <slug> --yes
• clawhub undelete <slug> --yes

• clawhub sync
• --root <dir...>: Gốc quét bổ sung.
• --all: Tải lên tất cả mà không cần nhắc nhở.
• --dry-run: Hiển thị những gì sẽ được tải lên.
• --bump <type>: patch|minor|major cho cập nhật (mặc định: patch).
• --changelog <text>: Changelog cho cập nhật không tương tác.
• --tags <tags>: Thẻ phân tách bằng dấu phẩy (mặc định: latest).
• --concurrency <n>: Kiểm tra đăng ký (mặc định: 4).

​

Quy trình làm việc phổ biến cho agent

​

Tìm kiếm kỹ năng

clawhub search "postgres backups"

​

Tải xuống kỹ năng mới

clawhub install my-skill-pack

​

Cập nhật kỹ năng đã cài đặt

clawhub update --all

​

Sao lưu kỹ năng của bạn (xuất bản hoặc đồng bộ)

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

clawhub sync --all

​

Chi tiết nâng cao (kỹ thuật)

​

Phiên bản và thẻ

• Mỗi lần xuất bản tạo ra một semver SkillVersion.
• Thẻ (như latest) trỏ đến một phiên bản; di chuyển thẻ cho phép bạn quay lại.
• Changelogs được đính kèm cho mỗi phiên bản và có thể để trống khi đồng bộ hoặc xuất bản cập nhật.

​

Thay đổi cục bộ so với phiên bản đăng ký

​

Quét đồng bộ và gốc dự phòng

​

Lưu trữ và file khóa

• Kỹ năng đã cài đặt được ghi lại trong .clawhub/lock.json dưới thư mục làm việc của bạn.
• Token xác thực được lưu trữ trong file cấu hình ClawHub CLI (ghi đè qua CLAWHUB_CONFIG_PATH).

​

Telemetry (đếm lượt cài đặt)

export CLAWHUB_DISABLE_TELEMETRY=1

​

Biến môi trường

• CLAWHUB_SITE: Ghi đè URL trang web.
• CLAWHUB_REGISTRY: Ghi đè URL API đăng ký.
• CLAWHUB_CONFIG_PATH: Ghi đè nơi CLI lưu trữ token/cấu hình.
• CLAWHUB_WORKDIR: Ghi đè thư mục làm việc mặc định.
• CLAWHUB_DISABLE_TELEMETRY=1: Tắt telemetry khi sync.