Skills

Skills 만들기

Skills는 에이전트가 도구를 사용하는 방법과 시점을 알려줍니다. 각 스킬은 YAML 프런트매터와 markdown 지침이 포함된 SKILL.md 파일을 담은 디렉터리입니다.

스킬이 로드되고 우선순위가 지정되는 방식은 Skills를 참조하세요.

첫 번째 스킬 만들기

스킬 디렉터리 만들기

Skills는 워크스페이스에 있습니다. 새 폴더를 만드세요.

bash

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

SKILL.md 작성

해당 디렉터리 안에 SKILL.md를 만드세요. 프런트매터는 메타데이터를 정의하고, markdown 본문은 에이전트를 위한 지침을 포함합니다.

markdown

---name: hello-worlddescription: 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가 스킬을 인식하도록 새 세션을 시작하세요.

bash

# From chat/new # Or restart the gatewayopenclaw gateway restart

스킬이 로드되었는지 확인하세요.

bash

openclaw skills list

테스트

스킬을 트리거해야 하는 메시지를 보내세요.

bash

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`	아니요	필요한 config 키

모범 사례

간결하게 작성 — AI가 되는 방법이 아니라 모델이 무엇을 해야 하는지 지시하세요
안전을 최우선으로 — 스킬이 exec를 사용하는 경우 프롬프트가 신뢰할 수 없는 입력에서 임의 명령 삽입을 허용하지 않도록 하세요
로컬에서 테스트 — 공유하기 전에 openclaw agent --message "..."를 사용해 테스트하세요
ClawHub 사용 — ClawHub에서 스킬을 둘러보고 기여하세요

스킬 위치

위치	우선순위	범위
`\<workspace\>/skills/`	가장 높음	에이전트별
`\<workspace\>/.agents/skills/`	높음	워크스페이스 에이전트별
`~/.agents/skills/`	중간	공유 에이전트 프로필
`~/.openclaw/skills/`	중간	공유(모든 에이전트)
번들(OpenClaw와 함께 제공)	낮음	전역
`skills.load.extraDirs`	가장 낮음	사용자 지정 공유 폴더

Skills 만들기

첫 번째 스킬 만들기

스킬 디렉터리 만들기

SKILL.md 작성

도구 추가(선택 사항)

스킬 로드

테스트

스킬 메타데이터 참조

모범 사례

스킬 위치

관련 항목

Molty