Skills

ClawHub

ClawHub là registry công khai dành cho Skills và Plugin của OpenClaw.

  • Dùng các lệnh openclaw native để tìm kiếm, cài đặt và cập nhật Skills, cũng như cài đặt Plugin từ ClawHub.
  • Dùng CLI clawhub riêng cho các quy trình xác thực registry, xuất bản, xóa/khôi phục xóa và đồng bộ.

Trang web: clawhub.ai

Bắt đầu nhanh

  • Tìm kiếm

    openclaw skills search "calendar"
    
  • Cài đặt

    openclaw skills install <skill-slug>
    
  • Sử dụng

    Bắt đầu một phiên OpenClaw mới - phiên đó sẽ nhận Skills mới.

  • Xuất bản (tùy chọn)

    Đối với các quy trình đã xác thực với registry (xuất bản, đồng bộ, quản lý), hãy cài đặt CLI clawhub riêng:

    npm i -g clawhub
    # or
    pnpm add -g clawhub
    
  • Luồng OpenClaw native

    Skills

    openclaw skills search "calendar"
    openclaw skills install <skill-slug>
    openclaw skills update --all
    

    Các lệnh openclaw native cài đặt vào workspace đang hoạt động của bạn và lưu metadata nguồn để các lệnh update sau này vẫn có thể dùng ClawHub.

    Plugins

    openclaw plugins search "calendar"
    openclaw plugins install clawhub:<package>
    openclaw plugins update --all
    

    plugins search truy vấn catalog Plugin của ClawHub và in ra các tên package sẵn sàng cài đặt. Dùng clawhub:<package> khi bạn muốn phân giải qua ClawHub. Các đặc tả Plugin npm-safe dạng trần sẽ cài đặt từ npm trong giai đoạn chuyển đổi khi ra mắt:

    openclaw plugins install openclaw-codex-app-server
    

    npm:<package> cũng chỉ dùng npm và hữu ích khi một đặc tả có thể bị mơ hồ:

    openclaw plugins install npm:openclaw-codex-app-server
    

    Các bản cài đặt Plugin xác thực khả năng tương thích pluginApiminGatewayVersion được công bố trước khi quá trình cài đặt archive chạy, vì vậy các host không tương thích sẽ thất bại đóng sớm thay vì cài đặt một phần package. Khi một phiên bản package xuất bản artifact ClawPack, OpenClaw ưu tiên .tgz npm-pack đã tải lên chính xác, xác minh header digest ClawHub và các byte đã tải xuống, đồng thời ghi lại loại artifact, integrity npm, shasum npm, tên tarball và metadata digest ClawPack cho các lần cập nhật sau này. Các phiên bản package cũ hơn không có metadata ClawPack vẫn dùng đường dẫn xác minh archive package legacy.

    ClawHub là gì

    • Một registry công khai dành cho Skills và Plugin của OpenClaw.
    • Một kho có phiên bản cho các gói Skills và metadata.
    • Một bề mặt khám phá cho tìm kiếm, thẻ và tín hiệu sử dụng.

    Một Skills điển hình là một gói tệp có phiên bản, bao gồm:

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

    ClawHub dùng metadata để hỗ trợ khám phá và cung cấp an toàn các khả năng của Skills. Registry theo dõi tín hiệu sử dụng (sao, lượt tải xuống) để cải thiện xếp hạng và mức độ hiển thị. Mỗi lần xuất bản tạo một phiên bản semver mới, và registry lưu lịch sử phiên bản để người dùng có thể audit các thay đổi.

    Workspace và tải Skills

    CLI clawhub riêng cũng cài đặt Skills vào ./skills dưới thư mục làm việc hiện tại của bạn. Nếu một workspace OpenClaw đã được cấu hình, clawhub sẽ fallback về workspace đó trừ khi bạn ghi đè bằng --workdir (hoặc CLAWHUB_WORKDIR). OpenClaw tải Skills của workspace từ <workspace>/skills và nhận chúng trong phiên tiếp theo.

    Nếu bạn đã dùng ~/.openclaw/skills hoặc Skills đi kèm, Skills trong workspace sẽ được ưu tiên. Để biết thêm chi tiết về cách Skills được tải, chia sẻ và kiểm soát, xem Skills.

    Tính năng dịch vụ

    Tính năng Ghi chú
    Duyệt công khai Skills và nội dung SKILL.md của chúng có thể được xem công khai.
    Tìm kiếm Được hỗ trợ bởi embedding (tìm kiếm vector), không chỉ từ khóa.
    Phiên bản hóa Semver, changelog và thẻ (bao gồm latest).
    Tải xuống Zip theo từng phiên bản.
    Sao và bình luận Phản hồi cộng đồng.
    Tóm tắt quét bảo mật Trang chi tiết hiển thị trạng thái quét mới nhất trước khi cài đặt hoặc tải xuống.
    Trang chi tiết scanner Kết quả VirusTotal, ClawScan và phân tích tĩnh có liên kết sâu.
    Bảng điều khiển khôi phục của owner Publisher có thể xem nội dung thuộc sở hữu đang bị giữ do quét từ /dashboard.
    Owner yêu cầu quét lại Owner có thể yêu cầu quét lại giới hạn để khôi phục lỗi dương tính giả.
    Điều phối nội dung Phê duyệt và audit.
    API thân thiện với CLI Phù hợp cho tự động hóa và script.

    Bảo mật và điều phối

    ClawHub mặc định là mở - bất kỳ ai cũng có thể tải Skills lên, nhưng tài khoản GitHub phải có ít nhất một tuần tuổi để xuất bản. Điều này làm chậm lạm dụng mà không chặn các contributor hợp lệ.

    Quét bảo mật

    ClawHub chạy các kiểm tra bảo mật tự động trên Skills và bản phát hành Plugin đã xuất bản. Các trang chi tiết công khai tóm tắt kết quả hiện tại, và các hàng scanner liên kết đến trang chi tiết riêng cho VirusTotal, ClawScan và phân tích tĩnh.

    Các bản phát hành bị giữ do quét hoặc bị chặn có thể không khả dụng trên catalog công khai và bề mặt cài đặt, nhưng vẫn hiển thị với owner của chúng trong /dashboard.

    Báo cáo
    • Bất kỳ người dùng đã đăng nhập nào cũng có thể báo cáo một Skills.
    • 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 đang hoạt động cùng lúc.
    • Skills có hơn 3 báo cáo duy nhất sẽ mặc định bị tự động ẩn.
    Điều phối
    • Moderator có thể xem Skills bị ẩn, bỏ ẩn, 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 việc tài khoản bị cấm.
    • Muốn trở thành moderator? Hãy hỏi trong Discord OpenClaw và liên hệ với moderator hoặc maintainer.

    CLI ClawHub

    Bạn chỉ cần phần này cho các quy trình đã xác thực với registry như xuất bản/đồng bộ.

    Tùy chọn toàn cục

    "--workdir
    "--dir
    "--site
    "--registry
    --no-inputboolean

    Tắt prompt (không tương tác).

    -V, --cli-versionboolean

    In phiên bản CLI.

    Lệnh

    Xác thực (đăng nhập / đăng xuất / whoami)
    clawhub login              # browser flow
    clawhub login --token <token>
    clawhub logout
    clawhub whoami
    

    Tùy chọn đăng nhập:

    • --token <token> - dán token API.
    • --label <label> - nhãn được lưu cho token đăng nhập bằng 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
    clawhub search "query"
    

    Tìm kiếm Skills. Để khám phá Plugin/package, dùng clawhub package explore.

    • --limit <n> - số kết quả tối đa.
    Duyệt / kiểm tra Plugin
    clawhub package explore --family code-plugin
    clawhub package explore "episodic-claw" --family code-plugin
    clawhub package inspect episodic-claw
    

    package explorepackage inspect là các bề mặt CLI ClawHub để khám phá Plugin/package và kiểm tra metadata. Các bản cài đặt OpenClaw native vẫn dùng openclaw plugins install clawhub:<package>.

    Tùy chọn:

    • --family skill|code-plugin|bundle-plugin - lọc họ package.
    • --official - chỉ hiển thị package chính thức.
    • --executes-code - chỉ hiển thị package thực thi code.
    • --version <version> / --tag <tag> - kiểm tra một phiên bản package cụ thể.
    • --versions, --files, --file <path> - kiểm tra lịch sử và tệp của package.
    • --json - đầu ra máy đọc được.
    Cài đặt / cập nhật / liệt kê
    clawhub install <slug>
    clawhub update <slug>
    clawhub update --all
    clawhub list
    

    Tùy chọn:

    • --version <version> - cài đặt hoặc cập nhật lên một phiên bản cụ thể (chỉ một slug trên update).
    • --force - ghi đè nếu thư mục đã tồn tại, hoặc khi tệp cục bộ không khớp với bất kỳ phiên bản đã xuất bản nào.
    • clawhub list đọc .clawhub/lock.json.
    Xuất bản Skills
    clawhub skill publish <path>
    

    Tùy chọn:

    • --slug <slug> - slug của Skills.
    • --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> - thẻ phân tách bằng dấu phẩy (mặc định: latest).
    Xuất bản Plugin
    clawhub package publish <source>
    

    <source> có thể là một thư mục cục bộ, owner/repo, owner/repo@ref, hoặc một URL GitHub.

    Tùy chọn:

    • --dry-run - xây dựng kế hoạch xuất bản chính xác mà không tải gì lên.
    • --json - phát đầu ra máy đọc được cho CI.
    • --source-repo, --source-commit, --source-ref - ghi đè tùy chọn khi tự động phát hiện là chưa đủ.
    Yêu cầu quét lại
    clawhub skill rescan <slug>
    clawhub skill rescan <slug> --yes --json
    
    clawhub package rescan <name>
    clawhub package rescan <name> --yes --json
    

    Các lệnh quét lại yêu cầu token owner đã đăng nhập và nhắm đến phiên bản Skills đã xuất bản mới nhất hoặc bản phát hành Plugin mới nhất. Trong các lần chạy không tương tác, truyền --yes.

    Phản hồi JSON bao gồm loại mục tiêu, tên, phiên bản, trạng thái quét lại và số lượng yêu cầu còn lại/tối đa cho phiên bản hoặc bản phát hành đó.

    Xóa / khôi phục xóa (owner hoặc admin)
    clawhub delete <slug> --yes
    clawhub undelete <slug> --yes
    
    Đồng bộ (quét cục bộ + xuất bản mới hoặc đã cập nhật)
    clawhub sync
    

    Tùy chọn:

    • --root <dir...> - root quét bổ sung.
    • --all - tải lên mọi thứ mà không cần prompt.
    • --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 registry (mặc định: 4).

    Quy trình thường dùng

    Tìm kiếm

    clawhub search "postgres backups"
    

    Tìm một plugin

    clawhub package explore --family code-plugin
    clawhub package explore "memory" --family code-plugin
    clawhub package inspect episodic-claw
    

    Cài đặt

    clawhub install my-skill-pack
    

    Cập nhật tất cả

    clawhub update --all
    

    Xuất bản một skill riêng lẻ

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

    Đồng bộ nhiều skills

    clawhub sync --all
    

    Xuất bản một plugin từ GitHub

    clawhub package publish your-org/your-plugin --dry-run
    clawhub package publish your-org/your-plugin
    clawhub package publish your-org/[email protected]
    clawhub package publish https://github.com/your-org/your-plugin
    

    Siêu dữ liệu gói Plugin

    Code plugins phải bao gồm siêu dữ liệu OpenClaw bắt buộc trong package.json:

    {
      "name": "@myorg/openclaw-my-plugin",
      "version": "1.0.0",
      "type": "module",
      "openclaw": {
        "extensions": ["./src/index.ts"],
        "runtimeExtensions": ["./dist/index.js"],
        "compat": {
          "pluginApi": ">=2026.3.24-beta.2",
          "minGatewayVersion": "2026.3.24-beta.2"
        },
        "build": {
          "openclawVersion": "2026.3.24-beta.2",
          "pluginSdkVersion": "2026.3.24-beta.2"
        }
      }
    }
    

    Các gói đã xuất bản nên đóng gói kèm JavaScript đã build và trỏ runtimeExtensions tới đầu ra đó. Các bản cài đặt từ Git checkout vẫn có thể fallback về mã nguồn TypeScript khi không có tệp đã build, nhưng các entry runtime đã build sẽ tránh việc biên dịch TypeScript lúc runtime trong các đường dẫn khởi động, doctor và tải plugin.

    Quản lý phiên bản, lockfile và telemetry

    Quản lý phiên bản và thẻ
    • Mỗi lần xuất bản tạo một SkillVersion semver mới.
    • Các thẻ (như latest) trỏ tới một phiên bản; việc di chuyển thẻ cho phép bạn rollback.
    • Changelog được gắn theo từng 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 trong registry

    Các bản cập nhật so sánh nội dung skill cục bộ với các phiên bản trong registry bằng content hash. Nếu các tệp cục bộ 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 các lần chạy không tương tác).

    Quét đồng bộ và thư mục gốc fallback

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

    Lưu trữ và lockfile
    • Skills đã cài đặt được ghi lại trong .clawhub/lock.json dưới workdir của bạn.
    • Token xác thực được lưu trong tệp cấu hình ClawHub CLI (ghi đè bằng CLAWHUB_CONFIG_PATH).
    Telemetry (số lượt cài đặt)

    Khi 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ượt cài đặt. Bạn có thể tắt hoàn toàn tính năng này:

    export CLAWHUB_DISABLE_TELEMETRY=1
    

    Biến môi trường

    Biến Tác dụng
    CLAWHUB_SITE Ghi đè URL site.
    CLAWHUB_REGISTRY Ghi đè URL API registry.
    CLAWHUB_CONFIG_PATH Ghi đè nơi CLI lưu token/cấu hình.
    CLAWHUB_WORKDIR Ghi đè workdir mặc định.
    CLAWHUB_DISABLE_TELEMETRY=1 Tắt telemetry khi chạy sync.

    Liên quan