커스텀 스킬 만들기

OpenClaw는 쉽게 확장할 수 있도록 설계되었습니다. “스킬”은 어시스턴트에 새로운 기능을 추가하는 주요 방법입니다.

스킬이란?

스킬은 SKILL.md 파일(LLM에 지시 사항과 도구 정의를 제공)과 선택적으로 일부 스크립트 또는 리소스가 포함된 디렉터리입니다.

단계별 가이드: 첫 번째 스킬 만들기

1. 디렉터리 생성

스킬은 워크스페이스에 위치하며, 보통 ~/.openclaw/workspace/skills/입니다. 스킬을 위한 새 폴더를 만드세요:

mkdir -p ~/.openclaw/workspace/skills/hello-world

2. SKILL.md 정의

해당 디렉터리에 SKILL.md 파일을 만드세요. 이 파일은 메타데이터에 YAML 프론트매터를, 지시 사항에 마크다운을 사용합니다.

---
name: hello_world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say "Hello from your custom skill!".

3. 도구 추가 (선택)

프론트매터에 커스텀 도구를 정의하거나, 기존 시스템 도구(bash 또는 browser 등)를 사용하도록 에이전트에 지시할 수 있습니다.

4. OpenClaw 새로고침

에이전트에게 “스킬을 새로고침해줘”라고 요청하거나 게이트웨이를 재시작합니다. OpenClaw가 새 디렉터리를 발견하고 SKILL.md를 인덱싱합니다.

모범 사례

  • 간결하게 작성: 모델에게 무엇을 해야 하는지 지시하세요. AI의 역할을 설명하지 마세요.
  • 안전 우선: 스킬이 bash를 사용하는 경우, 프롬프트가 신뢰할 수 없는 사용자 입력에 의한 임의 명령 주입을 허용하지 않도록 하세요.
  • 로컬 테스트: openclaw agent --message "use my new skill"로 테스트하세요.

공유 스킬

ClawHub에서 스킬을 탐색하고 기여할 수도 있습니다.