스킬 및 플러그인

새로운 OpenClaw 사용자가 가장 많이 하는 질문은 "스킬, 플러그인, 도구의 차이가 뭐예요?"입니다. 비슷하게 들리지만 완전히 다른 계층에서 작동합니다. 이 구분을 이해하는 것이 에이전트를 효과적으로 확장하는 핵심입니다.

세 가지 계층

OpenClaw의 확장성은 명확한 체인으로 함께 작동하는 세 가지 계층 위에 구축됩니다:

체인은 다음과 같이 흐릅니다:

플러그인 → 자체 스킬을 포함할 수 있음 → 스킬은 에이전트에게 도구 사용법을 가르침 → 도구가 작업을 실행

도구: 기반 계층

도구는 에이전트가 세계와 상호작용할 수 있게 하는 26개의 내장 기능입니다. 모든 도구는 위험 등급이 분류되어 있습니다:

• 안전 — read, web_search, list_directory 같은 읽기 전용 작업
• 중간 — write, edit, browser 같은 쓰기 작업
• 높음 — exec, shell 같은 무제한 실행

openclaw.json의 tools.allow 설정을 통해 에이전트가 접근할 수 있는 도구를 제어합니다. 에이전트가 웹 검색과 파일 읽기만 필요하다면 exec을 부여하지 마세요.

스킬: 지능 계층

스킬은 가장 오해를 받는 부분입니다. 스킬은 코드가 아닙니다. 에이전트의 시스템 프롬프트에 로드되는 YAML 프론트매터가 포함된 구조화된 문서(SKILL.md)입니다. 이미 가지고 있는 도구를 사용하여 작업을 수행하는 방법을 에이전트에게 가르칩니다.

예를 들어, github 스킬에는 GitHub API 코드가 포함되어 있지 않습니다. 대신 PR 생성, 코드 리뷰, 이슈 관리를 위해 exec 도구를 사용하여 gh CLI 명령을 실행하는 방법을 에이전트에게 상세히 알려주는 지시사항이 포함되어 있습니다.

스킬은 점진적 공개를 사용합니다 — 에이전트는 현재 대화와 관련된 스킬 지시사항만 로드하여 컨텍스트 윈도우를 효율적으로 유지합니다.

플러그인: 플랫폼 계층

플러그인은 시스템 수준에서 OpenClaw를 확장하는 실제 런타임 코드입니다. 네 가지 유형이 있습니다:

• 채널 플러그인 — 새로운 메시징 플랫폼 연결 (Telegram, Discord, Slack, WhatsApp)
• 메모리 플러그인 — 영구 메모리 백엔드 추가 (벡터 스토어, 데이터베이스)
• 도구 플러그인 — 26개 내장 도구 외에 완전히 새로운 도구 기능 등록
• 제공업체 플러그인 — 커스텀 LLM 제공업체 추가

대부분의 사용자는 플러그인을 직접 작성할 필요가 없습니다. 스킬과 내장 도구가 대다수의 사용 사례를 커버합니다.

알아두면 좋은 내장 스킬

OpenClaw는 53개의 스킬을 기본 번들로 제공합니다. 실제로 많이 사용되는 것들은 다음과 같습니다:

개발

AI 및 생성

커뮤니케이션

생산성

스마트 홈 및 미디어

유틸리티

ClawHub 에코시스템

53개 번들 스킬 외에, ClawHub는 13,700개 이상의 스킬이 있는 커뮤니티 마켓플레이스입니다. 가장 인기 있는 것들은 대규모로 채택되고 있습니다:

• 웹 브라우징 — 180,000회 이상 설치
• Telegram 통합 — 145,000회 이상 설치

ClawHub의 스킬은 AI/ML, 유틸리티, 개발, 생산성, 웹, 과학, 미디어, 소셜, 금융 등의 카테고리로 분류됩니다.

양질의 스킬 찾기

13,700개 이상의 스킬이 있으므로 품질은 크게 다릅니다. 좋은 스킬을 찾는 방법:

MCP 도구

OpenClaw는 Model Context Protocol (MCP)를 네이티브로 지원하여 외부 도구 서버를 에이전트에 연결할 수 있습니다. 전용 OpenClaw 스킬이 없는 서비스와 통합할 때 특히 유용합니다.

