OpenClaw v2026.2 적용 | 본문은 기본 설치를 완료하고 AI 어시스턴트 능력을 확장하고 싶은 사용자를 대상으로 합니다.

TL;DR: Skills는 사전 패키징된 능력 확장입니다. openclaw skill install <name>으로 설치하고, 디렉토리는 ~/.openclaw/workspace/skills/입니다. ClawHub에는 5700개 이상의 커뮤니티 스킬이 있습니다: 코딩 어시스턴트, 검색 연구, 개발 운영, 웹 자동화 등. 각 스킬에는 SKILL.md(설명+트리거+지침), 선택적 도구 구현이 포함됩니다. 보안 스캔은 VirusTotal 검증을 통과합니다.

Skills란?

개념 설명

Skills는 사전 패키징된 능력 확장 모듈로, 다음을 포함합니다:

Skills vs Tools

스킬 분류

ClawHub의 스킬은 카테고리별로 구성됩니다:

Skills 설치 방법

방법 1: ClawHub CLI(권장)

# 스킬 검색
openclaw skill search gmail

# 스킬 설치
openclaw skill install gmail

# 특정 버전 설치
openclaw skill install [email protected]

# GitHub에서 설치
openclaw skill install github:user/skill-repo

# 로컬 경로에서 설치
openclaw skill install ./my-skill

방법 2: 수동 설치

# 스킬 저장소 클론
git clone https://github.com/user/skill-repo.git

# 스킬 디렉토리로 복사
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

방법 3: GitHub 링크 붙여넣기

채팅에서 스킬의 GitHub 링크를 직접 보내면 Agent가 자동으로 인식하여 설치합니다:

이 스킬을 설치해 주세요: https://github.com/user/skill-repo

스킬 디렉토리 구조

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

ClawHub 사용 가이드

ClawHub 접속

clawhub.com에 접속하여 사용 가능한 모든 스킬을 탐색합니다.

스킬 검색

# CLI 검색
openclaw skill search <키워드>

# 예시
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

스킬 상세 정보

각 스킬 페이지에는 다음이 포함됩니다:

보안 스캔

ClawHub는 VirusTotal과 협력하여 각 스킬에 대해 보안 스캔을 수행합니다:

# 스킬 보안 상태 확인
openclaw skill info gmail --security

# 출력 예시:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

설치 전 확인

# 스킬 의존성 확인
openclaw skill check gmail

# 출력 예시:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

스킬 설정

설정 파일 위치

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

SKILL.md 구조 상세

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

스킬 설정 파일

일부 스킬은 추가 설정이 필요합니다:

# 스킬 설정
openclaw skill config gmail

# 또는 수동으로 설정 파일 편집
vi ~/.openclaw/workspace/skills/gmail/config.json

설정 예시:

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

스킬 환경 변수

# 스킬 환경 변수 설정
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# 또는 .env 파일에
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

스킬 관리

설치된 스킬 확인

# 모든 스킬 나열
openclaw skill list

# 출력 예시:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

스킬 활성화/비활성화

# 스킬 비활성화
openclaw skill disable home-assistant

# 스킬 활성화
openclaw skill enable home-assistant

스킬 업데이트

# 단일 스킬 업데이트
openclaw skill update gmail

# 모든 스킬 업데이트
openclaw skill update --all

# 업데이트 가능 여부 확인
openclaw skill outdated

스킬 제거

# 스킬 제거
openclaw skill uninstall gmail

# 제거 및 설정 정리
openclaw skill uninstall gmail --purge

스킬 진단

# 스킬 문제 진단
openclaw skill diagnose gmail

# 출력 예시:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

추천 스킬

프로그래밍 개발

생산성

검색 연구

스마트 홈

스킬 개발 기초

새 스킬 생성

# 스킬 템플릿 생성
openclaw skill create my-skill

# 생성된 디렉토리 구조
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

SKILL.md 템플릿

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

도구 정의 추가

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

스킬 배포

# 스킬 검증
openclaw skill validate my-skill

# ClawHub에 배포
openclaw skill publish my-skill

# 또는 GitHub에 제출
git add .
git commit -m "Initial skill release"
git push origin main

스킬 보안

보안 모범 사례

스킬 권한

# 스킬 권한 확인
openclaw skill permissions gmail

# 출력 예시:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

스킬 권한 제한

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

스킬 충돌 해결

일반적인 충돌

충돌 해결

# 스킬 충돌 확인
openclaw skill conflicts

# 출력 예시:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# 스킬 우선순위 설정
openclaw skill priority gmail 10
openclaw skill priority outlook 5

격리 환경

의존성 충돌이 있는 스킬의 경우 격리 환경을 사용할 수 있습니다:

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

문제 해결

스킬이 작동하지 않음

# 스킬 상태 확인
openclaw skill list --status

# 스킬 로드 확인
openclaw skill load gmail --verbose

# 스킬 로그 확인
openclaw logs --filter skill:gmail

인증 실패

# 재인증
openclaw skill auth gmail --reauth

# 인증 상태 확인
openclaw skill auth gmail --status

의존성 문제

# 의존성 확인
openclaw skill deps gmail

# 의존성 설치
openclaw skill deps gmail --install

# 의존성 업데이트
openclaw skill deps gmail --update

스킬 로드 오류

# SKILL.md 문법 검증
openclaw skill validate gmail

# 출력 예시:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

요약

Skills 시스템은 OpenClaw 확장 능력의 핵심입니다:

• 풍부한 생태계: 5700개 이상의 커뮤니티 스킬로 다양한 시나리오 커버
• 간편한 설치: 한 줄 명령으로 설치
• 유연한 설정: 사용자 정의 및 오버라이드 지원
• 안전하고 제어 가능: 권한 관리 및 보안 스캔

적절한 스킬 선택과 설정을 통해 AI 어시스턴트에 무한한 능력 확장이 가능합니다.

본문 요약:

• Skills의 개념과 구조 이해
• 다양한 스킬 설치 및 관리 방법 습득
• ClawHub를 통한 스킬 발견 및 평가 방법 학습
• 스킬 보안 및 권한 관리 이해
• 스킬 개발 기초 지식 습득

업데이트 기록:

• 2026-02-26: 초판 발행, OpenClaw v2026.2 기반

시리즈 네비게이션:

• ← 이전: 다중 모델 설정 및 전환
• → 다음: Skills 개발 입문