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.

OpenClaw เก็บงาน dependency ของ Plugin ไว้ในช่วง install/update การโหลดตอน runtime จะไม่เรียกใช้ package manager, ซ่อมแซม dependency tree, หรือแก้ไขไดเรกทอรี package ของ OpenClaw

​
การแบ่งความรับผิดชอบ

package ของ Plugin เป็นเจ้าของ dependency graph ของตนเอง:
  • runtime dependencies อยู่ใน dependencies หรือ optionalDependencies ของ package Plugin
  • การ import SDK/core เป็น peer หรือเป็น import ที่ OpenClaw จัดหาให้
  • Plugin สำหรับการพัฒนาในเครื่องนำ dependency ที่ติดตั้งไว้แล้วของตนเองมาด้วย
  • Plugin จาก npm และ git ถูกติดตั้งลงใน package root ที่ OpenClaw เป็นเจ้าของ
OpenClaw เป็นเจ้าของเฉพาะ lifecycle ของ Plugin:
  • ค้นหาแหล่งที่มาของ Plugin
  • ติดตั้งหรืออัปเดต package เมื่อมีการร้องขออย่างชัดเจน
  • บันทึก metadata การติดตั้ง
  • โหลด entrypoint ของ Plugin
  • ล้มเหลวพร้อมข้อผิดพลาดที่ดำเนินการต่อได้เมื่อ dependency ขาดหาย

​
install root

OpenClaw ใช้ root ที่เสถียรแยกตามแหล่งที่มา:
  • package npm ติดตั้งภายใต้ ~/.openclaw/npm
  • package git clone ภายใต้ ~/.openclaw/git
  • การติดตั้ง local/path/archive จะถูกคัดลอกหรืออ้างอิงโดยไม่มีการซ่อมแซม dependency
