Docker 환경에서 OpenClaw Skills 설치 가능하게 만들기 (clawhub cli 설치)

OpenClaw를 설치하면서 해보고 싶었던 것 중 하나가 검색 결과를 정리해서 Notion에 자동으로 문서를 만들어주는 기능이었다.

지금 OpenClaw에게 full 권한을 주었기에, 적당히 요청하면 어떻게든 될 것 같았지만, 추후에 다른 기능들도 설치하기 위해서, 이번에 환경을 제대로 구축해 두려고 했다.

 

Skill이란?

Skills - OpenClaw

공식 문서에서는 Skill을 OpenClaw 에이전트에게 특정 작업을 수행하는 방법을 알려주는 확장 기능으로 설명하고 있다.

 

하나의 Skill은 보통 하나의 디렉터리 형태로 구성되며, SKILL.md를 통해 OpenClaw에게 해당 기능을 어떻게 수행해야 하는지를 알려준다.

 

핵심 파일인 SKILL.md 에는 아래와 같은 정보가 들어있다.

• 어떤 작업을 수행하는지
• 어떤 도구를 사용해야 하는지
• 어떤 방식으로 실행해야 하는지

개인적으로는, skills를 아래와 같이 비유할 수 있다고 생각한다.

OpenClaw를 모험가라고 생각하면, Skills는 그 모험가의 능력이다.

모험가
├─ 검 공격 (전사 스킬)
├─ 파이어볼 (마법 스킬)
├─ 탐색 (정찰 스킬)
└─ 제작 (크래프트 스킬)

 

즉 OpenClaw에게 Skills를 추가한다는 것은, 모험가가 새로운 기술을 배우는 것 과 비슷하다.

개발자스럽게 비유하자면 OpenClaw는 VSCode, Skills는 Extensions 같은 느낌이라고 볼 수 있다.

 

필요한 기능을 Skills 형태로 추가하면, OpenClaw가 그 기능을 수행할 수 있게 된다.

 

설치 시작

Skills를 설치하기 위해서는 ClawHub를 사용한다.

ClawHub - OpenClaw

 

ClawHub는 OpenClaw에서 사용하는 공식 Skills 레지스트리로, 사용자들이 만든 Skills를 검색하고 설치할 수 있는 곳이다.

하지만 docker로 기동한 OpenClaw에는 clawhub가 설치되어 있지 않았다.

# OpenClaw 컨테이너 내부에서 실행
$ npx clawhub
Need to install the following packages: clawhub@0.8.0

 

 

이렇게 하면 설치할 수 있지만, npm과 node_modules가 volume으로 관리되고 있지 않기 때문에, 컨테이너가 재기동되면 clawhub가 사라지는 문제가 발생한다.

그래서 영구적으로 설치하기 위해, Dockerfile에서 설치하도록 추가한다.

vi Dockerfile

# 추가할 내용 (RUN pnpm build 이후)
USER root
RUN npm install -g clawhub
USER node

OpenClaw runtime 단계에서 CLI를 추가하는 게 좋을 것 같아서, pnpm build 이후에 설치하도록 추가했다.

 

파일을 저장한 후, 재시작을 해 준다.

# 종료
docker compose down

# 빌드 및 시작
sudo ./docker-setup.sh

# 빌드 후 나오는 설정창은 ESC를 눌러서 닫아주면 된다.

 

그럼 clawhub가 정상적으로 설치되었는지 확인해 보자.

docker compose run --rm openclaw-cli clawhub --version

 

오늘의 잡담

블로그엔 소개하지 않았지만, 매일 아침 7시에 날씨정보를 알려달라고 OpenClaw에게 요청했었다.

 

그랬었다 보니, 나도 모르는 사이에 Skill이 설치되어 있었다.

# 설치된 skills 확인 하는 명령어
docker compose run --rm openclaw-cli skills

 

full 권한을 줬다 보니, 스스로 뭔가를 잘 하기는 하는데, 역시 무섭긴 하다 (...)