설정은 openclaw.json의 mcpServers 섹션에 작성합니다:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-google-drive"]
    }
  }
}

Google Drive, Slack, 데이터베이스(PostgreSQL, MongoDB), 클라우드 플랫폼(AWS, GCP, Azure) 등을 지원하는 1,000개 이상의 커뮤니티 MCP 서버가 있습니다. 각 MCP 서버는 에이전트가 직접 호출할 수 있는 자체 도구 세트를 제공합니다.

보안: ClawHavoc 사건

2026년 1-2월, OpenClaw 커뮤니티는 ClawHub의 악성 스킬을 통한 조직적인 공급망 공격인 ClawHavoc을 경험했습니다. 이론적인 이야기가 아니라 실제로 일어난 일입니다.

무슨 일이 있었나

12개의 퍼블리셔 계정을 통해 공격자들이 다음을 포함하는 1,184개의 악성 스킬을 업로드했습니다:

• 리버스 셸 — 공격자에게 호스트 머신에 대한 원격 접근 권한 제공
• 데이터 유출 — 파일, 자격 증명, 환경 변수를 조용히 업로드
• AMOS 스틸러 — 브라우저 비밀번호와 암호화폐 지갑을 대상으로 하는 macOS 전용 멀웨어
• MEMORY.md를 통한 영구 감염 — 에이전트의 영구 메모리에 지시사항을 주입하여 스킬 제거 후에도 악성 동작이 지속

대응

OpenClaw는 VirusTotal과 협력하여 2,400개 이상의 의심스러운 스킬을 제거했습니다. 사용자가 검증된 퍼블리셔와 익명 업로드를 구분할 수 있도록 퍼블리셔 인증이 도입되었습니다.

그러나 이후 Snyk 감사에서 ClawHub 스킬의 36%에 여전히 어떤 형태의 프롬프트 인젝션이 포함되어 있다는 것이 발견되었습니다. VirusTotal은 바이너리 멀웨어와 알려진 공격 패턴을 감지하지만, 에이전트의 동작을 미묘하게 조작하는 스킬 내에 숨겨진 자연어 프롬프트 인젝션은 감지할 수 없습니다.

안전하게 사용하는 방법

커뮤니티 스킬을 사용한다면 이러한 관행은 선택이 아닙니다:

1. 검증되지 않은 모든 스킬은 설치 전에 감사하세요. SKILL.md 파일을 읽으세요. 텍스트 문서이므로 몇 시간이 아니라 몇 분이면 됩니다.
2. allowBundled를 사용하여 필요한 스킬만 화이트리스트하세요. 5개만 사용한다면 53개 번들 스킬을 모두 로드하지 마세요.
3. 스킬 버전을 고정하세요. 커뮤니티 스킬을 자동 업데이트하지 마세요. 업그레이드 전에 변경 로그를 검토하세요.
4. 정기적으로 openclaw security audit를 실행하세요. 설치된 스킬에서 알려진 악성 패턴을 검사합니다.
5. tools.allow를 최소화하세요. 에이전트가 셸 접근이 필요하지 않다면 exec을 부여하지 마세요. 손상된 스킬의 피해 범위는 에이전트가 접근할 수 있는 도구로 제한됩니다.

Claw Buff에서 스킬 관리

Claw Buff에서는 openclaw.json을 직접 편집하는 대신 콘솔을 통해 스킬을 관리합니다.

스킬 활성화 및 비활성화 — 설치된 각 스킬에는 콘솔의 Agent 섹션에 토글이 있습니다. 비활성화된 스킬은 에이전트의 컨텍스트에 로드되지 않습니다.

API 키 설정 — 외부 서비스 자격 증명이 필요한 스킬(spotify-player나 notion 등)에는 필요한 환경 변수를 설정할 수 있는 인라인 설정 필드가 있습니다.

ClawHub에서 검색 및 설치 — 컨테이너에 SSH 접근 없이 콘솔에서 직접 ClawHub 스킬을 검색하고 설치할 수 있습니다.

바이너리 종속성 — 일부 스킬은 외부 바이너리가 필요합니다(미디어 처리용 ffmpeg이나 GitHub용 gh 등). 스킬에 컨테이너에 사전 설치되지 않은 바이너리가 필요하면 설치 중에 종속성 알림이 표시됩니다. 추가 시스템 패키지가 필요하면 지원팀에 문의하세요.