การติดตั้ง npm ทำงานใน npm root ด้วย: 
cd ~/.openclaw/npm
npm install --omit=dev --omit=peer --legacy-peer-deps --ignore-scripts --no-audit --no-fund
openclaw plugins install npm-pack:<path.tgz> ใช้ managed npm root เดียวกันนั้น สำหรับ tarball npm-pack ในเครื่อง OpenClaw อ่าน metadata npm ของ tarball เพิ่มเข้าไป ใน managed root เป็น dependency แบบ file: ที่คัดลอกมา เรียกใช้ npm install ตามปกติ แล้วตรวจสอบ metadata ของ lockfile ที่ติดตั้งก่อนเชื่อถือ Plugin สิ่งนี้มีไว้สำหรับ package-acceptance และหลักฐาน release-candidate ซึ่ง artifact pack ในเครื่องควรทำงานเหมือน artifact ใน registry ที่จำลองอยู่ npm อาจ hoist transitive dependencies ไปยัง ~/.openclaw/npm/node_modules ข้าง package ของ Plugin ได้ OpenClaw สแกน managed npm root ก่อนเชื่อถือการติดตั้ง และใช้ npm เพื่อลบ package ที่ npm จัดการระหว่างถอนการติดตั้ง ดังนั้น runtime dependencies ที่ถูก hoist จะยังอยู่ภายในขอบเขต cleanup ที่จัดการไว้ Plugin ที่ import openclaw/plugin-sdk/* ประกาศ openclaw เป็น peer dependency OpenClaw ไม่ยอมให้ npm ติดตั้งสำเนา registry แยกต่างหากของ host package ลงใน managed root เพราะ host package ที่เก่าอาจกระทบการแก้ peer ของ npm ระหว่าง การติดตั้ง Plugin ในภายหลัง การติดตั้ง npm ที่จัดการไว้จะข้ามการ resolve/materialize peer ของ npm สำหรับ root ที่ใช้ร่วมกัน และ OpenClaw จะยืนยันลิงก์ node_modules/openclaw ภายใน Plugin อีกครั้งสำหรับ package ที่ติดตั้งซึ่งประกาศ host peer หลัง install, update, หรือ uninstall การติดตั้ง git จะ clone หรือ refresh repository แล้วเรียกใช้: 
npm install --omit=dev --ignore-scripts --no-audit --no-fund
จากนั้น Plugin ที่ติดตั้งจะโหลดจากไดเรกทอรี package นั้น ดังนั้นการ resolve node_modules ทั้งใน package-local และ parent จะทำงานแบบเดียวกับ package Node ปกติ

​
Plugin ในเครื่อง

Plugin ในเครื่องถูกมองเป็นไดเรกทอรีที่นักพัฒนาควบคุม OpenClaw จะไม่เรียกใช้ npm install, pnpm install, หรือซ่อมแซม dependency ให้ หาก Plugin ในเครื่อง มี dependency ให้ติดตั้งใน Plugin นั้นก่อนโหลด Plugin TypeScript ของบุคคลที่สามในเครื่องสามารถใช้เส้นทาง Jiti ฉุกเฉินได้ Plugin JavaScript แบบ packaged และ Plugin ภายในที่ bundled จะโหลดผ่าน native import/require แทน Jiti

​
Startup และ reload

การเริ่มต้น Gateway และการ reload config จะไม่ติดตั้ง dependency ของ Plugin โดยจะอ่าน record การติดตั้ง Plugin คำนวณ entrypoint แล้วโหลด หาก dependency ขาดหายตอน runtime Plugin จะโหลดไม่สำเร็จและข้อผิดพลาดควรชี้ให้ operator ไปยังวิธีแก้ที่ชัดเจน: 
openclaw plugins update <id>
openclaw plugins install <source>
openclaw doctor --fix
doctor --fix สามารถล้างสถานะ dependency แบบ legacy ที่ OpenClaw สร้างขึ้นและกู้คืน Plugin ที่ดาวน์โหลดได้ซึ่งขาดจาก record การติดตั้งในเครื่องเมื่อ config อ้างถึงได้ Doctor จะไม่ซ่อม dependency ให้ Plugin ในเครื่องที่ติดตั้งอยู่แล้ว

​
Plugin ที่ bundled

Plugin ที่ bundled แบบเบาและสำคัญต่อ core จะถูกจัดส่งเป็นส่วนหนึ่งของ OpenClaw ควรไม่มี runtime dependency tree ขนาดใหญ่ หรือควรถูกย้ายออกไปเป็น package ที่ดาวน์โหลดได้ บน ClawHub/npm สำหรับรายการ Plugin ที่สร้างขึ้นปัจจุบันซึ่งจัดส่งใน core package, ติดตั้งจากภายนอก, หรือยังเป็น source-only โปรดดู Plugin inventory manifest ของ Plugin ที่ bundled ต้องไม่ขอ dependency staging ฟังก์ชัน Plugin ขนาดใหญ่หรือเป็น optional ควรถูก package เป็น Plugin ปกติและติดตั้งผ่านเส้นทาง npm/git/ClawHub เดียวกับ Plugin ของบุคคลที่สาม ใน source checkout OpenClaw มอง repository เป็น pnpm monorepo หลังจาก pnpm install Plugin ที่ bundled จะโหลดจาก extensions/<id> เพื่อให้ dependency workspace แบบ package-local พร้อมใช้งานและการแก้ไขถูกนำไปใช้โดยตรง การพัฒนา source checkout รองรับเฉพาะ pnpm เท่านั้น; การใช้ npm install ธรรมดาที่ root ของ repository ไม่ใช่วิธีที่รองรับในการเตรียม dependency ของ Plugin ที่ bundled
รูปแบบการติดตั้งตำแหน่ง Plugin ที่ bundledเจ้าของ dependency
npm install -g openclawruntime tree ที่ build แล้วภายใน packagepackage OpenClaw และ flow install/update/doctor ของ Plugin ที่ชัดเจน
Git checkout plus pnpm installpackage workspace extensions/<id>pnpm workspace รวมถึง dependency ของแต่ละ package Plugin เอง
openclaw plugins install ...managed npm/git/ClawHub plugin rootflow install/update ของ Plugin

​
การล้าง legacy

OpenClaw เวอร์ชันเก่าสร้าง root dependency ของ Plugin ที่ bundled ตอน startup หรือระหว่างการซ่อมด้วย doctor การ cleanup ของ doctor ปัจจุบันจะลบไดเรกทอรีและ symlink เก่าเหล่านั้นเมื่อใช้ --fix รวมถึง root plugin-runtime-deps เก่า, symlink package ของ Node-prefix แบบ global ที่ชี้ไปยังเป้าหมาย plugin-runtime-deps ที่ถูก prune แล้ว, manifest .openclaw-runtime-deps*, node_modules ของ Plugin ที่สร้างขึ้น, ไดเรกทอรี install stage, และ store pnpm แบบ package-local postinstall แบบ packaged ยังลบ symlink global เหล่านั้นก่อน prune root เป้าหมาย legacy เพื่อให้การอัปเกรดไม่ทิ้ง import package ESM ที่ dangling ไว้ เส้นทางเหล่านี้เป็นเพียงเศษตกค้าง legacy เท่านั้น การติดตั้งใหม่ไม่ควรสร้างเส้นทางเหล่านี้.