오픈클로 스킬 설치 완벽 가이드: ClawHub로 내 자비스 능력 200% 늘리기

오픈클로를 “진짜 자비스”로 만들어주는 게 바로 스킬(Skill)입니다. 이 글에서는 설치까지 끝낸 사람을 기준으로, ClawHub 스킬 마켓에서 스킬을 찾아 설치·설정·테스트하는 전 과정을 단계별로 정리하겠습니다.

---

오픈클로 스킬 설치 완벽 가이드: ClawHub로 내 자비스 능력 200% 늘리기

오픈클로 설치만 해도 기본 기능은 쓸 수 있지만, 진짜 맛은 스킬을 깔았을 때부터 시작입니다. 웹 검색, 노션·캘린더 연동, 파일 정리, SNS 자동화까지… 모든 기능이 스킬로 붙습니다.
이 글은 “처음 설치한 상태에서, 내가 원하는 스킬을 골라 까는 방법”에 집중합니다.

전제:

• 오픈클로 설치 + openclaw onboard까지 완료된 상태.
• 윈도우 기준, WSL2/Ubuntu에서 오픈클로를 돌리고 있다는 가정.

 

오픈클로 설치가 궁금하다면 다음 항목을 참고해주세요.

https://bluemold.tistory.com/12

오픈클로(OpenClaw) 설치 완벽 가이드: 처음 하는 사람도 30분 안에 끝내는 방법 (윈도우 기준)

 

---

1단계: ClawHub CLI 설치 – 스킬을 다루는 ‘관리자’ 넣기

스킬 설치·검색·업데이트는 ClawHub CLI가 담당합니다.

1-1. ClawHub CLI 설치

1. Ubuntu(또는 오픈클로를 설치한 터미널) 실행.
2. 아래 명령어 중 하나를 선택해 입력:

 

bash

# 가장 많이 쓰이는 방법 npm i -g clawhub # 또는 pnpm / yarn 환경이면 pnpm add -g clawhub # yarn global add clawhub (환경에 따라)

이 명령어가 끝나면 clawhub라는 커맨드를 어디서나 쓸 수 있게 됩니다.

1-2. 설치 확인

 

bash

clawhub --version

버전 번호가 뜨면 정상 설치입니다.​

---

2단계: 스킬이 깔릴 위치 이해하기 (skills 폴더)

ClawHub CLI는 기본적으로 **현재 작업 폴더의 ./skills**에 스킬을 설치합니다.
보통은 오픈클로 워크스페이스 폴더나 홈 디렉터리를 기준으로 사용합니다.

• 기본 위치 예시:
  • ~/openclaw-workspace/skills/스킬이름/
  • 또는 ~/.openclaw/skills/스킬이름/ (환경에 따라)

블로그 글에서는 “오픈클로 워크스페이스 폴더 하나 잡기”를 추천하는 식으로 안내하면 좋습니다.

예시:

 

bash

mkdir -p ~/openclaw-workspace cd ~/openclaw-workspace

이 상태에서 스킬을 설치하면, 모두 ~/openclaw-workspace/skills 아래로 모이게 됩니다.

---

3단계: ClawHub에서 스킬 검색하기

이제 마켓에서 필요한 스킬을 찾습니다.
ClawHub는 키워드 검색뿐 아니라 **자연어 설명 기반 검색(임베딩)**을 지원해서 “무엇을 하고 싶은지”를 적어도 됩니다.

3-1. 키워드로 검색

예: 웹 검색 관련 스킬 찾기

 

bash

clawhub search web

예: 노션 연동 스킬 찾기

 

bash

clawhub search notion

예: 캘린더 연동 스킬 찾기

 

bash

clawhub search calendar

검색 결과에는 스킬 이름, 설명, 작성자, 버전 등이 리스트로 표시됩니다.

3-2. 자연어로 검색 (지원 환경 기준)

일부 버전/환경에서는 이런 요청도 가능합니다:

 

bash

clawhub search "구글 검색해서 요약해 주는 스킬" clawhub search "노션 데이터베이스에 메모 저장하는 기능"

ClawHub가 임베딩 기반으로 의미를 파악해 유사 스킬을 찾아줍니다.

---

4단계: 원하는 스킬 설치하기

검색 결과에서 마음에 드는 스킬을 골랐다면, 이제 설치만 하면 됩니다.

4-1. 기본 설치 명령

형식:

 

bash

clawhub install <스킬-이름>

예시 (실제 존재하는 형태를 가정):

 

bash

clawhub install summarize clawhub install web-search clawhub install notion-sync

• 설치하면 현재 디렉터리의 ./skills/스킬-이름/에 코드가 내려받아집니다.
• 별다른 에러 없이 완료되면 설치 성공입니다.

4-2. 버전 고정 설치 (권장)

업데이트로 갑자기 동작이 바뀌는 걸 막고 싶다면, 버전 명시 설치를 추천합니다.

 

bash

clawhub install author/skill@1.0.0

ClawHub 공식 문서에서도 “프로덕션 환경에서는 버전 고정 설치를 권장한다”고 안내합니다.

---

5단계: 스킬 설정(SKILL.md·환경 변수) 확인

스킬이 설치되면, 폴더 안에 보통 이런 파일들이 있습니다:

• SKILL.md: 이 스킬의 사용법·설정 방법이 적힌 설명서.
• skill.config.json 또는 비슷한 설정 파일.
• 실행 스크립트(index.ts, main.js, py 등).

5-1. SKILL.md 읽기

 

bash

cd ~/openclaw-workspace/skills/<스킬-이름>/ cat SKILL.md

또는 VS Code/메모장 등으로 열어도 됩니다.

여기에는:

• 무슨 일을 하는 스킬인지
• 어떤 API 키/환경 변수가 필요한지
• 오픈클로에서 어떻게 호출하는지 예시 프롬프트 등이 적혀 있습니다.

5-2. API 키가 필요한 스킬 (예: 노션, 구글, 슬랙 등)

노션 연동 스킬처럼 외부 서비스가 필요한 경우:

1. 해당 서비스(예: Notion)의 개발자 페이지에서 API 키/통합 토큰 발급.
2. 오픈클로 설정 파일(openclaw.json 또는 .env)에 환경 변수로 추가.

예시:

 

bash

export NOTION_API_KEY="secret_xxx..." export NOTION_DATABASE_ID="xxxxxxxx"

이렇게 설정해둔 값은 오픈클로가 스킬 실행 시 자동으로 넘겨줍니다.

---

6단계: 오픈클로에서 스킬 인식시키기

스킬만 깔았다고 바로 써지는 건 아니고, 오픈클로가 “사용 가능한 스킬 목록”을 다시 읽어야 합니다.​

6-1. 세션 리프레시 (가장 간단한 방법)

스킬 시스템은 “세션 시작 시점에 어떤 스킬이 있는지 스냅샷을 떠서 사용”합니다.​

그래서:

1. 기존 대화 세션(콘솔/웹)을 종료.
2. 새 세션을 열거나, 에이전트를 다시 시작.

이러면 새로 설치한 스킬이 목록에 반영됩니다.​

6-2. 워처(Watcher)로 자동 반영 (환경에 따라)

문서 기준으로, 스킬 워처가 활성화된 상태에서는 중간에도 스킬 리스트가 리프레시될 수 있습니다.​
하지만 초보자에게는 “스킬 설치 후 새 세션 시작” 정도만 기억해도 충분합니다.

---

7단계: 새로 설치한 스킬 테스트하기

스킬이 정상 인식됐는지 확인하는 가장 좋은 방법은 오픈클로에게 직접 써보게 시켜 보는 것입니다.

7-1. 샌드박스 모드에서 시험 실행

일부 가이드에서는 아래처럼 “샌드박스 모드” 테스트를 권장합니다:​

 

bash

openclaw agent --sandbox --message "방금 설치한 summarize 스킬을 테스트해줘"

• 샌드박스 모드에서는 파일 시스템·네트워크 권한이 제한된 상태로 실행돼, 위험을 줄일 수 있습니다.​
• 오류가 나면 로그를 보고 원인을 찾을 수 있습니다.

7-2. 실사용 프롬프트 예시

예를 들어 web-search 스킬을 설치했다면:

“웹 검색 스킬을 사용해서 ‘2026년 AI 생산성 트렌드’ 기사 3개만 찾아 요약해줘.”

 

notion-sync 스킬이라면:

“지금 대화 내용을 노션 데이터베이스에 ‘일일 회의록’ 형식으로 저장해줘.”

 

이렇게 **“무슨 스킬을 쓰라고 직접 말해주는 프롬프트”**를 쓰면, 초반에는 인식 확인이 쉽습니다.

---

8단계: 스킬 관리 – 업데이트·삭제

스킬도 시간이 지나면 업데이트가 나오거나, 더 이상 쓰지 않을 수도 있습니다.

8-1. 업데이트

(환경에 따라 차이 있지만, 문서 예시 기준)

 

bash

clawhub upgrade <스킬-이름>

혹은 최신 버전으로 다시 설치하는 방식:

 

bash

clawhub install <스킬-이름>@latest

8-2. 삭제

스킬을 제거하려면:

 

bash

clawhub remove <스킬-이름>

또는 ./skills/<스킬-이름> 폴더를 직접 삭제 후, 새 세션을 시작하면 됩니다.​

---

추천: “처음 깔아볼 만한 스킬” 예시 3개

블로그 글에서는 여기까지 쓰고, 마지막에 입문자용 추천 스킬 2~3개를 소개하면 클릭·체류시간이 더 올라갑니다.

예시:

• summarize: 긴 텍스트 요약용 기본기 스킬.
• web-search 또는 brave-search: 브라우저 없이도 웹 검색·요약.
• notion-sync: 노션으로 회의록·메모 자동 정리.

설치 예:

 

bash

cd ~/openclaw-workspace clawhub install summarize clawhub install web-search clawhub install notion-sync

설치 후:

“방금 설치한 summarize 스킬로, 아래 회의록을 세 줄로 요약해줘.”
“web-search 스킬을 써서, ‘오픈클로 보안 이슈’ 관련 글 2개만 찾아 핵심만 정리해줘.”

 

정도 프롬프트까지 블로그에 넣어두면, 읽는 사람이 그대로 복사해서 테스트해 보기 좋습니다.

---

이 글 다음에는 “노션 스킬로 회의록 자동 저장하기”나 “웹검색+요약 스킬 조합으로 리서치 자동화하기” 같은 실전 시나리오를 소개해드리겠습니다.