npx 명령어를 통해 OpenClaw에 Clawhub 스킬 추가하는 방법
OpenClaw는 강력한 개인 AI 어시스턴트이다. 이 강력함은 Tool 사용이나 Skill에서 나오는데, 기본 내장된 Skill 외에 추가로 스킬이 필요한 경우가 있다. 개인 맞춤을 위해서는 어쩔 수 없이 이 필요성을 느끼게 될 것이다. 이때 도움을 주는 게 Clawhub(https://clawhub.ai)이다. ClawHub는 OpenClaw의 공식 스킬 레지스트리로서 수백 개의 커뮤니티 스킬을 제공한다. 이 글에서는 npx clawhub install 명령어를 사용해 Clawhub에서 스킬을 검색하고 OpenClaw 스킬 추가하는 방법을 정리해본다. npx를 활용하면 별도 CLI 설치 없이 즉시 스킬을 다운로드하고 설치할 수 있다. 이는 개발자 워크플로우를 간소화하며, OpenClaw 스킬 추가를 빠르고 안전하게 만든다.
Clawhub 소개와 npx 설치의 이점
Clawhub는 OpenClaw 전용 스킬 디렉토리이다. 모든 스킬은 공개되어 있으며, SKILL.md 파일과 지원 파일로 구성된다. ClawHub 사이트웹에서 검색을 통해 필요한 스킬을 탐색할 수 있다.
npx를 사용한 OpenClaw 스킬 추가의 주요 이점은 다음과 같다.
- 설치 간편성:
npm i -g clawhub없이npx clawhub install {skill-name}한 번으로 실행. - 워크스페이스 자동 지원: 현재 디렉토리의 ./skills 또는 ~/.openclaw/skills에 자동 설치.
- 버전 관리: 최신 버전(latest 태그) 기본 설치, VirusTotal 스캔으로 보안 확인.
- 휘발성 실행: 임시 설치 테스트에 이상적.
이 방법으로 OpenClaw의 기능을 확장해나갈 수 있다.
Clawhub에서 스킬 탐색하기
- Clawhub 웹사이트(https://clawhub.ai)에 접속
- 상단 검색 바에 키워드를 입력 (예를 들어 “discord”를 검색하면 Discord 연동 스킬이 상위에 노출됨)
검색 팁
- 자연어 검색: “postgres backups”처럼 문장으로 입력하면 벡터 검색이 작동
- 태그 필터: calendar, github 등 카테고리별 탐색
- 인기 스킬 확인: 다운로드 수와 스타 기반 정렬
선택한 스킬 페이지에서 SKILL.md 내용을 검토한다. 혹시나 보안 문제가 있을 수 있어 찝찝하니까 한번 살펴본다(ClawHub에 있는 skill은 그럴 일이 없다고 믿는다…). 설치 명령어(npx clawhub install {slug})가 명시되어 있다. slug는 스킬 이름(예: discord)이다.
npx clawhub install 튜토리얼
터미널에서 npx clawhub install을 실행한다. 기본 설치 경로는 현재 작업 디렉토리의 ./skills이다. OpenClaw 워크스페이스가 설정되어 있으면 자동으로 해당 위치에 추가된다.
기본 설치
npx clawhub install discord
Discord 스킬이 ~/.openclaw/skills/discord에 다운로드된다.
옵션 활용
--workdir {path}: 특정 워크스페이스 지정 (예:npx clawhub install discord --workdir ~/my-openclaw-workspace)--force: 기존 폴더 덮어쓰기--version {ver}: 특정 버전 설치 (예:npx clawhub install discord --version 1.2.0)
실전 예시 1: Discord 스킬 추가
npx clawhub install discord --workdir ~/.openclaw/workspaces/myproject
OpenClaw에서 Discord 채널 관리 가능
실전 예시 2: GitHub 스킬 추가
npx clawhub install github
리포지토리 클론, PR 생성 등 GitHub 자동화
실전 예시 3: Calendar 스킬 추가
npx clawhub install calendar --force
Google Calendar 일정 조회/생성 지원
설치 검증과 OpenClaw 사용법
스킬 설치 후 OpenClaw 세션을 재시작한다.
스킬 목록 확인
openclaw skills list
설치된 스킬 목록과 상태가 출력된다. npx clawhub install로 추가된 스킬이 표시된다. Web UI에서 확인해도 된다.
사용법
OpenClaw 채팅에서 “discord 메시지 보내”처럼 호출한다. SKILL.md에 정의된 트리거가 자동 매칭된다.
예:
- Discord: “채널 #general에 ‘안녕’ 보내.”
- GitHub: “내 리포 클론해.”
새 세션에서 즉시 사용 가능하다.
트러블슈팅과 Best Practice
흔한 문제 해결
- 명령어 실패: Node.js 확인(
node -v). npx 캐시 지우기(npx clear-npx-cache). - 권한 오류:
--workdir로 사용자 디렉토리 지정 - 스킬 로드 안 됨:
openclaw skills sync실행 후 재시작 - 보안 경고: Clawhub는 VirusTotal 스캔을 제공하여, 비교적 신뢰할 수 있다.
베스트 프랙티스
- 업데이트 유지:
npx clawhub update --all - 백업:
npx clawhub sync로 로컬 스킬 게시 - 테스트:
--dry-run옵션으로 미리 확인
결론
npx clawhub install은 Clawhub에서 OpenClaw 스킬 추가를 간소화해준다. 이 튜토리얼을 따라 해보면 누구나 Discord, GitHub 등 스킬을 즉시 활용할 수 있다. Clawhub를 방문해서 Skill들을 구경하고 나에게 필요한 걸 찾아보면 OpenClaw의 잠재력을 키울 수 있다.
