OpenClaw를 깔았는데 검색·날씨·문서·알림을 확장하고 싶다면? 이 글은 이미 OpenClaw를 설치한 초보~중급 사용자를 위해 스킬 시장(ClawHub)과 플러그인 관계, 스킬 설치·업데이트(openclaw skills / ClawHub), 10가지 흔한 시나리오 설정 요점, 원격 Mac에서 Skill 사용 시 유의사항과 FAQ를 정리해, 함정을 줄이고 바로 실전에 쓸 수 있게 합니다.
OpenClaw 스킬 시장이란? 플러그인과의 관계
OpenClaw의 스킬(Skill)은 AI가 호출할 수 있는 기능 모듈입니다. 웹 검색, 터미널 실행, 알림, 날씨, 문서 읽기·쓰기 등이 있습니다. 공식 스킬 시장은 ClawHub라고 부르며, 2026년에는 검색·통신·생산성·개발 등 많은 스킬이 올라와 있습니다. 스킬과 「플러그인」은 대부분 문서에서 동일하게 쓰이며, 설치 후 ~/.openclaw/skills/ 또는 워크스페이스 skills 디렉터리에 두고 OpenClaw가 대화 중 필요 시 로드합니다.
로드 우선순위는 보통 워크스페이스 skills가 최상, 그다음 사용자 디렉터리 스킬, 그다음 내장 스킬입니다. 이걸 알면 「깔았는데 안 돼」나 「버전 충돌」을 짚을 때 도움이 됩니다.
스킬 설치·업데이트: skill update, 권한과 흔한 실패 원인
설치·업데이트는 보통 터미널이나 대시보드에서 합니다. 자주 쓰는 명령은 다음과 같습니다.
openclaw skills search <키워드>: 스킬 시장에서 검색.openclaw skills install <skill-id>: 지정 스킬 설치 (예:openclaw skills install gmail).openclaw skills update --all또는openclaw skills update <skill-id>: 전체 또는 단일 스킬 업데이트.openclaw skills list: 설치된 스킬 목록 보기.
흔한 실패 원인: 네트워크 타임아웃(미러·프록시 설정), 권한 부족(설치 디렉터리 쓰기 불가), Node·의존 버전 불일치(스킬 요구사항 충족 필요). 원격 Mac에서 SSH로 조작할 때는 ~/.openclaw/skills에 쓰기 권한이 있는지 확인하세요. VNC 데스크톱이면 로컬과 동일하게 안내에 따라 인증·설정을 마치면 됩니다.
~/.openclaw/skills/<skill-id>/에 있습니다. 일부 스킬은 --configure로 설치 시 설정을 함께 마칠 수 있습니다.10가지 흔한 스킬 시나리오: 검색·날씨·계산·문서·알림 등 설정 요점
아래 10가지 시나리오는 2026년에 자주 쓰는 패턴입니다. 설정 요점은 아래 표와 같습니다.
| 시나리오 | 대표 스킬/방향 | 설정 요점 |
|---|---|---|
| 웹 검색 | Brave Search, 웹 검색류 | API 키 또는 네트워크 허용. 무료 한도 있는 스킬도 있음. |
| 날씨 | 날씨 조회류 | 도시 또는 API. 단위·지역 확인. |
| 계산/도구 | 계산기, 단위 환산 | 보통 추가 설정 없이 설치 즉시 사용 가능. |
| 문서/노트 | Notion, 문서 읽기·쓰기 | OAuth 또는 API 토큰. 스킬 디렉터리 설명대로 설정. |
| 이메일 | Gmail, 메일 송수신 | 계정 인증 또는 앱 비밀번호. 보안 범위 확인. |
| 일정 | Google Calendar 등 | 캘린더 API 또는 OAuth. 계정 권한과 맞출 것. |
| 메시징 | Telegram, 페이슈, Slack, Discord | 봇 토큰 또는 앱 설정. 해당 플랫폼에서 앱 생성 후 입력. |
| 개발 | GitHub, 터미널/Shell | GitHub는 PAT 필요. Shell은 실행 권한·샌드박스 유의. |
| 스케줄/리마인더 | Cron, Wake류 | 시스템·게이트웨이에서 스케줄 실행 지원 필요. cron·스케줄러 설정 확인. |
| 브라우저 자동화 | Agent Browser 등 | 브라우저 환경·권한 필요. 원격 Mac에서는 GUI 또는 헤드리스 환경 필요. |
원격 Mac에서 Skill 사용 시 유의사항과 성능
원격 Mac(VNC 데스크톱 등)에서 OpenClaw를 돌릴 때 스킬 동작은 로컬과 같지만 다음을 유의하세요.
- 네트워크: 일부 스킬은 외부망·특정 API 접근이 필요합니다. 원격 노드가 아웃바운드 제한이 있으면 노드·게이트웨이에서 허용해야 합니다.
- GUI/브라우저 스킬: 디스플레이·로컬 브라우저가 필요한 스킬은 VNC가 있는 원격 Mac에서는 정상 사용 가능. 순수 SSH에 디스플레이가 없으면 다이얼로그·브라우저가 필요한 기능은 쓸 수 없을 수 있습니다.
- 경로·권한:
~/.openclaw/skills는 현재 사용자 디렉터리입니다. 다중 사용자·컨테이너에서는 사용자를 구분하고, 업데이트 시 다른 프로세스가 이 디렉터리를 쓰지 않도록 하세요.
함정과 FAQ: 스킬 충돌·의존·업데이트 후 반영 안 됨
스킬 깔았는데 안 돼? 먼저 openclaw skills list로 설치 여부를 확인하고, 스킬 설명에서 대화 트리거·추가 설정 필요 여부를 확인한 뒤, 로드 우선순위(워크스페이스 vs 사용자 디렉터리)를 확인하세요.
업데이트 후 이상해? 해당 스킬을 비활성화했다가 다시 활성화하거나, 특정 버전 재설치: openclaw skills install <skill-id>@<version>. Node·의존 버전이 바뀌었으면 실행 환경도 맞춰 업그레이드하세요.
스킬 충돌·중복 구현? 같은 기능 스킬을 여러 개 깔지 말고 하나만 두고 나머지는 비활성화하세요. 충돌 시 로그를 보거나 skills 디렉터리에서 잠시 빼서 격리해 보세요.
마무리: 스킬 시장으로 OpenClaw를 확장하면 검색·알림·문서·메시징을 대화에서 바로 할 수 있습니다. 로컬 Windows·Linux나 자체 VPS에서 OpenClaw를 돌리면 의존·권한·네트워크·GUI 제한을 자주 만나 스킬 설치·디버깅 비용이 듭니다. VNCMac 원격 Mac 대여로 VNC 데스크톱에서 OpenClaw를 실행하면 준비된 Mac에서 스킬 설치·OAuth 인증·브라우저 스킬을 그대로 쓸 수 있어 환경 차이로 인한 함정을 줄일 수 있습니다. 배포·장애 대응은 사이트 내 OpenClaw 블로그를, 노드·요금제 선택은 홈이나 구매 페이지를 이용하세요.