Skills 시스템 개요
기준일: 2026-07-13 난이도: 중급 공식 기준: Skills, Skills CLI
OpenClaw Skill은 agent에게 tool을 언제, 어떻게 사용할지 가르치는 Markdown 지침입니다. 각 Skill은 YAML frontmatter와 Markdown 본문을 가진 SKILL.md를 중심으로 구성됩니다.
핵심 개념
OpenClaw는 같은 이름의 Skill이 여러 위치에 있을 때 다음 우선순위를 적용합니다.
<workspace>/skills<workspace>/.agents/skills~/.agents/skills~/.openclaw/skills- bundled skills
- extra directories와 plugin skills
Skill 위치와 agent visibility는 별개입니다. agents.defaults.skills와 agents.list[].skills allowlist로 agent별 노출을 제한할 수 있지만, 이는 host shell 권한 경계가 아닙니다. exec 권한은 sandbox와 별도 policy로 제한합니다.
선택 기준
- 한 agent의 workspace에만 적용하려면
<workspace>/skills를 사용합니다. - 모든 로컬 agent가 공유해야 하면
~/.openclaw/skills를 검토합니다. - 외부 registry에서 설치할 때는 owner-qualified ref와 verification을 사용합니다.
- Skill이 binary, env, config를 요구하면
metadata.openclaw.requires로 eligibility를 선언합니다. - 비밀 값은 prompt나
SKILL.md본문에 넣지 않습니다.
실습
설치된 Skill의 현재 상태를 읽기 전용으로 확인합니다.
openclaw skills list --eligible
openclaw skills check
openclaw skills info <name> --json
ClawHub Skill은 설치 전에 trust envelope를 확인합니다.
openclaw skills verify @owner/<slug>
openclaw skills install @owner/<slug>
공식 CLI는 openclaw skills install weather 같은 모호한 이름보다 @owner/<slug>, Git source, local directory 형식을 문서화합니다.
도구에 입력할 프롬프트
현재 OpenClaw Skills를 읽기 전용으로 감사해줘.
로딩 위치, 같은 이름 충돌, agent allowlist, required binary/env/config,
ClawHub verification 상태를 확인하고
shell 권한과 Skill visibility를 별도로 평가해줘.
체크리스트
- Skill이
SKILL.md형식인지 확인했다. - 로딩 우선순위와 같은 이름 충돌을 확인했다.
- agent allowlist와 shell 권한을 혼동하지 않았다.
- third-party Skill을 untrusted code로 검토했다.
- secret을 prompt와 log에 남기지 않았다.
다음 단계
- Skill 만들기에서 최소
SKILL.md를 작성합니다. - Skill 사용에서 eligibility와 호출을 확인합니다.
- 플러그인과 ClawHub에서 배포·검증 경계를 봅니다.