Skills

• 기본적으로 모든 Skills를 제한 없이 유지하려면 agents.defaults.skills를 생략합니다.
• agents.defaults.skills를 상속하려면 agents.list[].skills를 생략합니다.
• 해당 에이전트에 Skills를 전혀 공개하지 않으려면 agents.list[].skills: []로 설정합니다.
• 비어 있지 않은 agents.list[].skills 목록이 최종 집합이며 기본값과 병합되지 않습니다.
• 유효 허용 목록은 프롬프트 빌드, 슬래시 명령 검색, 샌드박스 동기화, Skills 스냅샷 전체에 적용됩니다.
• 이는 호스트 셸의 권한 부여 경계가 아닙니다. 동일한 에이전트가 exec를 사용할 수 있다면 샌드박싱, OS 사용자 격리, 실행 거부/허용 목록, 리소스별 자격 증명을 사용하여 해당 셸을 별도로 제한하세요.

openclaw skills install은 기본적으로 활성 워크스페이스의 skills/ 디렉터리에 설치합니다. --global을 추가하면 공유 ~/.openclaw/skills 디렉터리에 설치되어, 에이전트 허용 목록으로 범위를 좁히지 않는 한 모든 로컬 에이전트에 표시됩니다.

Git 및 로컬 설치에서는 소스 루트에 SKILL.md가 있어야 합니다. 슬러그는 유효한 경우 SKILL.md 프런트매터의 name에서 가져오며, 그렇지 않으면 디렉터리 또는 저장소 이름을 사용합니다. 재정의하려면 --as <slug>를 사용하세요. openclaw skills update는 ClawHub 설치만 추적합니다. Git 또는 로컬 소스를 새로 고치려면 다시 설치하세요.

openclaw skills verify @owner/<slug>는 ClawHub에 Skills의 clawhub.skill.verify.v1 신뢰 범위를 요청합니다. 설치된 ClawHub Skills는 .clawhub/origin.json에 기록된 버전과 레지스트리를 기준으로 검증됩니다. 기존에 설치되었거나 모호하지 않은 Skills에는 소유자 없는 슬러그도 계속 허용되지만, 소유자가 포함된 참조를 사용하면 게시자 모호성을 피할 수 있습니다.

ClawHub Skills 페이지에는 설치 전에 최신 보안 검사 상태가 표시되며, VirusTotal, ClawScan, 정적 분석에 대한 세부 정보 페이지도 제공됩니다. ClawHub에서 검증을 실패로 표시하면 명령이 0이 아닌 코드로 종료됩니다. 게시자는 ClawHub 대시보드 또는 clawhub skill rescan @owner/<slug>를 통해 오탐을 해결할 수 있습니다.

ClawHub 이외의 전달 방식이 필요한 Gateway 클라이언트는 skills.upload.begin, skills.upload.chunk, skills.upload.commit을 사용하여 ZIP Skills 아카이브를 스테이징한 다음 skills.install({ source: "upload", ... })로 설치할 수 있습니다. 이 경로는 기본적으로 비활성화되어 있으며 openclaw.json에서 skills.install.allowUploadedArchives: true가 필요합니다. 일반적인 ClawHub 설치에는 이 설정이 필요하지 않습니다.

워크스페이스, 프로젝트 에이전트, 추가 디렉터리의 Skills 검색은 확인된 실제 경로가 구성된 루트 내부에 유지되는 Skills 루트만 허용합니다. 단, skills.load.allowSymlinkTargets가 대상 루트를 명시적으로 신뢰하는 경우는 예외입니다. Skills 워크숍은 skills.workshop.allowSymlinkTargetWrites가 활성화된 경우에만 해당 신뢰 대상에 씁니다. 관리형 ~/.openclaw/skills와 개인용 ~/.agents/skills에는 심볼릭 링크로 연결된 Skills 폴더가 포함될 수 있지만, 모든 SKILL.md의 실제 경로는 확인된 Skills 디렉터리 내부에 있어야 합니다.

Skills 설치를 계속하기 전에 신뢰할 수 있는 로컬 정책 명령을 실행하도록 security.installPolicy를 구성하세요. 정책은 메타데이터와 스테이징된 소스 경로를 받아 ClawHub, 업로드, Git, 로컬, 업데이트, 종속성 설치 프로그램 경로에 적용되며, 명령이 유효한 결정을 반환하지 못하면 설치를 차단합니다.

