> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# plugins

# `openclaw plugins`

Gateway(게이트웨이) 플러그인/확장(인프로세스 로드됨)을 관리합니다.

관련 항목:

* 플러그인 시스템: [Plugins](/tools/plugin)
* 플러그인 매니페스트 + 스키마: [Plugin manifest](/plugins/manifest)
* 보안 강화: [Security](/gateway/security)

## 명령어

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
```

번들된 플러그인은 OpenClaw와 함께 제공되지만 기본적으로 비활성화되어 있습니다. `plugins enable`를 사용하여
이를 활성화하십시오.

모든 플러그인은 인라인 JSON Schema
(`configSchema`, 비어 있더라도)를 포함한 `openclaw.plugin.json` 파일을 제공해야 합니다. 매니페스트 또는 스키마가 없거나 유효하지 않으면
플러그인이 로드되지 않으며 설정 검증이 실패합니다.

### 설치

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install <path-or-spec>
```

보안 참고 사항: 플러그인 설치는 코드 실행과 동일하게 취급하십시오. 고정된 버전을 사용하는 것을 권장합니다.

Npm 사양은 **registry-only** (패키지 이름 + 선택적 버전/태그)만 허용됩니다. Git/URL/file
사양은 허용되지 않습니다. 의존성 설치는 보안을 위해 `--ignore-scripts` 옵션으로 실행됩니다.

지원되는 아카이브: `.zip`, `.tgz`, `.tar.gz`, `.tar`.

로컬 디렉토리를 복사하지 않으려면 `--link`를 사용하십시오(`plugins.load.paths`에 추가됩니다):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install -l ./my-plugin
```

### 제거

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
```

`uninstall`은 `plugins.entries`, `plugins.installs`, 플러그인 허용 목록, 그리고 해당되는 경우 연결된 `plugins.load.paths` 항목에서 플러그인 레코드를 제거합니다.
활성 메모리 플러그인의 경우, 메모리 슬롯은 `memory-core`로 재설정됩니다.

기본적으로 uninstall은 활성 state 디렉터리의 extensions 루트(`$OPENCLAW_STATE_DIR/extensions/<id>`) 아래에 있는 플러그인 설치 디렉터리도 함께 제거합니다. 디스크에 파일을 유지하려면 `--keep-files`를 사용하세요.

`--keep-config`는 `--keep-files`의 더 이상 권장되지 않는(deprecated) 별칭으로 지원됩니다.

### Update

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
```

업데이트는 npm에서 설치된 플러그인(`plugins.installs`에 추적됨)에만 적용됩니다.