​

스킬 (OpenClaw)

​

스킬 위치 및 우선순위

1. 번들 스킬: 설치와 함께 제공됨 (npm 패키지 또는 OpenClaw.app)
2. 관리형/로컬 스킬: ~/.openclaw/skills
3. 작업공간 스킬: <workspace>/skills

​

개별 에이전트 대 공유 스킬

• 개별 에이전트 스킬은 해당 에이전트만을 위한 <workspace>/skills 내에 존재합니다.
• 공유 스킬은 ~/.openclaw/skills (관리형/로컬)에 존재하며 같은 머신의 모든 에이전트에게 표시됩니다.
• 공유 폴더는 여러 에이전트에서 사용되는 공통 스킬 팩이 필요하다면 skills.load.extraDirs를 통해 추가할 수 있습니다 (최소 우선순위).

​

플러그인 + 스킬

​

ClawHub (설치 + 동기화)

• 작업공간에 스킬 설치:
  • clawhub install <skill-slug>
• 모든 설치된 스킬 업데이트:
  • clawhub update --all
• 동기화 (스캔 + 업데이트 게시):
  • clawhub sync --all

​

보안 주의사항

• 타사 스킬을 신뢰할 수 없는 코드로 취급하십시오. 사용 전에 읽어보십시오.
• 신뢰할 수 없는 입력과 위험한 도구에 대해 샌드박스 격리 실행을 선호하십시오. 샌드박스 격리를 참조하십시오.
• skills.entries.*.env 및 skills.entries.*.apiKey는 호스트 프로세스에 비밀을 주입합니다 (샌드박스가 아님). 비밀은 프롬프트와 로그에서 제외하십시오.
• 더 넓은 위협 모델 및 체크리스트는 보안을 참조하십시오.

​

형식 (AgentSkills + Pi 호환)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

• 레이아웃/의도에 대해 AgentSkills 명세를 따릅니다.
• 포함된 에이전트가 사용하는 파서는 단일 줄 전면 키만 지원합니다.
• metadata는 단일 줄 JSON 객체로 작성해야 합니다.
• 스킬 폴더 경로를 참조하는 지침에는 {baseDir}을 사용하십시오.
• 선택적 전면 키:
  • homepage — macOS 스킬 UI에서 “Website”로 표시되는 URL (또한 metadata.openclaw.homepage로 지원됨).
  • user-invocable — true|false (기본값: true). true일 경우, 스킬은 사용자 슬래시 명령어로 노출됩니다.
  • disable-model-invocation — true|false (기본값: false). true일 경우, 스킬은 모델 프롬프트에서 제외됩니다 (여전히 사용자 호출 가능).
  • command-dispatch — tool (선택적). tool로 설정된 경우, 슬래시 명령어는 모델을 우회하고 도구로 직접 전달됩니다.
  • command-tool — command-dispatch: tool이 설정된 경우 호출할 도구 이름.
  • command-arg-mode — raw (기본값). 도구 전달 시, 원시 인수 문자열을 도구로 전달합니다 (코어 파싱 없음). 도구 인수로 실행됩니다: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

게이트 설정 (로드 시 필터)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — 항상 스킬을 포함합니다 (다른 게이트를 건너뜀).
• emoji — macOS 스킬 UI에서 사용되는 선택적 이모지.
• homepage — macOS 스킬 UI에서 “Website”로 표시되는 선택적 URL.
• os — 플랫폼의 선택적 목록 (darwin, linux, win32). 설정된 경우, 스킬은 해당 OS에서만 사용할 수 있습니다.
• requires.bins — 목록; 각 항목은 PATH에 존재해야 합니다.
• requires.anyBins — 목록; 최소 하나는 PATH에 존재해야 합니다.
• requires.env — 목록; 환경 변수는 존재해야 하거나 구성에서 제공되어야 합니다.
• requires.config — 진리로 평가되어야 하는 openclaw.json 경로의 목록.
• primaryEnv — skills.entries.<name>.apiKey와 관련된 환경 변수 이름.
• install — macOS 스킬 UI에서 사용되는 선택적 설치자 사양 배열 (brew/node/go/uv/download).

