ClawHub

ClawHub는 OpenClaw의 공개 스킬 레지스트리입니다. 무료 서비스로, 모든 스킬은 공개적이며 누구나 공유하고 재사용할 수 있습니다. 스킬은 SKILL.md 파일과 지원 텍스트 파일이 포함된 폴더에 불과합니다. 웹 앱에서 스킬을 탐색하거나 CLI를 사용하여 스킬을 검색, 설치, 업데이트, 게시할 수 있습니다.

사이트: clawhub.ai

ClawHub란

  • OpenClaw 스킬을 위한 공개 레지스트리.
  • 스킬 번들과 메타데이터의 버전 관리 저장소.
  • 검색, 태그, 사용 신호를 위한 디스커버리 플랫폼.

동작 원리

  1. 사용자가 스킬 번들(파일 + 메타데이터)을 게시합니다.
  2. ClawHub가 번들을 저장하고, 메타데이터를 파싱하고, 버전을 할당합니다.
  3. 레지스트리가 검색 및 디스커버리를 위해 스킬을 인덱싱합니다.
  4. 사용자가 스킬을 탐색, 다운로드하고 OpenClaw에 설치합니다.

가능한 작업

  • 새 스킬과 기존 스킬의 새 버전을 게시합니다.
  • 이름, 태그 또는 검색으로 스킬을 탐색합니다.
  • 스킬 번들을 다운로드하고 파일을 검사합니다.
  • 남용되거나 안전하지 않은 스킬을 신고합니다.
  • 모더레이터인 경우, 숨기기, 숨기기 해제, 삭제 또는 차단할 수 있습니다.

대상 사용자 (초보자 친화)

OpenClaw 에이전트에 새로운 기능을 추가하고 싶다면, ClawHub가 스킬을 찾고 설치하는 가장 쉬운 방법입니다. 백엔드 작동 방식을 알 필요가 없습니다. 다음을 할 수 있습니다:

  • 자연어로 스킬을 검색합니다.
  • 워크스페이스에 스킬을 설치합니다.
  • 나중에 명령 하나로 스킬을 업데이트합니다.
  • 자신의 스킬을 게시하여 백업합니다.

빠른 시작 (비기술자용)

  1. CLI를 설치합니다 (다음 섹션 참조).
  2. 필요한 것을 검색합니다:
    • clawhub search "calendar"
  3. 스킬을 설치합니다:
    • clawhub install <skill-slug>
  4. 새 OpenClaw 세션을 시작하여 새 스킬을 로드합니다.

CLI 설치

하나를 선택하세요:

npm i -g clawhub
pnpm add -g clawhub

OpenClaw과의 통합 방식

기본적으로 CLI는 현재 작업 디렉터리의 ./skills 하위에 스킬을 설치합니다. OpenClaw 워크스페이스가 구성되어 있으면, --workdir(또는 CLAWHUB_WORKDIR)을 오버라이드하지 않는 한 clawhub는 해당 워크스페이스로 폴백합니다. OpenClaw는 <workspace>/skills에서 워크스페이스 스킬을 로드하며 다음 세션에서 이를 인식합니다. 이미 ~/.openclaw/skills나 번들된 스킬을 사용하고 있다면, 워크스페이스 스킬이 우선합니다.

스킬이 로드, 공유, 제어되는 방법에 대한 자세한 내용은 스킬을 참조하세요.

스킬 시스템 개요

스킬은 OpenClaw에 특정 작업 수행 방법을 가르치는 버전이 매겨진 파일 번들입니다. 각 게시마다 새 버전이 생성되며, 레지스트리는 사용자가 변경 사항을 감사할 수 있도록 버전 기록을 유지합니다.

일반적인 스킬에 포함되는 것:

  • 주요 설명과 사용법이 담긴 SKILL.md 파일.
  • 스킬이 사용하는 선택적 설정, 스크립트 또는 지원 파일.
  • 태그, 요약, 설치 요구 사항 등의 메타데이터.

ClawHub는 메타데이터를 사용하여 디스커버리를 지원하고 스킬 기능을 안전하게 노출합니다. 레지스트리는 또한 랭킹과 가시성을 개선하기 위해 사용 신호(별점, 다운로드 등)를 추적합니다.

서비스가 제공하는 기능

  • 스킬 및 SKILL.md 내용의 공개 탐색.
  • 키워드뿐만 아니라 임베딩(벡터 검색)을 기반으로 한 검색.
  • semver, 변경 로그, 태그(latest 포함)를 통한 버전 관리.
  • 버전별 zip 다운로드.
  • 커뮤니티 피드백을 위한 별점 및 댓글.
  • 승인 및 감사를 위한 모더레이션 후크.
  • 자동화 및 스크립팅을 위한 CLI 친화적 API.

보안 및 모더레이션

ClawHub는 기본적으로 개방되어 있습니다. 누구나 스킬을 업로드할 수 있지만, 게시하려면 GitHub 계정이 최소 1주일 이상 되어야 합니다. 이는 합법적인 기여자를 차단하지 않으면서 남용을 줄이는 데 도움이 됩니다.

신고 및 모더레이션:

  • 로그인한 사용자는 누구나 스킬을 신고할 수 있습니다.
  • 신고 사유가 필수이며 기록됩니다.
  • 각 사용자는 최대 20개의 활성 신고를 가질 수 있습니다.
  • 3명 이상의 고유 신고가 있는 스킬은 기본적으로 자동 숨김 처리됩니다.
  • 모더레이터는 숨긴 스킬을 보거나, 숨기기를 해제하거나, 삭제하거나, 사용자를 차단할 수 있습니다.
  • 신고 기능을 남용하면 계정이 차단될 수 있습니다.

