การทดสอบ

• ชุดเครื่องมือทดสอบฉบับเต็ม (ชุดทดสอบ, แบบใช้งานจริง, Docker): การทดสอบ
• การตรวจสอบการอัปเดตและแพ็กเกจ Plugin: การทดสอบการอัปเดตและ Plugin

ค่าเริ่มต้นสำหรับเอเจนต์

เซสชันของเอเจนต์รันการทดสอบและการตรวจสอบที่ใช้ทรัพยากรประมวลผลสูงจากระยะไกล ผ่าน Crabbox โดยโค้ดของผู้ดูแลที่เชื่อถือได้จะใช้ Blacksmith Testbox เป็นค่าเริ่มต้น เวิร์กโฟลว์ Testbox ที่กำหนดค่าไว้จะเติมข้อมูลประจำตัว ดังนั้นโค้ดจากผู้มีส่วนร่วมที่ ไม่น่าเชื่อถือหรือจากฟอร์กต้องใช้ CI ของฟอร์กที่ไม่มีข้อมูลลับ หรือใช้ AWS Crabbox โดยตรงที่ผ่านการปรับสภาพให้ปลอดภัยแทน

เมื่องานโค้ดที่เชื่อถือได้มีแนวโน้มต้องใช้การทดสอบหรือหลักฐานที่ใช้ทรัพยากรสูง ให้เริ่ม อุ่นเครื่องล่วงหน้าทันทีในเซสชันคำสั่งเบื้องหลัง ทำงานต่อระหว่างที่ระบบเติมข้อมูล นำรหัส tbx_... ที่ได้รับกลับมาใช้ซ้ำ ซิงค์เช็กเอาต์ปัจจุบันทุกครั้งที่รัน และ หยุดระบบก่อนส่งมอบงาน:

node scripts/crabbox-wrapper.mjs warmup --provider blacksmith-testbox --keep --timing-json

หลังจากนำกลับมาใช้ซ้ำสำเร็จครั้งแรก ตัวห่อหุ้มจะบันทึกลายนิ้วมือของฐานลีส การขึ้นต่อกัน และเวิร์กโฟลว์ Testbox ไว้ภายใต้ .crabbox/testbox-leases/ การแก้ไขเฉพาะซอร์สจะยังคงใช้กล่องที่อุ่นเครื่องไว้ซ้ำต่อไป หากฐานการผสาน ไฟล์ล็อก อินพุตของตัวจัดการแพ็กเกจ ตัวห่อหุ้ม หรือเวิร์กโฟลว์ Testbox เปลี่ยนแปลง ระบบจะปิดโดยไม่ดำเนินการต่อและกำหนดให้ใช้ลีสใหม่ ทุกครั้งที่รันยังคงซิงค์ เช็กเอาต์ปัจจุบัน OPENCLAW_TESTBOX_ALLOW_STALE=1 ใช้เฉพาะสำหรับการวินิจฉัยโดยตั้งใจเท่านั้น ไม่ใช่สำหรับหลักฐานการเผยแพร่

คำสั่งทดสอบภายในเครื่องด้านล่างมีไว้สำหรับเวิร์กโฟลว์ของมนุษย์ หรือกรณีสำรอง ของเอเจนต์ที่ผู้ใช้ร้องขออย่างชัดเจน ต้องรายงานเมื่อผู้ให้บริการระยะไกลไม่พร้อมใช้งาน กรณีดังกล่าวไม่ใช่สิทธิ์ให้รันด่านตรวจสอบขนาดใหญ่ภายในเครื่องโดยไม่แจ้งให้ทราบ

