OpenClaw 커스텀 Skill 만들기

새로운 도구를 도입했을 때, 기본 기능만으로는 내가 원하는 워크플로우를 100% 채우기 어렵다는 느낌을 받을 때가 있죠. 어시스턴트가 내 업무 방식을 이해하고 특정 작업을 자동으로 처리해 주길 바라지만, 복잡한 설정 때문에 포기하게 되는 경우도 많습니다.

OpenClaw는 이런 고민을 해결하기 위해 개발자가 직접 기능을 확장할 수 있는 ‘Skill’ 시스템을 제공해요. 복잡한 코드 뭉치 대신 간단한 설정 파일만으로 어시스턴트에게 새로운 능력을 부여할 수 있습니다.

필요한 것

• OpenClaw가 설치된 환경
• ~/.openclaw/workspace/skills/ 디렉토리 접근 권한

Quick Start: 5분 만에 Skill 만들기

가장 기본적인 “Hello World” Skill을 함께 만들어 볼게요.

1. 디렉토리 생성하기

Skill은 각각 독립된 디렉토리에 위치해야 합니다. 보통 ~/.openclaw/workspace/skills/ 경로를 사용해요. 터미널에서 아래 명령어를 입력해 폴더를 만드세요.

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

2. SKILL.md 파일 작성하기

생성한 디렉토리 안에 SKILL.md 파일을 만듭니다. 이 파일은 메타데이터를 위한 YAML frontmatter와 LLM에게 전달할 지침인 Markdown으로 구성됩니다.

---
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. OpenClaw에 반영하기

이제 OpenClaw가 새로운 Skill을 인식하도록 해야 합니다. 어시스턴트에게 “refresh skills”라고 말하거나, Gateway를 재시작해 주세요. OpenClaw가 자동으로 디렉토리를 스캔하고 SKILL.md를 인덱싱합니다.

Best Practices

Skill을 더 효과적으로 만들기 위한 몇 가지 팁을 추천해 드릴게요.

• 간결하게 작성하세요: 모델에게 AI로서 어떻게 행동해야 하는지 설명하기보다, 구체적으로 ‘무엇’을 해야 하는지 지시하는 것이 좋습니다.
• 보안을 먼저 생각하세요: 만약 Skill에서 bash를 사용한다면, 신뢰할 수 없는 사용자 입력이 임의의 커맨드 인젝션으로 이어지지 않도록 프롬프트를 설계해야 합니다.
• 로컬에서 테스트하세요: 아래 명령어를 사용하면 특정 메세지로 Skill이 잘 작동하는지 바로 확인할 수 있습니다.

  openclaw agent --message "use my new skill"

문제 해결

• Skill이 목록에 나타나지 않나요?: “refresh skills” 명령어를 어시스턴트에게 전달했는지, 혹은 Gateway를 재시작했는지 확인해 보세요.
• 명령어 실행 오류가 발생하나요?: bash 도구를 사용할 때 사용자 입력이 포함된다면 보안 가이드에 따라 프롬프트를 수정해야 할 수도 있습니다.

궁금한 점이 있거나 설정 중에 막히는 부분이 있다면 AI Setup Assistant에게 바로 물어보세요!

다음 단계

• ClawHub: 다른 개발자들이 공유한 Skill을 둘러보고 직접 기여해 보세요.