맞춤형 OpenClaw 스킬 구축 방법 — 단계별 가이드

소개

OpenClaw 스킬은 에이전트에 도구를 노출하는 MCP (Model Context Protocol) 서버입니다. 스킬을 구축하면 에이전트에 API 액세스부터 하드웨어 제어, 파일 처리까지 새로운 기능을 제공할 수 있습니다. 스킬은 OpenClaw 에이전트가 대화 외에 다른 작업을 수행하도록 하는 주요 방법입니다.

필수 조건

Node.js 18+ 또는 Python 3.10+ 설치
기본 프로그래밍 지식(TypeScript 또는 Python 권장)
테스트를 위한 활성 에이전트가 있는 KiwiClaw 계정
OpenClaw 아키텍처에 대한 지식

단계별 지침

1단계: 스킬 형식 이해

OpenClaw 스킬은 하나 이상의 도구를 노출하는 MCP 서버입니다. 각 도구에는 이름, 설명, 입력 스키마 및 핸들러 함수가 있습니다. 에이전트는 사용 가능한 도구를 검색하고 대화 컨텍스트에 따라 언제 호출할지 결정합니다.

2단계: 개발 환경 설정

새 프로젝트 디렉토리를 만듭니다. TypeScript를 사용하는 경우 npm init로 초기화하고 MCP SDK를 설치합니다. Python을 사용하는 경우 가상 환경을 설정하고 MCP Python 패키지를 설치합니다.

3단계: 스킬 매니페스트 생성

스킬의 메타데이터(이름, 버전, 설명, 작성자 및 제공하는 도구 목록)를 정의합니다. 이 매니페스트는 OpenClaw에 스킬이 수행할 수 있는 작업을 알려줍니다.

4단계: 도구 핸들러 작성

각 도구에 대한 함수를 구현합니다. 도구 핸들러는 입력 매개변수를 받아 결과를 반환합니다. 예를 들어 날씨 스킬은 도시 이름을 받아 날씨 API를 호출하여 현재 일기 예보를 반환할 수 있습니다.

5단계: 로컬 테스트

스킬을 로컬에서 실행하고 KiwiClaw 에이전트에 대해 테스트합니다. 로컬 서버를 가리켜 대시보드의 스킬 페이지를 사용하여 스킬을 설치합니다. 각 도구가 올바르게 작동하는지 확인합니다.

6단계: 마켓플레이스에 게시

스킬이 준비되면 KiwiClaw 스킬 마켓플레이스에 제출하세요. 저희 팀은 보안 및 품질에 대한 제출물을 검토합니다. 승인되면 다른 사용자가 스킬을 설치할 수 있습니다. 무료 또는 유료로 설정할 수 있습니다.

유용한 팁

스킬 생성기부터 시작하세요. -- 이 메타 스킬은 에이전트가 다른 스킬을 구축하도록 돕고 상용구 코드를 생성합니다.
도구를 집중적으로 유지하세요 -- 각 도구는 한 가지 작업을 잘 수행해야 합니다. 여러 개의 작은 도구가 하나의 복잡한 도구보다 낫습니다.
오류를 정상적으로 처리하세요 -- 에이전트가 사용자에게 문제 발생 원인을 설명할 수 있도록 유익한 오류 메시지를 반환하세요.
좋은 설명을 추가하세요 -- 에이전트는 도구 설명을 사용하여 언제 호출할지 결정합니다. 명확하고 구체적인 설명은 더 나은 도구 선택으로 이어집니다.

자주 묻는 질문

What programming language can I use for OpenClaw skills?

OpenClaw 스킬은 MCP 서버이므로 MCP 프로토콜을 지원하는 모든 언어를 사용할 수 있습니다. 대부분의 스킬은 TypeScript 또는 Python으로 작성되지만 Go, Rust 및 기타 언어도 작동합니다.

Can I monetize my OpenClaw skill?

예. 스킬을 KiwiClaw 마켓플레이스에 게시하고 가격을 설정하세요. KiwiClaw는 결제, 배포 및 리뷰를 처리합니다. 누군가 유료 스킬을 설치할 때마다 수익을 얻을 수 있습니다. 자세한 내용은 게시 가이드를 참조하세요.

How are skills reviewed for security?

모든 마켓플레이스 제출물은 KiwiClaw의 심사 과정을 거칩니다. 마켓플레이스에 대한 스킬을 승인하기 전에 소스 코드를 검토하고, 악성 동작을 확인하고, 권한을 확인하고, 기능을 테스트합니다.

소개