สำหรับโค้ดที่ไม่น่าเชื่อถือ ให้อุ่นเครื่องล่วงหน้าด้วย --provider aws ทุกครั้งที่รัน ต้องตั้งค่า CRABBOX_ENV_ALLOW=CI ส่ง --provider aws --no-hydrate และใช้ HOME ระยะไกลชั่วคราวใหม่ก่อนติดตั้งการขึ้นต่อกันหรือรันการทดสอบ ใช้ลีสที่เพิ่ง อุ่นเครื่องใหม่และจัดสรรเฉพาะสำหรับซอร์สที่ไม่น่าเชื่อถือนั้น ห้ามใช้ลีสที่เชื่อถือได้ หรือลีสที่เคยเติมข้อมูลแล้วซ้ำ เปิดไบนารี Crabbox ที่ติดตั้งและเชื่อถือได้จากเช็กเอาต์ main ที่สะอาดและเชื่อถือได้ และดึงเฉพาะ PR ระยะไกลด้วย --fresh-pr เท่านั้น ห้ามเรียกใช้ตัวห่อหุ้มหรือการกำหนดค่าของเช็กเอาต์ที่ไม่น่าเชื่อถือภายในเครื่อง ยกเลิกการตั้งค่า CRABBOX_AWS_INSTANCE_PROFILE และปิดโดยไม่ดำเนินการต่อ เว้นแต่ค่า aws.instanceProfile ที่ประมวลผลแล้วจะว่างเปล่า ก่อนติดตั้งหรือทดสอบใด ๆ ให้ใช้เครื่องมือพาธสัมบูรณ์ที่เชื่อถือได้เพื่อบังคับให้ใช้โทเค็น IMDSv2 พิสูจน์ว่า เอนด์พอยต์ข้อมูลประจำตัว IAM ส่งคืน 404 และตรวจสอบว่า git rev-parse HEAD ระยะไกลตรงกับ SHA แบบเต็มของหัว PR ที่ตรวจสอบแล้ว ผูกลีสกับ SHA นั้นและ หยุด/อุ่นเครื่องใหม่เมื่อหัวเปลี่ยนแปลง อัปโหลด scripts/crabbox-untrusted-bootstrap.sh ที่เชื่อถือได้จาก main ที่สะอาด พร้อมกับ --fresh-pr; สคริปต์นี้จะติดตั้ง Node/pnpm เวอร์ชันที่ตรึงไว้ ตรวจสอบ SHA และเวอร์ชันที่ตรึงของตัวจัดการแพ็กเกจ แยก HOME ติดตั้งการขึ้นต่อกัน แล้วจึง เรียกใช้การทดสอบที่ร้องขอ หากโบรกเกอร์ไม่สามารถพิสูจน์ได้ว่าไม่มีบทบาท หรือ ไม่มี PR ระยะไกล ให้ใช้ CI ของฟอร์กที่ไม่มีข้อมูลลับ ห้ามใช้ hydrate-github, --no-sync หรือเวิร์กโฟลว์ Testbox ที่เติมข้อมูลประจำตัวแล้ว ยกเลิกการตั้งค่าการเขียนทับ CRABBOX_TAILSCALE* ทั้งหมด บังคับใช้ --network public --tailscale=false ล้างแฟล็กโหนดทางออก/LAN และกำหนดให้ crabbox inspect รายงานเครือข่ายสาธารณะที่ไม่มีสถานะ Tailscale ก่อนอัปโหลดสคริปต์ใด ๆ

ลำดับการทำงานภายในเครื่องตามปกติ

1. pnpm test:changed สำหรับหลักฐาน Vitest ตามขอบเขตที่เปลี่ยนแปลง
2. pnpm test <path-or-filter> สำหรับไฟล์ ไดเรกทอรี หรือเป้าหมายที่ระบุอย่างชัดเจนหนึ่งรายการ
3. pnpm test เฉพาะเมื่อคุณตั้งใจต้องใช้ชุดทดสอบ Vitest ภายในเครื่องทั้งหมด

ในเวิร์กทรี Codex หรือเช็กเอาต์แบบเชื่อมโยง/กระจัดกระจาย เอเจนต์จะหลีกเลี่ยงการรัน pnpm test* / pnpm check* / pnpm crabbox:run โดยตรงภายในเครื่อง:

