스킬

개요

스킬(Skills)은 에이전트의 능력을 확장하는 모듈이다. AgentSkills 호환 형식의 폴더로 구성되며, SKILL.md 파일이 스킬의 핵심이다.

스킬 구조

my-skill/
├── SKILL.md           # 스킬 정의 (필수)
├── tools/             # 도구 스크립트 (선택)
│   └── my-tool.sh
└── resources/         # 리소스 파일 (선택)
    └── template.md

SKILL.md 형식

---
name: my_skill
description: "이 스킬은 ..."
metadata:
  openclaw:
    gates:
      - web_search
      - shell
---

# My Skill

## 사용법
이 스킬은 다음과 같이 동작합니다...

## 도구
- `my-tool`: 특정 작업을 수행합니다

프론트매터 필드

로딩 우선순위

스킬은 다음 순서로 로드되며, 상위 항목이 우선한다.

1. workspace    (최고 우선순위) - 에이전트 워크스페이스 내 스킬
2. project                     - 프로젝트 레벨 스킬
3. personal                    - 사용자 개인 스킬
4. managed                     - openclaw skills install로 설치한 스킬
5. bundled      (최저 우선순위) - OpenClaw 기본 내장 스킬

동일한 이름의 스킬이 여러 레벨에 존재하면 상위 레벨의 스킬이 사용된다. 이를 통해 기본 스킬을 오버라이드할 수 있다.

스킬 저장 위치

workspace/skills/          # 워크스페이스 스킬
~/.openclaw/skills/        # 개인 + 관리형 스킬
<openclaw-install>/skills/ # 번들 스킬

보안 주의사항

중요: 서드파티 스킬은 신뢰할 수 없는 것으로 취급해야 한다.

• 스킬은 에이전트의 권한으로 실행됨
• 설치 전 SKILL.md와 도구 스크립트를 반드시 검토
• 알 수 없는 출처의 스킬은 샌드박스 환경에서 테스트
• gates 설정으로 스킬이 접근할 수 있는 기능 제한

게이트(Gates) 설정

스킬이 요청하는 게이트를 통해 필요한 권한을 확인할 수 있다.

metadata:
  openclaw:
    gates:
      - web_search    # 웹 검색 권한
      - shell          # 셸 명령어 실행 권한
      - browser        # 브라우저 자동화 권한
      - network        # 네트워크 접근 권한

ClawHub 레지스트리

ClawHub는 OpenClaw 스킬의 공식 레지스트리이다. 커뮤니티가 만든 스킬을 검색하고 설치할 수 있다.

스킬 검색

openclaw skills search <keyword>

스킬 설치

openclaw skills install <slug>

예시:

# 웹 스크래핑 스킬 설치
openclaw skills install web-scraper

# 코드 리뷰 스킬 설치
openclaw skills install code-review

# 이메일 관리 스킬 설치
openclaw skills install email-manager

설치된 스킬 목록

openclaw skills list

스킬 제거

openclaw skills uninstall <slug>

스킬 활성화/비활성화

에이전트별로 사용할 스킬을 설정할 수 있다.

{
  "agents": {
    "default": {
      "skills": {
        "enabled": ["web-scraper", "code-review"],
        "disabled": ["email-manager"]
      }
    }
  }
}