Maintenance

ช่องทางการเผยแพร่

OpenClaw มีช่องทางอัปเดตสามช่องทาง:

stable: npm dist-tag latest แนะนำสำหรับผู้ใช้ส่วนใหญ่
beta: npm dist-tag beta เมื่อเป็นเวอร์ชันปัจจุบัน หากไม่มี beta หรือเก่ากว่า รุ่น stable ล่าสุด โฟลว์การอัปเดตจะย้อนกลับไปใช้ latest
dev: หัวล่าสุดที่เปลี่ยนไปเรื่อย ๆ ของ main (git) npm dist-tag: dev (เมื่อเผยแพร่) สาขา main มีไว้สำหรับการทดลองและการพัฒนาที่กำลังดำเนินอยู่ อาจมี ฟีเจอร์ที่ยังไม่สมบูรณ์หรือการเปลี่ยนแปลงที่ทำให้เข้ากันไม่ได้ อย่าใช้กับ Gateway สำหรับโปรดักชัน

โดยปกติเราจะส่ง build stable ไปยัง beta ก่อน ทดสอบที่นั่น แล้วจึงรัน ขั้นตอนโปรโมตแบบชัดเจนเพื่อย้าย build ที่ผ่านการตรวจสอบแล้วไปยัง latest โดยไม่ เปลี่ยนหมายเลขเวอร์ชัน ผู้ดูแลยังสามารถเผยแพร่รุ่น stable ไปยัง latest โดยตรงได้เมื่อจำเป็น dist-tag เป็นแหล่งข้อมูลจริงสำหรับการติดตั้งผ่าน npm

การสลับช่องทาง

bash

openclaw update --channel stableopenclaw update --channel betaopenclaw update --channel dev

--channel จะบันทึกตัวเลือกของคุณไว้ใน config (update.channel) และจัดวิธี ติดตั้งให้ตรงกัน:

stable (การติดตั้งแบบแพ็กเกจ): อัปเดตผ่าน npm dist-tag latest
beta (การติดตั้งแบบแพ็กเกจ): เลือกใช้ npm dist-tag beta ก่อน แต่จะย้อนกลับไปใช้ latest เมื่อไม่มี beta หรือเก่ากว่าแท็ก stable ปัจจุบัน
stable (การติดตั้งแบบ git): checkout แท็ก git stable ล่าสุด
beta (การติดตั้งแบบ git): เลือกใช้แท็ก git beta ล่าสุดก่อน แต่จะย้อนกลับไปใช้ แท็ก git stable ล่าสุดเมื่อไม่มี beta หรือเก่ากว่า
dev: ทำให้แน่ใจว่ามี git checkout (ค่าเริ่มต้น ~/openclaw, เปลี่ยนได้ด้วย OPENCLAW_GIT_DIR), สลับไปที่ main, rebase บน upstream, build และ ติดตั้ง CLI แบบ global จาก checkout นั้น

การกำหนดเป้าหมายเวอร์ชันหรือแท็กแบบครั้งเดียว

ใช้ --tag เพื่อกำหนดเป้าหมาย dist-tag, เวอร์ชัน หรือ package spec เฉพาะสำหรับการ อัปเดตครั้งเดียว โดยไม่ เปลี่ยนช่องทางที่บันทึกไว้ของคุณ:

bash

# Install a specific versionopenclaw update --tag 2026.4.1-beta.1 # Install from the beta dist-tag (one-off, does not persist)openclaw update --tag beta # Install from GitHub main branch (npm tarball)openclaw update --tag main # Install a specific npm package specopenclaw update --tag [email protected]

หมายเหตุ:

--tag ใช้ได้กับ การติดตั้งแบบแพ็กเกจ (npm) เท่านั้น การติดตั้งแบบ git จะไม่สนใจค่านี้
แท็กจะไม่ถูกบันทึกไว้ openclaw update ครั้งถัดไปจะใช้ช่องทางที่คุณกำหนดค่าไว้ ตามปกติ
การป้องกันการดาวน์เกรด: หากเวอร์ชันเป้าหมายเก่ากว่าเวอร์ชันปัจจุบันของคุณ OpenClaw จะถามเพื่อยืนยัน (ข้ามได้ด้วย --yes)
--channel beta แตกต่างจาก --tag beta: โฟลว์ของช่องทางสามารถย้อนกลับไปใช้ stable/latest ได้เมื่อไม่มี beta หรือเก่ากว่า ขณะที่ --tag beta จะกำหนดเป้าหมาย dist-tag beta ดิบสำหรับการรันครั้งนั้นครั้งเดียว

Dry run

ดูตัวอย่างว่า openclaw update จะทำอะไรโดยไม่เปลี่ยนแปลงอะไร:

bash

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

dry run จะแสดงช่องทางที่มีผล เวอร์ชันเป้าหมาย การดำเนินการที่วางแผนไว้ และ ต้องมีการยืนยันการดาวน์เกรดหรือไม่

Plugin และช่องทาง

เมื่อคุณสลับช่องทางด้วย openclaw update OpenClaw จะซิงค์แหล่งที่มาของ plugin ด้วย:

dev เลือกใช้ plugin ที่ bundled มาจาก git checkout ก่อน
stable และ beta กู้คืนแพ็กเกจ plugin ที่ติดตั้งผ่าน npm
plugin ที่ติดตั้งผ่าน npm จะถูกอัปเดตหลังจากการอัปเดต core เสร็จสมบูรณ์

การตรวจสอบสถานะปัจจุบัน

bash

openclaw update status

แสดงช่องทางที่ใช้งานอยู่ ชนิดการติดตั้ง (git หรือแพ็กเกจ) เวอร์ชันปัจจุบัน และ แหล่งที่มา (config, แท็ก git, สาขา git หรือค่าเริ่มต้น)

แนวทางปฏิบัติที่ดีในการติดแท็ก

ติดแท็กรุ่นที่คุณต้องการให้ git checkout ไปลงที่นั่น (vYYYY.M.D สำหรับ stable, vYYYY.M.D-beta.N สำหรับ beta)
vYYYY.M.D.beta.N ยังถูกรองรับเพื่อความเข้ากันได้ แต่ควรใช้ -beta.N
แท็กดั้งเดิม vYYYY.M.D-<patch> ยังถูกรู้จักเป็น stable (ไม่ใช่ beta)
รักษาแท็กให้ไม่เปลี่ยนแปลง: อย่าย้ายหรือนำแท็กกลับมาใช้ซ้ำ
npm dist-tag ยังคงเป็นแหล่งข้อมูลจริงสำหรับการติดตั้งผ่าน npm:
- latest -> stable
- beta -> build ตัวเลือกก่อนปล่อย หรือ build stable ที่ปล่อยเข้า beta ก่อน
- dev -> snapshot ของ main (ไม่บังคับ)

ความพร้อมใช้งานของแอป macOS

build beta และ dev อาจ ไม่มี รุ่นแอป macOS ซึ่งไม่เป็นไร:

ยังสามารถเผยแพร่แท็ก git และ npm dist-tag ได้
ระบุว่า "ไม่มี build macOS สำหรับ beta นี้" ใน release notes หรือ changelog

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

Was this useful?