• กรณีสำรองภายในเครื่องสำหรับไฟล์ขนาดเล็กที่ผู้ใช้ร้องขออย่างชัดเจน: node scripts/run-vitest.mjs <path-or-filter>
• ด่านตรวจสอบการเปลี่ยนแปลงหรือหลักฐานขนาดใหญ่: node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed เพื่อให้ pnpm ทำงานภายใน Testbox
• exitCode สุดท้ายและ JSON การจับเวลาของตัวห่อหุ้มคือผลลัพธ์ของคำสั่ง การรัน Blacksmith GitHub Actions ที่มอบหมายอาจแสดง cancelled หลังคำสั่ง SSH สำเร็จ เนื่องจาก Testbox ถูกหยุดจากภายนอกแอ็กชันรักษาการทำงาน ให้ตรวจสอบสรุปของตัวห่อหุ้มและเอาต์พุตคำสั่งก่อนถือว่าเป็นความล้มเหลว
• OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree <local-heavy-check command>: จำกัดการทำงานแบบอนุกรมของการตรวจสอบหนักไว้ภายในเวิร์กทรีปัจจุบัน แทนไดเรกทอรี Git ร่วม สำหรับคำสั่งเช่น pnpm check:changed และ pnpm test ... แบบเจาะจง ใช้เฉพาะบนโฮสต์ภายในเครื่องที่มีความจุสูง เมื่อคุณตั้งใจรันการตรวจสอบอิสระข้ามเวิร์กทรีที่เชื่อมโยงกัน

คำสั่งหลัก

การรันผ่านตัวห่อหุ้มการทดสอบจะจบด้วยสรุปสั้น ๆ [test] passed|failed|skipped ... in ...; บรรทัดระยะเวลาของ Vitest เองยังคงเป็นรายละเอียดต่อชาร์ด

สถานะการทดสอบร่วมและตัวช่วยโพรเซส

• src/test-utils/openclaw-test-state.ts: ใช้จาก Vitest เมื่อการทดสอบต้องการ HOME, OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH, ฟิกซ์เจอร์การกำหนดค่า เวิร์กสเปซ ไดเรกทอรีเอเจนต์ หรือที่เก็บโปรไฟล์การยืนยันตัวตนแบบแยกต่างหาก
• pnpm test:env-mutations:report: รายงานแบบไม่บล็อกของการทดสอบ/ชุดเครื่องมือที่แก้ไข HOME, OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH, OPENCLAW_WORKSPACE_DIR หรือคีย์สภาพแวดล้อมที่เกี่ยวข้องโดยตรง ใช้เพื่อค้นหารายการที่ควรย้ายไปใช้ตัวช่วยสถานะการทดสอบร่วม
• test/helpers/openclaw-test-instance.ts: สำหรับการทดสอบ E2E ระดับโพรเซสที่ต้องใช้ Gateway ซึ่งกำลังทำงาน สภาพแวดล้อม CLI การบันทึกล็อก และการล้างข้อมูลในที่เดียว
• เลน E2E ของ Docker/Bash ที่ซอร์ส scripts/lib/docker-e2e-image.sh สามารถส่ง docker_e2e_test_state_shell_b64 <label> <scenario> เข้าไปในคอนเทนเนอร์ และถอดรหัสด้วย scripts/lib/openclaw-e2e-instance.sh; สคริปต์แบบหลายโฮมสามารถส่ง docker_e2e_test_state_function_b64 และเรียก openclaw_test_state_create <label> <scenario> ในแต่ละโฟลว์ได้ node scripts/lib/openclaw-test-state.mjs -- create --label <name> --scenario <name> --env-file <path> --json จะเขียนไฟล์สภาพแวดล้อมของโฮสต์ที่สามารถนำไปซอร์สได้ (-- ก่อน create ป้องกันไม่ให้รันไทม์ Node รุ่นใหม่ตีความ --env-file เป็นแฟล็กของ Node) เลนที่เปิด Gateway สามารถซอร์ส scripts/lib/openclaw-e2e-instance.sh เพื่อใช้การกำหนดเอนทรีพอยต์ การเริ่มต้น OpenAI จำลอง การเปิดแบบเบื้องหน้า/เบื้องหลัง การตรวจสอบความพร้อม การส่งออกสภาพแวดล้อมสถานะ การดัมพ์ล็อก และการล้างโพรเซส

เลน Control UI, TUI และส่วนขยาย

