Openclaw용 Local Skill Installer

로컬 스킬 패키지를 Openclaw 환경에 압축 해제, 검증 및 배포하기 위한 안전한 유틸리티입니다.

leialexzhang
v1.0.1
Mar 15, 2026
0
918
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install local-skill-installer

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 local-skill-installer 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Local Skill Installer란 무엇인가요?

Local Skill Installer는 로컬 아카이브에서 커스텀 에이전트 기능을 배포하는 과정을 간소화하기 위해 설계된 전문 유틸리티입니다. 압축 해제 및 검증 프로세스를 자동화하여 모든 패키지가 에코시스템에서 요구하는 기술 표준을 준수하도록 보장합니다. 이 도구를 사용함으로써 개발자는 수동 파일 조작 없이 Openclaw Skills를 관리할 수 있어 디렉토리 손상이나 구성 오류의 위험을 줄일 수 있습니다.

이 스킬은 파일 이동이 발생하기 전에 안전 점검을 수행하여 시스템 무결성을 최우선으로 합니다. 임시 추출 상태에서 최종 프로덕션 디렉토리로의 전환을 처리하며, 다운로드된 zip 파일과 활성 상태의 기능적인 AI 에이전트 기능 사이의 원활한 가교 역할을 합니다.

Local Skill Installer 활용 사례

  • 로컬 개발 디렉토리에서 글로벌 구성 폴더로 커스텀 빌드된 스킬 배포.
  • zip 아카이브 또는 사내 리포지토리를 통해 공유된 타사 Openclaw Skills 설치.
  • 엄격한 검증을 보장하면서 서로 다른 Linux 기반 워크스페이스 간에 스킬 패키지 마이그레이션.
  • 내장된 충돌 감지 및 검증 로직을 활용하여 새로운 스킬 버전을 안전하게 테스트.

Local Skill Installer 작동 원리

  1. 경로 확인: 설치 프로그램이 Linux 호환 경로를 사용하여 소스 zip 파일의 존재를 확인합니다.
  2. 격리된 추출: 활성 시스템 파일과의 간섭을 방지하기 위해 파일을 임시 디렉토리에 압축 해제합니다.
  3. 무결성 검증: 스킬은 SKILL.md 파일과 같은 필수 구성 요소 및 선택적 메타데이터가 패키지에 있는지 검사합니다.
  4. 대상 확인: 일반적으로 ~/.openclaw/skills/ 또는 워크스페이스 전용 디렉토리를 우선순위로 하여 최적의 대상을 식별합니다.
  5. 안전한 이동: 이름 충돌이 감지되지 않으면 스킬 폴더를 활성 디렉토리로 이동하고 최종 파일 구조를 확인합니다.
  6. 정리 및 보고: 임시 파일이 삭제되고 상세한 상태 보고서가 사용자에게 생성됩니다.

Local Skill Installer 설정 가이드

이 설치 프로그램을 사용하려면 Openclaw 환경이 활성화되어 있고 Linux 시스템에 유효한 스킬 zip 파일이 있는지 확인하십시오.

# 로컬 설치 시작 예시
# zip 패키지 경로를 제공하여 스킬 사용
/mnt/c/Users/developer/downloads/new-capability-v1.zip

에이전트가 홈 디렉토리 구조 내에서 파일을 이동할 수 있도록 권한이 설정되어 있는지 확인하십시오.

Local Skill Installer 데이터 스키마 및 분류 체계

설치 프로그램은 Openclaw Skills 표준과의 호환성을 보장하기 위해 검증 단계에서 특정 디렉토리 구조를 강제합니다.

파일/폴더 필수 여부 설명
SKILL.md 필수 AI 에이전트를 위한 핵심 문서 및 지침 세트.
_meta.json 선택 사항 버전 관리, 작성자 정보 및 종속성 메타데이터 포함.
assets/ 선택 사항 스킬에서 사용하는 정적 파일, 이미지 또는 구성.
agents/ 선택 사항 스킬과 관련된 특정 에이전트 정의.
references/ 선택 사항 외부 문서 또는 지식 베이스 파일.

Local Skill Installer 고급 기능

  • 충돌 방지: 동일한 이름의 스킬 디렉토리가 이미 존재하는 경우 설치를 중단하여 실수로 덮어쓰는 것을 방지하는 지능형 로직.
  • 워크스페이스 인식: 컨텍스트에 따라 글로벌 공유 디렉토리 (~/.openclaw/skills/)와 로컬 워크스페이스 전용 폴더 중에서 동적으로 선택.
  • 원자적 작업: 단일 소스 무결성을 유지하고 디스크 점유 공간을 최소화하기 위해 복사 대신 이동 작업을 사용.
  • 설치 후 검증: 이동 후 주요 파일의 존재 여부를 자동으로 확인하여 스킬이 즉시 사용 가능한 상태인지 보장.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*