Plugin 설치 재정의

Plugin 설치 재정의를 사용하면 유지관리자가 설정 시점의 Plugin 설치 대상을 카탈로그, 번들 또는 기본 npm 소스 대신 특정 npm 패키지나 로컬 npm pack tarball로 지정할 수 있습니다. 이 기능은 E2E 및 패키지 검증 전용이며, 일반 사용자는 openclaw plugins install을 사용하여 Plugin을 설치합니다.

환경

다음 두 변수를 모두 설정하지 않으면 재정의가 비활성화됩니다.

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{  "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz",  "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'

재정의 맵은 Plugin ID를 키로 사용하는 JSON입니다. 값은 다음 형식을 지원합니다.

동작

설정 시점 흐름에서 설치하는 Plugin의 ID가 맵에 있으면 OpenClaw는 카탈로그, 번들 또는 기본 npm 소스 대신 재정의 소스를 사용합니다. 이는 온보딩 및 공유 설정 시점 Plugin 설치 프로그램을 사용하는 다른 모든 흐름에 적용됩니다.

• 재정의에도 예상 Plugin ID가 계속 적용됩니다. codex에 매핑된 tarball은 매니페스트 ID가 codex인 Plugin을 설치해야 합니다.
• 재정의는 공식 신뢰 소스 상태를 상속하지 않습니다. 카탈로그 항목이 일반적으로 OpenClaw 소유 패키지를 나타내더라도 재정의는 운영자가 제공한 테스트 입력으로 취급됩니다.
• 작업 공간 .env 파일로는 설치 재정의를 활성화할 수 없습니다. 두 환경 변수 모두 차단된 작업 공간 dotenv 목록에 포함됩니다. OpenClaw를 실행하는 신뢰할 수 있는 셸, CI 작업 또는 원격 테스트 명령에서 설정하세요.

패키지 E2E

패키지 설치 및 설치 기록이 일반 OpenClaw 상태에 영향을 주지 않도록 격리된 상태 디렉터리를 사용하세요.

npm pack extensions/codex --pack-destination /tmp OPENCLAW_STATE_DIR="$(mktemp -d)" \OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \pnpm openclaw onboard --mode local

상태 디렉터리 아래에서 설치된 패키지를 확인하세요.

find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json

실제 공급자 E2E의 경우 테스트 명령을 실행하기 전에 신뢰할 수 있는 셸 또는 CI 비밀에서 실제 API 키를 가져오세요. 키를 출력하지 말고, 소스와 키의 존재 여부만 보고하세요.