• E2E แบบจำลองของ Control UI: pnpm test:ui:e2e เรียกใช้เลน Vitest + Playwright ซึ่งเริ่ม Vite Control UI และควบคุมหน้า Chromium จริงโดยเชื่อมต่อกับ Gateway WebSocket จำลอง การทดสอบอยู่ใน ui/src/**/*.e2e.test.ts; ม็อกและตัวควบคุมที่ใช้ร่วมกันอยู่ใน ui/src/test-helpers/control-ui-e2e.ts โดย pnpm test:e2e รวมเลนนี้ไว้ด้วย การรันโดยเอเจนต์ใช้ Testbox/Crabbox เป็นค่าเริ่มต้น รวมถึงการพิสูจน์แบบเจาะจง; ใช้ node scripts/run-vitest.mjs run --config test/vitest/vitest.ui-e2e.config.ts --configLoader runner ui/src/ui/e2e/chat-flow.e2e.test.ts เฉพาะเมื่อระบุให้ใช้ทางเลือกสำรองภายในเครื่องอย่างชัดเจนเท่านั้น
• การทดสอบ TUI PTY: node scripts/run-vitest.mjs run --config test/vitest/vitest.tui-pty.config.ts เรียกใช้เลน PTY ที่รวดเร็วด้วยแบ็กเอนด์จำลอง OPENCLAW_TUI_PTY_INCLUDE_LOCAL=1 หรือ pnpm tui:pty:test:watch --mode local เรียกใช้การทดสอบควัน tui --local ที่ช้ากว่า ซึ่งจำลองเฉพาะปลายทางโมเดลภายนอก ให้ตรวจยืนยันข้อความที่มองเห็นได้และมีความเสถียร หรือการเรียกฟิกซ์เจอร์ ไม่ใช่สแนปช็อต ANSI ดิบ
• pnpm test:extensions และ pnpm test extensions เรียกใช้ชาร์ดส่วนขยาย/Plugin ทั้งหมด Plugin ช่องทางที่ใช้ทรัพยากรมาก, Plugin เบราว์เซอร์ และ OpenAI จะทำงานเป็นชาร์ดเฉพาะ ส่วนกลุ่ม Plugin อื่นยังคงถูกรวมเป็นชุด pnpm test extensions/<id> เรียกใช้เลน Plugin ที่รวมมากับระบบหนึ่งรายการ
• ไฟล์ซอร์สที่มีการทดสอบระดับเดียวกันจะถูกแมปไปยังการทดสอบนั้นก่อน แล้วจึงย้อนกลับไปใช้โกลบไดเรกทอรีที่กว้างขึ้น การแก้ไขตัวช่วยภายใต้ src/channels/plugins/contracts/test-helpers, src/plugin-sdk/test-helpers และ src/plugins/contracts ใช้กราฟการนำเข้าภายในเพื่อเรียกใช้การทดสอบที่นำเข้าไฟล์เหล่านั้น แทนการเรียกใช้ทุกชาร์ดแบบกว้างเมื่อเส้นทางการขึ้นต่อกันมีความชัดเจน
• เป้าหมายไดเรกทอรีสัญญาจะกระจายไปยังเลนสัญญาที่เกี่ยวข้อง: pnpm test src/channels/plugins/contracts เรียกใช้การกำหนดค่าสัญญาช่องทางทั้งสี่รายการ และ pnpm test src/plugins/contracts เรียกใช้การกำหนดค่าสัญญา Plugin เนื่องจากโปรเจกต์ทั่วไป channels/plugins ไม่รวม contracts/**
• auto-reply แยกออกเป็นการกำหนดค่าเฉพาะสามรายการ (core, top-level, reply) เพื่อไม่ให้ชุดทดสอบการตอบกลับกินทรัพยากรเหนือกว่าการทดสอบสถานะ/โทเค็น/ตัวช่วยระดับบนที่เบากว่า
• ไฟล์ทดสอบ plugin-sdk และ commands บางรายการจะถูกส่งผ่านเลนเฉพาะที่มีน้ำหนักเบา ซึ่งคงไว้เฉพาะ test/setup.ts ส่วนกรณีที่ใช้รันไทม์หนักยังคงอยู่ในเลนเดิม
• การกำหนดค่า Vitest พื้นฐานใช้ pool: "threads" และ isolate: false เป็นค่าเริ่มต้น พร้อมเปิดใช้ตัวรันแบบไม่แยกที่ใช้ร่วมกันทั่วทั้งการกำหนดค่าของรีโพ
• pnpm test:channels เรียกใช้ vitest.channels.config.ts

Gateway และ E2E

• การผสานรวม Gateway ต้องเลือกเปิดใช้: OPENCLAW_TEST_INCLUDE_GATEWAY=1 pnpm test หรือ pnpm test:gateway
• pnpm test:e2e: ชุดรวม E2E ของรีโพ = pnpm test:e2e:gateway && pnpm test:ui:e2e
• pnpm test:e2e:gateway: การทดสอบควัน Gateway แบบต้นทางถึงปลายทาง (การจับคู่ WS/HTTP/Node แบบหลายอินสแตนซ์) ใช้ threads + isolate: false เป็นค่าเริ่มต้น พร้อมจำนวนเวิร์กเกอร์ที่ปรับได้ใน vitest.e2e.config.ts; ปรับด้วย OPENCLAW_E2E_WORKERS=<n> และเปิดบันทึกแบบละเอียดด้วย OPENCLAW_E2E_VERBOSE=1
• pnpm test:live: การทดสอบผู้ให้บริการแบบสด (Claude/Minimax/DeepSeek/z.ai/ฯลฯ ซึ่งควบคุมด้วย *.live.test.ts) ต้องใช้คีย์ API และ LIVE=1 (หรือ OPENCLAW_LIVE_TEST=1) เพื่อยกเลิกการข้าม; เปิดเอาต์พุตแบบละเอียดด้วย OPENCLAW_LIVE_TEST_QUIET=0

ชุด Docker เต็มรูปแบบ (pnpm test:docker:all)

สร้างอิมเมจการทดสอบแบบสดที่ใช้ร่วมกัน แพ็ก OpenClaw หนึ่งครั้งเป็นทาร์บอล npm สร้าง/นำอิมเมจตัวรัน Node/Git เปล่ากลับมาใช้ใหม่ พร้อมอิมเมจใช้งานจริงที่ติดตั้งทาร์บอลนั้นลงใน /app จากนั้นเรียกใช้เลนทดสอบควัน Docker ผ่านตัวจัดตารางแบบถ่วงน้ำหนัก scripts/package-openclaw-for-docker.mjs เป็นตัวแพ็กแพ็กเกจภายในเครื่อง/CI เพียงตัวเดียว และตรวจสอบทาร์บอลพร้อม dist/postinstall-inventory.json ก่อนที่ Docker จะนำไปใช้

• อิมเมจเปล่า (OPENCLAW_DOCKER_E2E_BARE_IMAGE): เลนตัวติดตั้ง/การอัปเดต/การขึ้นต่อกันของ Plugin; เมานต์ทาร์บอลที่สร้างไว้ล่วงหน้าแทนการคัดลอกซอร์สของรีโพ
• อิมเมจใช้งานจริง (OPENCLAW_DOCKER_E2E_FUNCTIONAL_IMAGE): เลนฟังก์ชันการทำงานปกติของแอปที่สร้างแล้ว
• คำจำกัดความเลน: scripts/lib/docker-e2e-scenarios.mjs ตัววางแผน: scripts/lib/docker-e2e-plan.mjs ตัวดำเนินการ: scripts/test-docker-all.mjs
• node scripts/test-docker-all.mjs --plan-json ส่งออกแผน CI ที่ตัวจัดตารางเป็นเจ้าของ (เลน, ชนิดอิมเมจ, ความต้องการแพ็กเกจ/อิมเมจแบบสด, สถานการณ์สถานะ, การตรวจสอบข้อมูลรับรอง) โดยไม่สร้างหรือเรียกใช้ Docker

ตัวปรับแต่งการจัดตาราง (ตัวแปรสภาพแวดล้อม โดยค่าเริ่มต้นอยู่ในวงเล็บ):

รูปแบบตัวแปรสภาพแวดล้อมสำหรับขีดจำกัดทรัพยากรคือ OPENCLAW_DOCKER_ALL_<RESOURCE>_LIMIT (ชื่อทรัพยากรเป็นตัวพิมพ์ใหญ่ และอักขระที่ไม่ใช่ตัวอักษรหรือตัวเลขจะถูกรวมเป็น _)

ลักษณะการทำงานอื่น ๆ: โดยค่าเริ่มต้น ตัวรันจะตรวจสอบความพร้อมของ Docker ล่วงหน้า ล้างคอนเทนเนอร์ E2E ของ OpenClaw ที่ค้างอยู่ แชร์แคชเครื่องมือ CLI ของผู้ให้บริการระหว่างเลนที่เข้ากันได้ และหยุดจัดกำหนดการเลนแบบพูลใหม่หลังพบความล้มเหลวครั้งแรก เว้นแต่จะตั้งค่า OPENCLAW_DOCKER_ALL_FAIL_FAST=0 หากเลนใดเลนหนึ่งใช้เกินขีดจำกัดน้ำหนัก/ทรัพยากรที่มีผลบนโฮสต์ที่มีระดับการทำงานแบบขนานต่ำ เลนนั้นยังคงเริ่มจากพูลว่างและทำงานเพียงลำพังได้จนกว่าจะคืนความจุ บันทึกแยกตามเลน, summary.json, failures.json และข้อมูลเวลาของแต่ละเฟสจะถูกเขียนไว้ใต้ .artifacts/docker-tests/<run-id>/; ใช้ pnpm test:docker:timings <summary.json> เพื่อตรวจสอบเลนที่ทำงานช้า และใช้ pnpm test:docker:rerun <run-id|summary.json|failures.json> เพื่อพิมพ์คำสั่งรันซ้ำแบบเจาะจงที่ใช้ทรัพยากรน้อย

เลน Docker ที่สำคัญ

เกต PR ภายในเครื่อง

สำหรับการตรวจสอบก่อนรวม/เกต PR ภายในเครื่อง ให้เรียกใช้:

• pnpm check:changed
• pnpm check
• pnpm check:test-types
• pnpm build
• pnpm test
• pnpm check:docs

หาก pnpm test ล้มเหลวเป็นครั้งคราวบนโฮสต์ที่มีภาระสูง ให้รันซ้ำหนึ่งครั้งก่อนถือว่าเป็นการถดถอย จากนั้นแยกตรวจสอบด้วย pnpm test <path/to/test> สำหรับโฮสต์ที่มีหน่วยความจำจำกัด:

• OPENCLAW_VITEST_MAX_WORKERS=1 pnpm test
• OPENCLAW_VITEST_FS_MODULE_CACHE_PATH=/tmp/openclaw-vitest-cache pnpm test:changed

เครื่องมือวัดประสิทธิภาพการทดสอบ

• pnpm test:perf:imports: เปิดใช้การรายงานระยะเวลาการนำเข้าและรายละเอียดการนำเข้าของ Vitest โดยยังคงใช้การกำหนดเส้นทางเลนตามขอบเขตสำหรับเป้าหมายไฟล์/ไดเรกทอรีที่ระบุอย่างชัดเจน ส่วน pnpm test:perf:imports:changed จำกัดการทำโปรไฟล์แบบเดียวกันไว้เฉพาะไฟล์ที่เปลี่ยนแปลงนับตั้งแต่ origin/main
• pnpm test:perf:changed:bench -- --ref <git-ref> วัดประสิทธิภาพเส้นทางโหมดการเปลี่ยนแปลงที่ผ่านการกำหนดเส้นทาง เทียบกับการเรียกใช้โปรเจกต์รากโดยตรงสำหรับส่วนต่าง git ที่คอมมิตแล้วชุดเดียวกัน ส่วน pnpm test:perf:changed:bench -- --worktree วัดประสิทธิภาพชุดการเปลี่ยนแปลงในเวิร์กทรีปัจจุบันโดยไม่ต้องคอมมิตก่อน
• pnpm test:perf:profile:main เขียนโปรไฟล์ CPU สำหรับเธรดหลักของ Vitest (.artifacts/vitest-main-profile) ส่วน pnpm test:perf:profile:runner เขียนโปรไฟล์ CPU และฮีปสำหรับตัวรันการทดสอบหน่วย (.artifacts/vitest-runner-profile)
• pnpm test:perf:groups --full-suite --allow-failures --output .artifacts/test-perf/baseline-before.json: เรียกใช้การกำหนดค่า Vitest ปลายทางทุกชุดของชุดทดสอบเต็มรูปแบบแบบอนุกรม และเขียนข้อมูลระยะเวลาที่จัดกลุ่ม พร้อมอาร์ติแฟกต์ JSON/บันทึกแยกตามการกำหนดค่า รายงานชุดทดสอบเต็มรูปแบบจะแยกไฟล์โดยค่าเริ่มต้น เพื่อไม่ให้กราฟโมดูลที่คงอยู่และช่วงหยุดของ GC จากไฟล์ก่อนหน้าถูกนับรวมกับการตรวจสอบยืนยันในไฟล์ถัดไป ให้ส่ง -- --no-isolate เฉพาะเมื่อตั้งใจทำโปรไฟล์การสะสมของเวิร์กเกอร์ที่ใช้ร่วมกันเท่านั้น ตัวแทนวัดประสิทธิภาพการทดสอบใช้ข้อมูลนี้เป็นค่าฐานก่อนพยายามแก้ไขการทดสอบที่ทำงานช้า pnpm test:perf:groups:compare .artifacts/test-perf/baseline-before.json .artifacts/test-perf/after-agent.json เปรียบเทียบรายงานที่จัดกลุ่มหลังการเปลี่ยนแปลงที่มุ่งเน้นด้านประสิทธิภาพ
• การเรียกใช้ชาร์ดแบบเต็ม แบบส่วนขยาย และแบบรูปแบบรวม จะอัปเดตข้อมูลเวลาในเครื่องที่ .artifacts/vitest-shard-timings.json การเรียกใช้การกำหนดค่าทั้งชุดในภายหลังจะใช้เวลาเหล่านี้เพื่อสร้างสมดุลระหว่างชาร์ดที่ช้าและเร็ว ชาร์ด CI แบบรูปแบบรวมจะต่อท้ายชื่อชาร์ดเข้ากับคีย์เวลา ซึ่งช่วยให้มองเห็นเวลาของชาร์ดที่กรองแล้วโดยไม่แทนที่ข้อมูลเวลาของการกำหนดค่าทั้งชุด ตั้งค่า OPENCLAW_TEST_PROJECTS_TIMINGS=0 เพื่อไม่สนใจอาร์ติแฟกต์เวลาในเครื่อง

การวัดประสิทธิภาพ

pnpm tsx scripts/bench-model.ts --runs 10

pnpm test:startup:benchpnpm test:startup:bench:smokepnpm test:startup:bench:savepnpm test:startup:bench:updatepnpm test:startup:bench:checkpnpm tsx scripts/bench-cli-startup.ts --runs 12pnpm tsx scripts/bench-cli-startup.ts --preset real --case status --case gatewayStatus --runs 3pnpm tsx scripts/bench-cli-startup.ts --entry openclaw.mjs --entry-secondary dist/entry.js --preset all

pnpm test:startup:gateway -- --runs 5 --warmup 1pnpm test:startup:gateway -- --case skipChannels --case fiftyPlugins --runs 5node --import tsx scripts/bench-gateway-startup.ts --case default --runs 5 --output .artifacts/gateway-startup.json

pnpm test:restart:gateway -- --case skipChannels --runs 1 --restarts 5pnpm test:restart:gateway -- --case default --runs 3 --restarts 3 --warmup 1

E2E การเริ่มใช้งาน (Docker)

เลือกใช้ได้ จำเป็นเฉพาะสำหรับการทดสอบควันของการเริ่มใช้งานแบบคอนเทนเนอร์ ลำดับการเริ่มต้นใหม่ทั้งหมดในคอนเทนเนอร์ Linux ที่สะอาด:

scripts/e2e/onboard-docker.sh

ควบคุมตัวช่วยแบบโต้ตอบผ่านเทอร์มินัลเสมือน ตรวจสอบไฟล์การกำหนดค่า/เวิร์กสเปซ/เซสชัน จากนั้นเริ่ม Gateway และเรียกใช้ openclaw health

การทดสอบควันการนำเข้า QR (Docker)

ตรวจสอบให้แน่ใจว่าตัวช่วยรันไทม์ QR ที่ดูแลอยู่สามารถโหลดได้ภายใต้รันไทม์ Docker Node ที่รองรับ (Node 24 เป็นค่าเริ่มต้น และเข้ากันได้กับ Node 22):

pnpm test:docker:qr

ที่เกี่ยวข้อง

• การทดสอบ
• การทดสอบแบบใช้งานจริง
• การทดสอบการอัปเดตและ Plugin