ClawHub

ClawHub là registry công khai cho skills của OpenClaw. Đây là dịch vụ miễn phí: tất cả skills đều công khai, mở và hiển thị với 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 text hỗ trợ). Các bạn có thể duyệt skills trên web app hoặc dùng CLI để tìm kiếm, cài đặt, cập nhật và publish skills.

Trang web: clawhub.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, ClawHub là cách dễ nhất để tìm và cài đặt skills. 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 skills bằng ngôn ngữ tự nhiên.
  • Cài đặt skill vào workspace của bạn.
  • Cập nhật skills sau này chỉ với một lệnh.
  • Backup skills của riêng bạn bằng cách publish 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:
    • clawhub search "calendar"
  3. Cài đặt một skill:
    • clawhub 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 clawhub
pnpm add -g clawhub

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

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

Để biết chi tiết hơn về cách skills đượ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 skills 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.
  • Versioning với semver, changelogs và tags (bao gồm latest).
  • Downloads dưới dạng zip cho mỗi version.
  • Stars và comments để cộng đồng phản hồi.
  • Moderation hooks cho việc phê duyệt và kiểm tra.
  • CLI-friendly API cho automation 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ề OpenClaw workspace).
  • --dir <dir>: Thư mục skills, tương đối với workdir (mặc định: skills).
  • --site <url>: URL cơ sở của site (browser login).
  • --registry <url>: URL cơ sở của Registry API.
  • --no-input: Tắt prompts (non-interactive).
  • -V, --cli-version: In phiên bản CLI.

Xác thực:

  • clawhub login (browser flow) hoặc clawhub login --token <token>
  • clawhub logout
  • clawhub whoami

Tùy chọn:

  • --token <token>: Dán API token.
  • --label <label>: Label được lưu cho browser login tokens (mặc định: CLI token).
  • --no-browser: Không mở browser (yêu cầu --token).

Tìm kiếm:

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

Cài đặt:

  • 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.

Cập nhật:

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

Liệt kê:

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

Publish:

  • clawhub publish <path>
  • --slug <slug>: Skill slug.
  • --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>: Tags phân cách bằng dấu phẩy (mặc định: latest).

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

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

Sync (quét skills local + publish mới/đã cập nhật):

  • clawhub sync
  • --root <dir...>: Các thư mục gốc bổ sung để quét.
  • --all: Upload tất cả mà không cần prompts.
  • --dry-run: Hiển thị những gì sẽ được upload.
  • --bump <type>: patch|minor|major cho updates (mặc định: patch).
  • --changelog <text>: Changelog cho non-interactive updates.
  • --tags <tags>: Tags phân cách bằng dấu phẩy (mặc định: latest).
  • --concurrency <n>: Số lượng registry checks (mặc định: 4).

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

Tìm kiếm skills

clawhub search "postgres backups"

Download skills mới

clawhub install my-skill-pack

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

clawhub update --all

Backup skills của bạn (publish hoặc sync)

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

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

Để quét và backup nhiều skills cùng lúc:

clawhub sync --all

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

Versioning và tags

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

Thay đổi local vs registry versions

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

Quét sync và fallback roots

clawhub sync quét workdir hiện tại của các bạn trước. Nếu không tìm thấy skills, nó sẽ fallback về các vị trí legacy đã biết (ví dụ ~/openclaw/skills và ~/.openclaw/skills). Điều này được thiết kế để tìm các skill installs cũ hơn mà không cần thêm flags.

Storage và lockfile

  • Các skills đã cài được ghi lại trong .clawhub/lock.json trong workdir của các bạn.
  • Auth tokens được lưu trong file config của ClawHub CLI (override qua CLAWHUB_CONFIG_PATH).

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

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

export CLAWHUB_DISABLE_TELEMETRY=1

Biến môi trường

  • CLAWHUB_SITE: Override URL của site.
  • CLAWHUB_REGISTRY: Override URL của registry API.
  • CLAWHUB_CONFIG_PATH: Override nơi CLI lưu token/config.
  • CLAWHUB_WORKDIR: Override workdir mặc định.
  • CLAWHUB_DISABLE_TELEMETRY=1: Tắt telemetry trên sync.