모더레이터가 되는 데 관심이 있으면 OpenClaw Discord에서 모더레이터나 메인테이너에게 문의하세요.

CLI 명령어 및 파라미터

전역 옵션 (모든 명령에 적용):

  • --workdir <dir>: 작업 디렉터리 (기본값: 현재 디렉터리, OpenClaw 워크스페이스로 폴백).
  • --dir <dir>: 스킬 디렉터리, workdir 기준 상대 경로 (기본값: skills).
  • --site <url>: 사이트 기본 URL (브라우저 로그인).
  • --registry <url>: 레지스트리 API 기본 URL.
  • --no-input: 프롬프트 비활성화 (비대화형).
  • -V, --cli-version: CLI 버전 출력.

인증:

  • clawhub login (브라우저 흐름) 또는 clawhub login --token <token>
  • clawhub logout
  • clawhub whoami

옵션:

  • --token <token>: API 토큰 입력.
  • --label <label>: 브라우저 로그인 토큰에 저장되는 레이블 (기본값: CLI token).
  • --no-browser: 브라우저를 열지 않음 (--token 필요).

검색:

  • clawhub search "query"
  • --limit <n>: 최대 결과 수.

설치:

  • clawhub install <slug>
  • --version <version>: 특정 버전 설치.
  • --force: 폴더가 이미 존재하면 덮어쓰기.

업데이트:

  • clawhub update <slug>
  • clawhub update --all
  • --version <version>: 특정 버전으로 업데이트 (단일 slug만 가능).
  • --force: 로컬 파일이 게시된 버전과 일치하지 않을 때 덮어쓰기.

목록:

  • clawhub list (.clawhub/lock.json 읽기)

게시:

  • clawhub publish <path>
  • --slug <slug>: 스킬 slug.
  • --name <name>: 표시 이름.
  • --version <version>: semver 버전.
  • --changelog <text>: 변경 로그 텍스트 (비어 있을 수 있음).
  • --tags <tags>: 쉼표로 구분된 태그 (기본값: latest).

삭제/복원 (소유자/관리자만):

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

동기화 (로컬 스킬 스캔 + 신규/업데이트 게시):

  • clawhub sync
  • --root <dir...>: 추가 스캔 루트.
  • --all: 프롬프트 없이 모든 것 업로드.
  • --dry-run: 업로드할 내용 표시.
  • --bump <type>: 업데이트용 patch|minor|major (기본값: patch).
  • --changelog <text>: 비대화형 업데이트용 변경 로그.
  • --tags <tags>: 쉼표로 구분된 태그 (기본값: latest).
  • --concurrency <n>: 레지스트리 확인 (기본값: 4).

에이전트를 위한 일반 워크플로

스킬 검색

clawhub search "postgres backups"

새 스킬 다운로드

clawhub install my-skill-pack

설치된 스킬 업데이트

clawhub update --all

스킬 백업 (게시 또는 동기화)

단일 스킬 폴더의 경우:

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

여러 스킬을 한 번에 스캔하고 백업하려면:

clawhub sync --all

고급 세부 사항 (기술적)

버전 관리 및 태그

  • 각 게시마다 새 semver SkillVersion이 생성됩니다.
  • 태그(latest 등)는 버전을 가리킵니다. 태그를 이동하면 롤백할 수 있습니다.
  • 변경 로그는 버전별로 첨부되며, 동기화나 업데이트 게시 시 비어 있을 수 있습니다.

로컬 변경 사항 vs 레지스트리 버전

업데이트 시 콘텐츠 해시를 사용하여 로컬 스킬 내용을 레지스트리 버전과 비교합니다. 로컬 파일이 게시된 버전과 일치하지 않으면 CLI가 덮어쓰기 전에 확인합니다 (비대화형 실행에서는 --force 필요).

동기화 스캔 및 폴백 루트

clawhub sync는 먼저 현재 workdir을 스캔합니다. 스킬이 없으면 알려진 레거시 위치(예: ~/openclaw/skills 및 ~/.openclaw/skills)로 폴백합니다. 이는 추가 플래그 없이 이전 스킬 설치를 찾기 위한 것입니다.

저장소 및 잠금 파일

  • 설치된 스킬은 workdir의 .clawhub/lock.json에 기록됩니다.
  • 인증 토큰은 ClawHub CLI 설정 파일에 저장됩니다 (CLAWHUB_CONFIG_PATH로 오버라이드 가능).

텔레메트리 (설치 수)

로그인 상태에서 clawhub sync를 실행하면 CLI가 설치 수를 계산하기 위해 최소한의 스냅샷을 전송합니다. 완전히 비활성화할 수 있습니다:

export CLAWHUB_DISABLE_TELEMETRY=1

환경 변수

  • CLAWHUB_SITE: 사이트 URL 오버라이드.
  • CLAWHUB_REGISTRY: 레지스트리 API URL 오버라이드.
  • CLAWHUB_CONFIG_PATH: CLI의 토큰/설정 저장 위치 오버라이드.
  • CLAWHUB_WORKDIR: 기본 workdir 오버라이드.
  • CLAWHUB_DISABLE_TELEMETRY=1: sync 시 텔레메트리 비활성화.
arrow_back
이전
Skills Config
다음
Plugin
arrow_forward