Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

การแทนที่การติดตั้ง Plugin ช่วยให้ผู้ดูแลทดสอบการติดตั้ง Plugin ในช่วงตั้งค่าเทียบกับ แพ็กเกจ npm เฉพาะหรือ tarball จาก npm-pack ในเครื่องได้ สิ่งนี้มีไว้สำหรับการตรวจสอบ E2E และแพ็กเกจเท่านั้น ผู้ใช้ทั่วไปควรติดตั้ง Plugin ด้วย openclaw plugins install
การแทนที่จะรันโค้ด Plugin จากแหล่งที่คุณระบุ ใช้เฉพาะในไดเรกทอรีสถานะที่แยกไว้ หรือเครื่องทดสอบที่ทิ้งได้เท่านั้น

​
สภาพแวดล้อม

การแทนที่จะถูกปิดใช้งาน เว้นแต่จะตั้งค่าทั้งสองตัวแปร: 
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"
}'
แมปการแทนที่เป็น JSON ที่ใช้รหัส Plugin เป็นคีย์ ค่ารองรับ:
  • npm:<registry-spec> สำหรับแพ็กเกจ registry และเวอร์ชันหรือแท็กที่เจาะจง
  • npm-pack:<path.tgz> สำหรับ tarball ในเครื่องที่สร้างโดย npm pack
พาธ npm-pack: แบบสัมพัทธ์จะ resolve จากไดเรกทอรีทำงานปัจจุบัน

​
ลักษณะการทำงาน

เมื่อโฟลว์ช่วงตั้งค่าขอติดตั้ง Plugin ที่มีรหัสปรากฏในแมป OpenClaw จะใช้แหล่งการแทนที่แทนแหล่งจากแค็ตตาล็อก แบบ bundled หรือ npm ค่าเริ่มต้น สิ่งนี้ใช้กับ onboarding และโฟลว์อื่น ๆ ที่ใช้ตัวติดตั้ง Plugin ช่วงตั้งค่าที่ใช้ร่วมกัน การแทนที่จะยังบังคับใช้รหัส Plugin ที่คาดไว้ tarball ที่แมปกับ codex ต้องติดตั้ง Plugin ที่มีรหัส manifest เป็น codex การแทนที่จะไม่สืบทอดสถานะ trusted-source อย่างเป็นทางการ แม้เมื่อรายการแค็ตตาล็อก ปกติแทนแพ็กเกจที่ OpenClaw เป็นเจ้าของ การแทนที่จะถูกถือว่าเป็นอินพุตทดสอบ ที่ผู้ปฏิบัติงานระบุ ไฟล์ .env ของ workspace ไม่สามารถเปิดใช้การแทนที่การติดตั้งได้ ให้ตั้งค่าตัวแปรเหล่านี้ใน shell ที่เชื่อถือได้, งาน CI, หรือคำสั่งทดสอบระยะไกลที่เปิดใช้ OpenClaw

​
แพ็กเกจ 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/node_modules" -maxdepth 3 -name package.json -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/package-lock.json"
สำหรับ E2E ของผู้ให้บริการแบบ live ให้ source คีย์ API จริงจาก shell ที่เชื่อถือได้หรือ secret ของ CI ก่อนเปิดใช้คำสั่งทดสอบ อย่าพิมพ์คีย์; รายงานเฉพาะแหล่งที่มาและ มีคีย์อยู่หรือไม่เท่านั้น