메인 콘텐츠로 건너뛰기

​
openclaw plugins

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

​
명령어

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 파일을 제공해야 합니다. 매니페스트 또는 스키마가 없거나 유효하지 않으면 플러그인이 로드되지 않으며 설정 검증이 실패합니다.

​
설치

openclaw plugins install <path-or-spec>
보안 참고 사항: 플러그인 설치는 코드 실행과 동일하게 취급하십시오. 고정된 버전을 사용하는 것을 권장합니다. Npm 사양은 registry-only (패키지 이름 + 선택적 버전/태그)만 허용됩니다. Git/URL/file 사양은 허용되지 않습니다. 의존성 설치는 보안을 위해 --ignore-scripts 옵션으로 실행됩니다. 지원되는 아카이브: .zip, .tgz, .tar.gz, .tar. 로컬 디렉토리를 복사하지 않으려면 --link를 사용하십시오(plugins.load.paths에 추가됩니다): 
openclaw plugins install -l ./my-plugin

​
제거

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

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
업데이트는 npm에서 설치된 플러그인(plugins.installs에 추적됨)에만 적용됩니다.