OpenClaw ClawHub 스킬 마켓플레이스 사용 튜토리얼

소개

ClawHub는 OpenClaw의 공식 스킬 마켓플레이스로, Node.js에 대한 npm이나 VS Code에 대한 확장 프로그램과 유사합니다. ClawHub를 통해 커뮤니티에서 개발한 다양한 스킬을 원클릭으로 설치할 수 있으며, 직접 개발한 스킬을 전 세계와 공유할 수도 있습니다.

현재까지 ClawHub에는 수백 개의 스킬이 등록되어 있으며, 생산성 도구, 정보 조회, 엔터테인먼트 등 다양한 카테고리를 포함하고 있습니다.

ClawHub 작동 원리

ClawHub 스킬은 본질적으로 SKILL.md 파일이며, 설치 후 ~/.openclaw/skills/ 디렉토리에 저장됩니다. 각 스킬은 Markdown 파일로, 스킬의 트리거 조건, 동작 로직 및 출력 형식을 정의합니다.

~/.openclaw/skills/
├── weather.SKILL.md
├── translator.SKILL.md
├── reminder.SKILL.md
└── github-notify.SKILL.md

스킬 마켓플레이스 탐색

온라인 탐색

ClawHub 공식 웹사이트에서 사용 가능한 모든 스킬을 확인합니다:

https://clawhub.dev

웹사이트에서는 카테고리별 탐색, 인기 추천, 최신 출시 등의 기능을 제공합니다.

명령줄 탐색

터미널에서도 스킬을 탐색하고 검색할 수 있습니다:

# 설치된 스킬 목록 확인
openclaw skill list

# 스킬 검색
npx clawhub@latest search weather

# 스킬 상세 정보 확인
npx clawhub@latest info weather-forecast

검색 결과 예시:

Search results for "weather":
  weather-forecast    ★ 4.8  ↓ 12.3k  Weather forecast with multi-source data
  weather-alert       ★ 4.5  ↓ 3.2k   Severe weather alerts and notifications
  weather-clothing    ★ 4.2  ↓ 1.1k   Clothing recommendations based on weather

3 skills found

스킬 설치

기본 설치

npx clawhub@latest install 명령어로 스킬을 설치합니다:

# 날씨 조회 스킬 설치
npx clawhub@latest install weather-forecast

# 번역 스킬 설치
npx clawhub@latest install translator

# 여러 스킬 설치
npx clawhub@latest install weather-forecast translator reminder

설치 완료 후 OpenClaw를 재시작하여 스킬을 적용합니다:

openclaw restart

특정 버전 설치

# 지정 버전 설치
npx clawhub@latest install [email protected]

# 최신 프리뷰 버전 설치
npx clawhub@latest install weather-forecast@next

Git 저장소에서 설치

스킬이 아직 ClawHub에 게시되지 않은 경우 Git 저장소에서 직접 설치할 수 있습니다:

npx clawhub@latest install --git https://github.com/username/my-skill.git

로컬 스킬 설치

개발 과정에서 로컬 파일로부터 설치할 수 있습니다:

npx clawhub@latest install --local ./my-weather-skill/

설치된 스킬 관리

설치된 스킬 확인

openclaw skill list

출력 예시:

Installed Skills:
  NAME               VERSION   STATUS    SOURCE
  weather-forecast   1.3.2     active    clawhub
  translator         2.1.0     active    clawhub
  reminder           1.0.5     active    clawhub
  custom-greeter     -         active    local

4 skills installed, 4 active

스킬 업데이트

# 단일 스킬 업데이트
npx clawhub@latest update weather-forecast

# 모든 스킬 업데이트
npx clawhub@latest update --all

# 사용 가능한 업데이트 확인 (업데이트 실행하지 않음)
npx clawhub@latest outdated

outdated 명령어 출력 예시:

Outdated Skills:
  NAME               CURRENT   LATEST    CHANGELOG
  weather-forecast   1.3.2     1.4.0     Added hourly forecast support
  translator         2.1.0     2.2.1     Fixed CJK language detection

2 skills can be updated
Run 'npx clawhub@latest update --all' to update

스킬 제거

# 단일 스킬 제거
npx clawhub@latest uninstall weather-forecast

