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

# Ghi đè khi cài đặt Plugin

Ghi đè cài đặt Plugin cho phép maintainer kiểm thử các lượt cài đặt plugin tại thời điểm thiết lập với
một gói npm cụ thể hoặc tarball npm-pack cục bộ. Chúng chỉ dành cho E2E và xác thực
gói. Người dùng thông thường nên cài đặt plugin bằng
[`openclaw plugins install`](/vi/cli/plugins).

<Warning>
  Ghi đè thực thi mã plugin từ nguồn bạn cung cấp. Chỉ sử dụng chúng trong một
  thư mục trạng thái cô lập hoặc máy kiểm thử dùng một lần.
</Warning>

## Môi trường

Ghi đè bị tắt trừ khi cả hai biến đều được đặt:

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

Bản đồ ghi đè là JSON được khóa theo id plugin. Giá trị hỗ trợ:

* `npm:<registry-spec>` cho các gói registry và phiên bản hoặc thẻ chính xác
* `npm-pack:<path.tgz>` cho tarball cục bộ được tạo bởi `npm pack`

Đường dẫn `npm-pack:` tương đối được phân giải từ thư mục làm việc hiện tại.

## Hành vi

Khi một luồng tại thời điểm thiết lập yêu cầu cài đặt một plugin có id xuất hiện trong bản đồ,
OpenClaw sử dụng nguồn ghi đè thay vì nguồn npm từ catalog, gói kèm, hoặc mặc định.
Điều này áp dụng cho onboarding và các luồng khác sử dụng trình cài đặt plugin
tại thời điểm thiết lập dùng chung.

Ghi đè vẫn thực thi id plugin kỳ vọng. Một tarball được ánh xạ tới `codex`
phải cài đặt một plugin có id manifest là `codex`.

Ghi đè không kế thừa trạng thái nguồn tin cậy chính thức. Ngay cả khi mục catalog
thường đại diện cho một gói do OpenClaw sở hữu, ghi đè vẫn được xem là
đầu vào kiểm thử do người vận hành cung cấp.

Các tệp `.env` trong workspace không thể bật ghi đè cài đặt. Hãy đặt các biến này trong
shell tin cậy, job CI, hoặc lệnh kiểm thử từ xa khởi chạy OpenClaw.

## E2E gói

Sử dụng một thư mục trạng thái cô lập để các lượt cài đặt gói và bản ghi cài đặt không
chạm vào trạng thái OpenClaw thông thường của bạn:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Xác minh gói đã cài đặt trong thư mục trạng thái:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json
```

Đối với E2E nhà cung cấp trực tiếp, lấy khóa API thật từ shell tin cậy hoặc secret CI
trước khi khởi chạy lệnh kiểm thử. Không in khóa; chỉ báo cáo nguồn và
khóa có hiện diện hay không.