• requires.bins는 스킬 로드 시 호스트에서 확인됩니다.
• 에이전트가 샌드박스 격리된 경우, 바이너리는 컨테이너 내부에도 존재해야 합니다. agents.defaults.sandbox.docker.setupCommand 또는 사용자 정의 이미지를 통해 설치합니다. setupCommand는 컨테이너 생성 후 한 번 실행됩니다. 패키지 설치는 또한 네트워크 전송, 쓰기 가능한 루트 파일 시스템 및 샌드박스 내의 루트 사용자가 필요합니다. 예: summarize 스킬 (skills/summarize/SKILL.md)은 샌드박스 컨테이너 내에서 실행해야 하는 summarize CLI가 필요합니다.

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

• 여러 설치자가 나열된 경우, 게이트웨이는 하나의 선호 옵션을 선택합니다 (brew 사용 가능 시, 그렇지 않으면 node).
• 모든 설치자가 download인 경우, OpenClaw는 각 항목을 나열하여 사용 가능한 아티팩트를 확인할 수 있습니다.
• 설치자 사양은 플랫폼에 따라 옵션을 필터링하기 위해 os: ["darwin"|"linux"|"win32"]를 포함할 수 있습니다.
• 노드 설치는 openclaw.json의 skills.install.nodeManager를 따릅니다 (기본값: npm; 옵션: npm/pnpm/yarn/bun). 이것은 스킬 설치에만 영향을 미칩니다; 게이트웨이 런타임은 여전히 노드여야 합니다 (WhatsApp/Telegram에는 Bun이 권장되지 않음).
• Go 설치: go가 없고 brew가 사용 가능할 때, 게이트웨이는 Homebrew를 통해 Go를 먼저 설치하고 가능한 경우 Homebrew의 bin으로 GOBIN을 설정합니다.
• 다운로드 설치: url (필수), archive (tar.gz | tar.bz2 | zip), extract (기본값: 아카이브 감지 시 자동), stripComponents, targetDir (기본값: ~/.openclaw/tools/<skillKey>).

​

구성 오버라이드 (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• enabled: false는 스킬을 번들 또는 설치되어 있더라도 비활성화합니다.
• env: 프로세스에 이미 설정되어 있지 않은 경우에만 주입됩니다.
• apiKey: metadata.openclaw.primaryEnv를 선언하는 스킬용 편리 기능.
• config: 사용자 지정 필드를 위한 선택적 가방; 사용자 지정 키는 여기에 있어야 합니다.
• allowBundled: 번들 스킬에만 해당하는 선택적 허용 목록. 설정된 경우, 목록에 있는 번들 스킬만 자격이 있습니다 (관리형/작업공간 스킬은 영향받지 않음).

​

환경 주입 (에이전트 실행당)

1. 스킬 메타데이터를 읽습니다.
2. skills.entries.<key>.env 또는 skills.entries.<key>.apiKey를 process.env에 적용합니다.
3. 자격있는 스킬로 시스템 프롬프트를 구축합니다.
4. 실행이 종료된 후 원래 환경을 복원합니다.

​

세션 스냅샷 (성능)

​

원격 macOS 노드 (Linux 게이트웨이)

​

스킬 감시자 (자동 새로고침)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

토큰 영향 (스킬 목록)

• 기본 오버헤드 (≥1 스킬일 때만): 195자.
• 스킬별: 97자 + XML-이스케이프된 <name>, <description>, <location> 값의 길이.

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• XML 이스케이핑은 & < > " '를 엔티티 (&, <, 등)로 확장하여 길이를 늘립니다.
• 모델 토크나이저에 따라 토큰 수가 다릅니다. 대략적인 OpenAI 스타일 추정치는 ~4자/토큰으로, 97자 ≈ 24 토큰이며 실제 필드 길이가 추가됩니다.

​

관리형 스킬 수명주기

​

구성 참조

​

추가 스킬을 찾고 계십니까?