# 데이터까지 함께 제거
npx clawhub@latest uninstall weather-forecast --purge

스킬 활성화/비활성화

스킬을 제거하지 않고 임시로 비활성화할 수 있습니다:

# 스킬 비활성화
openclaw skill disable translator

# 다시 활성화
openclaw skill enable translator

설정 파일에서도 관리할 수 있습니다:

{
  skills: {
    // 전역 비활성화 목록
    disabled: ["translator"],
    // 또는 화이트리스트 모드 사용
    // enabled: ["weather-forecast", "reminder"]
  }
}

스킬 카테고리 및 추천

ClawHub의 스킬은 기능별로 다음 카테고리로 분류됩니다:

ClawHub에 스킬 게시하기

준비 작업

1. ClawHub 개발자 계정 등록:

npx clawhub@latest register

2. 로그인:

npx clawhub@latest login

스킬 디렉토리 구조

게시 전에 스킬은 다음 구조를 따라야 합니다:

my-awesome-skill/
├── SKILL.md            # 스킬 정의 파일 (필수)
├── clawhub.json        # 메타데이터 파일 (필수)
├── README.md           # 설명 문서 (권장)
├── CHANGELOG.md        # 변경 로그 (권장)
└── examples/           # 사용 예시 (권장)
    └── demo.md

메타데이터 파일

clawhub.json을 생성하여 스킬을 설명합니다:

{
  "name": "my-awesome-skill",
  "version": "1.0.0",
  "description": "A brief description of what this skill does",
  "author": "your-username",
  "license": "MIT",
  "keywords": ["utility", "productivity"],
  "category": "효율 도구",
  "openclaw": {
    "minVersion": "1.0.0"
  },
  "repository": "https://github.com/username/my-awesome-skill"
}

게시 전 검증

# 스킬 디렉토리에서 검증 실행
npx clawhub@latest validate

# 로컬 테스트 설치
npx clawhub@latest install --local ./

게시

# ClawHub에 게시
npx clawhub@latest publish

# 프리뷰 버전 게시
npx clawhub@latest publish --tag next

게시된 스킬 업데이트

# 버전 번호 수정 후 재게시
npx clawhub@latest publish

# 특정 버전 철회 (24시간 이내)
npx clawhub@latest unpublish [email protected]

스킬 보안 심사

ClawHub는 게시된 모든 스킬에 대해 보안 심사를 수행합니다:

1. 자동 스캔: 악성 코드 및 개인정보 유출 위험 포함 여부 검사
2. 커뮤니티 심사: 인기 스킬은 커뮤니티 리뷰를 거칩니다
3. 서명 검증: 설치 시 스킬 파일의 무결성을 검증합니다

스킬의 보안 등급을 확인할 수 있습니다:

npx clawhub@latest info weather-forecast --security

Security Report: [email protected]
  Verified author:     ✓
  No external calls:   ✓ (uses MCP tools only)
  Community reviewed:  ✓ (23 reviews)
  Security score:      A+

자주 묻는 질문

설치한 스킬이 작동하지 않는 경우

# 스킬이 올바르게 설치되었는지 확인
openclaw skill list

# OpenClaw 재시작
openclaw restart

# 스킬이 비활성화되었는지 확인
openclaw skill list | grep disabled

스킬 버전 충돌

두 스킬이 충돌하는 경우 우선순위 설정을 확인합니다:

# 스킬 로드 순서 확인
openclaw skill list --verbose

npx 명령어가 느린 경우

clawhub CLI를 전역으로 설치할 수 있습니다:

npm install -g clawhub@latest

# 이후 직접 사용
clawhub install weather-forecast
clawhub search translator

마무리

ClawHub 스킬 마켓플레이스는 OpenClaw의 기능 범위를 크게 확장합니다. 간단한 명령줄 조작만으로 AI 어시스턴트에 다양한 실용적인 기능을 추가할 수 있습니다. 좋은 스킬을 개발하셨다면 ClawHub에 게시하여 커뮤니티와 공유하시기 바랍니다.

다음으로, 이어지는 스킬 개발 튜토리얼을 참고하여 처음부터 자신만의 Skill을 만드는 방법을 학습할 수 있습니다.