ClawdHub

ClawdHub là kho Skill công khai cho OpenClaw. Đây là dịch vụ miễn phí: tất cả Skill đều công khai, mở và hiển thị cho mọi người để chia sẻ và tái sử dụng. Một Skill chỉ đơn giản là một thư mục có file SKILL.md (cùng các file văn bản hỗ trợ). Các bạn có thể duyệt Skill trên web app hoặc dùng CLI để tìm kiếm, cài đặt, cập nhật và xuất bản Skill.

Website: clawdhub.com

Dành cho ai (thân thiện với người mới)

Nếu các bạn muốn thêm khả năng mới cho OpenClaw Agent của mình, ClawdHub là cách dễ nhất để tìm và cài đặt Skill. Các bạn không cần biết backend hoạt động như thế nào. Các bạn có thể:

  • Tìm kiếm Skill bằng ngôn ngữ tự nhiên.
  • Cài đặt Skill vào Workspace của bạn.
  • Cập nhật Skill sau này chỉ với một lệnh.
  • Sao lưu Skill của riêng bạn 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ứ các bạn cần:
    • clawdhub search "calendar"
  3. Cài đặt một Skill:
    • clawdhub install <skill-slug>
  4. Khởi động Session OpenClaw mới để nó nhận Skill mới.

Cài đặt CLI

Chọn một trong hai:

npm i -g clawdhub
pnpm add -g clawdhub

Cách tích hợp với OpenClaw

Mặc định, CLI cài đặt Skill vào ./skills trong thư mục làm việc hiện tại của các bạn. Nếu đã cấu hình Workspace OpenClaw, clawdhub sẽ fallback về Workspace đó trừ khi các bạn override bằng --workdir (hoặc CLAWDHUB_WORKDIR). OpenClaw load Workspace Skill từ <workspace>/skills và sẽ nhận chúng trong Session tiếp theo. Nếu các bạn đã dùng ~/.clawdbot/skills hoặc bundled Skill, Workspace Skill sẽ được ưu tiên.

Để biết thêm chi tiết về cách Skill được load, chia sẻ và kiểm soát, xem Skills.

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

  • Duyệt công khai các Skill và nội dung SKILL.md của chúng.
  • Tìm kiếm được hỗ trợ bởi Embeddings (vector search), không chỉ từ khóa.
  • Quản lý phiên bản với semver, changelog và tag (bao gồm latest).
  • Tải về dưới dạng file zip cho mỗi phiên bản.
  • Đánh giá sao và bình luận để cộng đồng phản hồi.
  • Hook kiểm duyệt cho phê duyệt và kiểm toán.
  • API thân thiện với CLI cho tự động hóa và scripting.

Lệnh CLI và tham số

Tùy chọn toàn cục (áp dụng cho tất cả lệnh):

  • --workdir <dir>: Thư mục làm việc (mặc định: thư mục hiện tại; fallback về Workspace OpenClaw).
  • --dir <dir>: Thư mục Skill, tương đối với workdir (mặc định: skills).
  • --site <url>: URL gốc của site (đăng nhập qua trình duyệt).
  • --registry <url>: URL gốc của Registry API.
  • --no-input: Tắt prompt (chế độ không tương tác).
  • -V, --cli-version: In phiên bản CLI.

Xác thực:

  • clawdhub login (qua trình duyệt) hoặc clawdhub login --token <token>
  • clawdhub logout
  • clawdhub whoami

Tùy chọn:

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

Tìm kiếm:

  • clawdhub search "query"
  • --limit <n>: Số kết quả tối đa.

Cài đặt:

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

Cập nhật:

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

Liệt kê:

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

Xuất bản:

  • clawdhub publish <path>
  • --slug <slug>: Slug của Skill.
  • --name <name>: Tên hiển thị.
  • --version <version>: Phiên bản semver.
  • --changelog <text>: Nội dung changelog (có thể để trống).
  • --tags <tags>: Các tag phân cách bằng dấu phẩy (mặc định: latest).

Xóa/khôi phục (chỉ owner/admin):

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

Đồng bộ (quét Skill local + xuất bản mới/cập nhật):

  • clawdhub sync
  • --root <dir...>: Thư mục gốc bổ sung để quét.
  • --all: Upload tất cả mà không cần prompt.
  • --dry-run: Hiển thị những gì sẽ được upload.
  • --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>: Các tag phân cách bằng dấu phẩy (mặc định: latest).
  • --concurrency <n>: Số lượng kiểm tra Registry đồng thời (mặc định: 4).

Quy trình thường dùng cho Agent

Tìm kiếm Skill

clawdhub search "postgres backups"

Tải Skill mới

clawdhub install my-skill-pack

Cập nhật Skill đã cài

clawdhub update --all

Sao lưu Skill của bạn (publish hoặc sync)

Với một thư mục Skill đơn lẻ:

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

Để quét và sao lưu nhiều Skill cùng lúc:

clawdhub sync --all

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

Quản lý phiên bản và tag

  • Mỗi lần publish tạo một semver SkillVersion mới.
  • Các tag (như latest) trỏ đến một phiên bản; di chuyển tag cho phép bạn rollback.
  • Changelog được đính kèm cho mỗi phiên bản và có thể để trống khi sync hoặc publish cập nhật.

Thay đổi local so với phiên bản registry

Cập nhật so sánh nội dung Skill local với các phiên bản registry bằng content hash. Nếu file local không khớp với bất kỳ phiên bản đã xuất bản nào, CLI sẽ hỏi trước khi ghi đè (hoặc yêu cầu --force trong chế độ không tương tác).

Quét sync và thư mục fallback

clawdhub sync quét workdir hiện tại của bạn trước. Nếu không tìm thấy Skill nào, nó sẽ fallback về các vị trí legacy đã biết (ví dụ ~/openclaw/skills và ~/.clawdbot/skills). Điều này được thiết kế để tìm các Skill cài đặt cũ mà không cần flag bổ sung.

Lưu trữ và lockfile

  • Các Skill đã cài được ghi lại trong .clawdhub/lock.json trong workdir của bạn.
  • Auth token được lưu trong file config ClawdHub CLI (override qua CLAWDHUB_CONFIG_PATH).

Telemetry (số lượt cài đặt)

Khi các bạn chạy clawdhub sync trong khi đã đăng nhập, CLI gửi một snapshot tối thiểu để tính số lượt cài đặt. Các bạn có thể tắt hoàn toàn:

export CLAWDHUB_DISABLE_TELEMETRY=1

Biến môi trường

  • CLAWDHUB_SITE: Override URL của site.
  • CLAWDHUB_REGISTRY: Override URL của Registry API.
  • CLAWDHUB_CONFIG_PATH: Override vị trí CLI lưu token/config.
  • CLAWDHUB_WORKDIR: Override workdir mặc định.
  • CLAWDHUB_DISABLE_TELEMETRY=1: Tắt telemetry khi sync.