skills.entries.*.env와 skills.entries.*.apiKey는 해당 에이전트 턴 동안에만 비밀 정보를 호스트 프로세스에 주입하며 샌드박스에는 주입하지 않습니다. 프롬프트와 로그에 비밀 정보를 포함하지 마세요.

• 여러 설치 프로그램이 나열되면 Gateway는 선호 옵션 하나를 선택합니다 (사용 가능한 경우 brew, 그렇지 않으면 node).
• 모든 설치 프로그램이 download이면 OpenClaw은 사용 가능한 모든 아티팩트를 확인할 수 있도록 각 항목을 나열합니다.
• 사양에 os: ["darwin"|"linux"|"win32"]를 포함하여 플랫폼별로 필터링할 수 있습니다.
• Node 설치는 openclaw.json의 skills.install.nodeManager를 따릅니다 (기본값: npm, 옵션: npm / pnpm / yarn / bun). 이는 Skills 설치에만 영향을 주며 Gateway 런타임은 계속 Node여야 합니다.
• Gateway 설치 프로그램 우선순위: Homebrew → uv → 구성된 node 관리자 → go → download.

• Homebrew: OpenClaw은 Homebrew를 자동으로 설치하거나 brew 수식을 시스템 패키지 명령으로 변환하지 않습니다. brew가 없는 Linux 컨테이너에서는 brew 전용 설치 프로그램이 숨겨집니다. 사용자 지정 이미지를 사용하거나 종속성을 수동으로 설치하세요.
• Go: OpenClaw에서 Skills를 자동으로 설치하려면 Go 1.21 이상이 필요합니다. go가 없고 Homebrew를 사용할 수 있으면 OpenClaw은 먼저 Homebrew를 통해 Go를 설치합니다. Homebrew가 없는 Linux에서는 갱신된 golang-go 후보가 최소 버전을 충족할 경우 대신 루트 권한으로 apt-get을 사용하거나 암호 없는 sudo를 통해 사용할 수 있습니다. 종속성에 대한 실제 go install은 구성된 GOBIN이 아니라 항상 OpenClaw이 관리하는 전용 bin 디렉터리(새로 설치한 경우 Homebrew의 bin, 그렇지 않으면 ~/.local/bin)를 대상으로 합니다. 사용자의 GOBIN, GOPATH, GOTOOLCHAIN 환경 변수는 읽지만 절대 덮어쓰지 않습니다.
• 다운로드: url(필수), archive(tar.gz | tar.bz2 | zip), extract(기본값: 아카이브 감지 시 자동), stripComponents, targetDir(기본값: ~/.openclaw/tools/<skillKey>).

requires.bins는 Skills 로드 시점에 호스트에서 확인됩니다. 에이전트가 샌드박스에서 실행되는 경우 바이너리가 컨테이너 내부에도 있어야 합니다. agents.defaults.sandbox.docker.setupCommand 또는 사용자 지정 이미지를 통해 설치하세요. setupCommand는 컨테이너 생성 후 한 번 실행되며, 네트워크 송신, 쓰기 가능한 루트 파일 시스템, 샌드박스 내 루트 사용자가 필요합니다.

기본적으로 OpenClaw은 Skills 폴더를 감시하고 SKILL.md 파일이 변경되면 스냅샷을 갱신합니다. skills.load 아래에서 구성하세요.

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

Skills 루트 심볼릭 링크가 구성된 루트 외부를 가리키는 의도적인 심볼릭 링크 레이아웃에는 allowSymlinkTargets를 사용하세요. 예: <workspace>/skills/manager -> ~/Projects/manager/skills. Skill Workshop이 신뢰할 수 있는 해당 심볼릭 링크 경로를 통해 제안도 적용해야 하는 경우에만 skills.workshop.allowSymlinkTargetWrites를 활성화하세요.

Gateway가 Linux에서 실행되지만 system.run이 허용된 macOS node가 연결된 경우, 필요한 바이너리가 해당 node에 있으면 OpenClaw은 macOS 전용 Skills를 사용할 수 있는 것으로 처리할 수 있습니다. 에이전트는 host=node를 사용하여 exec 도구를 통해 해당 Skills를 실행해야 합니다.

오프라인 node는 원격 전용 Skills를 표시되게 하지 않습니다. node가 바이너리 탐색에 응답하지 않으면 OpenClaw은 캐시된 바이너리 일치 정보를 지웁니다.