Plugin 관리

대부분의 Plugin 워크플로는 몇 가지 명령으로 이루어집니다: 검색, 설치, Gateway 재시작, 검증, 더 이상 Plugin이 필요하지 않을 때 제거.

Plugin 목록 보기

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

스크립트에는 --json을 사용하세요. Plugin 패키지가 dependencies 또는 optionalDependencies를 선언한 경우 레지스트리 진단 정보와 각 Plugin의 정적 dependencyStatus가 포함됩니다.

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list는 콜드 인벤토리 검사입니다. OpenClaw가 구성, 매니페스트, Plugin 레지스트리에서 발견할 수 있는 항목을 보여 줍니다. 이미 실행 중인 Gateway 프로세스가 Plugin 런타임을 가져왔다는 것을 증명하지는 않습니다.

Plugin 설치

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.openclaw plugins install <package> # Force one source.openclaw plugins install clawhub:<package>openclaw plugins install npm:<package> # Install a specific version or dist-tag.openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@betaopenclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Plugin 코드를 설치한 뒤 채널을 제공하는 Gateway를 재시작하세요:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

도구, 훅, 서비스, Gateway 메서드 또는 Plugin 소유 CLI 명령과 같은 런타임 표면을 Plugin이 등록했다는 증명이 필요할 때는 inspect --runtime을 사용하세요.

Plugin 업데이트

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --all

Plugin이 @beta 같은 npm dist-tag에서 설치된 경우 이후 update <plugin-id> 호출은 기록된 해당 태그를 재사용합니다. 명시적 npm spec을 전달하면 추적되는 설치 항목이 이후 업데이트에 해당 spec을 사용하도록 전환됩니다.

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

두 번째 명령은 이전에 정확한 버전이나 태그로 고정된 Plugin을 레지스트리의 기본 릴리스 라인으로 되돌립니다.

openclaw update가 베타 채널에서 실행되면 기본 라인 npm 및 ClawHub Plugin 레코드는 먼저 일치하는 Plugin @beta 릴리스를 시도합니다. 해당 베타 릴리스가 없으면 OpenClaw는 기록된 기본/최신 spec으로 폴백합니다. npm Plugin의 경우 베타 패키지가 존재하지만 설치 검증에 실패할 때도 OpenClaw가 폴백합니다. 정확한 버전과 @rc 또는 @beta 같은 명시적 태그는 보존됩니다.

Plugin 제거

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-filesopenclaw gateway restart

제거는 해당되는 경우 Plugin의 구성 항목, Plugin 인덱스 레코드, 허용/거부 목록 항목, 연결된 로드 경로를 제거합니다. --keep-files를 전달하지 않으면 관리형 설치 디렉터리도 제거됩니다.

Nix 모드(OPENCLAW_NIX_MODE=1)에서는 Plugin 설치, 업데이트, 제거, 활성화, 비활성화 명령이 비활성화됩니다. 대신 설치를 위한 Nix 소스에서 이러한 선택을 관리하세요. nix-openclaw의 경우 agent-first 빠른 시작을 사용하세요.

Plugin 게시

외부 Plugin을 ClawHub, npmjs.com 또는 둘 다에 게시할 수 있습니다.

ClawHub에 게시

ClawHub는 OpenClaw Plugin의 기본 공개 검색 표면입니다. 사용자는 설치 전에 검색 가능한 메타데이터, 버전 기록, 레지스트리 스캔 결과를 확인할 수 있습니다.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

사용자는 다음 명령으로 ClawHub에서 설치합니다:

openclaw plugins install clawhub:<package>openclaw plugins install <package>

bare 형식은 여전히 ClawHub를 먼저 확인합니다.

npmjs.com에 게시

네이티브 npm Plugin에는 Plugin 매니페스트와 package.json OpenClaw 엔트리포인트 메타데이터가 포함되어야 합니다.

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access public

사용자는 npm 전용 Plugin을 다음 명령으로 설치합니다:

openclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/[email protected]

동일한 패키지가 ClawHub에서도 제공되는 경우 npm:은 ClawHub 조회를 건너뛰고 npm 해결을 강제합니다.

소스 선택

• ClawHub: OpenClaw 네이티브 검색, 스캔 요약, 버전, 설치 힌트가 필요할 때 사용하세요.
• npmjs.com: 이미 JavaScript 패키지를 배포하고 있거나 npm dist-tag/비공개 레지스트리 워크플로가 필요할 때 사용하세요.
• Git: 브랜치, 태그 또는 커밋에서 직접 설치하려고 할 때 사용하세요.
• 로컬 경로: 같은 머신에서 Plugin을 개발하거나 테스트할 때 사용하세요.

관련 항목

• Plugin - 개요 및 문제 해결
• openclaw plugins - 전체 CLI 참조
• ClawHub - 게시 및 레지스트리 작업
• Plugin 빌드 - Plugin 패키지 만들기
• Plugin 매니페스트 - 매니페스트 및 패키지 메타데이터