Skills
Skills 만들기
Skills는 에이전트에게 도구를 사용하는 방법과 시점을 알려줍니다. 각 스킬은 YAML 프런트매터와 마크다운 지침이 포함된 SKILL.md 파일을 담은 디렉터리입니다.
스킬이 로드되고 우선순위가 지정되는 방식은 Skills를 참조하세요.
첫 번째 스킬 만들기
스킬 디렉터리 만들기
Skills는 작업 영역에 있습니다. 새 폴더를 만드세요.
mkdir -p ~/.openclaw/workspace/skills/hello-world
SKILL.md 작성하기
해당 디렉터리 안에 SKILL.md를 만드세요. 프런트매터는 메타데이터를 정의하고,
마크다운 본문에는 에이전트를 위한 지침이 포함됩니다.
---
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!".
스킬 name에는 소문자, 숫자, 하이픈으로 구성된 하이픈 표기법을 사용하세요.
폴더 이름과 프런트매터의 name을 일치시키세요.
도구 추가하기(선택 사항)
프런트매터에서 사용자 지정 도구 스키마를 정의하거나 에이전트가 기존 시스템 도구
(exec 또는 browser 등)를 사용하도록 지시할 수 있습니다. Skills는 설명하는 도구와 함께
Plugin 내부에 포함되어 배포될 수도 있습니다.
스킬 로드하기
OpenClaw가 스킬을 감지하도록 새 세션을 시작하세요.
# From chat
/new
# Or restart the gateway
openclaw gateway restart
스킬이 로드되었는지 확인하세요.
openclaw skills list
테스트하기
스킬을 트리거해야 하는 메시지를 보내세요.
openclaw agent --message "give me a greeting"
또는 에이전트와 채팅하면서 인사를 요청하세요.
스킬 메타데이터 참조
YAML 프런트매터는 다음 필드를 지원합니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
name |
예 | 소문자, 숫자, 하이픈을 사용하는 고유 식별자 |
description |
예 | 에이전트에 표시되는 한 줄 설명 |
metadata.openclaw.os |
아니요 | OS 필터(["darwin"], ["linux"] 등) |
metadata.openclaw.requires.bins |
아니요 | PATH에 필요한 바이너리 |
metadata.openclaw.requires.config |
아니요 | 필요한 구성 키 |
모범 사례
- 간결하게 작성하세요 — 모델에 AI가 되는 방법이 아니라 무엇을 해야 하는지 지시하세요
- 안전을 우선하세요 — 스킬이
exec를 사용하는 경우 프롬프트가 신뢰할 수 없는 입력으로부터 임의 명령 삽입을 허용하지 않도록 하세요 - 로컬에서 테스트하세요 — 공유하기 전에
openclaw agent --message "..."를 사용해 테스트하세요 - ClawHub를 사용하세요 — ClawHub에서 스킬을 둘러보고 기여하세요
스킬 위치
| 위치 | 우선순위 | 범위 |
|---|---|---|
\<workspace\>/skills/ |
가장 높음 | 에이전트별 |
\<workspace\>/.agents/skills/ |
높음 | 작업 영역 에이전트별 |
~/.agents/skills/ |
중간 | 공유 에이전트 프로필 |
~/.openclaw/skills/ |
중간 | 공유(모든 에이전트) |
| 번들(OpenClaw와 함께 제공됨) | 낮음 | 전역 |
skills.load.extraDirs |
가장 낮음 | 사용자 지정 공유 폴더 |
관련 항목
- Skills 참조 — 로드, 우선순위 및 게이팅 규칙
- Skills 구성 —
skills.*구성 스키마 - ClawHub — 공개 스킬 레지스트리
- Plugin 빌드하기 — Plugin은 스킬을 포함해 배포할 수 있음