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 มีช่องทางอัปเดตสามช่องทาง:
  • 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

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

openclaw update --channel stable
openclaw update --channel beta
openclaw 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 นั้น
หากคุณต้องการใช้ stable และ dev ควบคู่กัน ให้เก็บ clone ไว้สองชุด แล้วชี้ gateway ของคุณไปยังชุด stable

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

ใช้ --tag เพื่อกำหนดเป้าหมาย dist-tag, เวอร์ชัน หรือ package spec เฉพาะสำหรับการ อัปเดตครั้งเดียว โดยไม่ เปลี่ยนช่องทางที่บันทึกไว้ของคุณ: 
# Install a specific version
openclaw 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 spec
openclaw update --tag openclaw@2026.4.1-beta.1
หมายเหตุ:
  • --tag ใช้ได้กับ การติดตั้งแบบแพ็กเกจ (npm) เท่านั้น การติดตั้งแบบ git จะไม่สนใจค่านี้
  • แท็กจะไม่ถูกบันทึกไว้ openclaw update ครั้งถัดไปจะใช้ช่องทางที่คุณกำหนดค่าไว้ ตามปกติ
  • การป้องกันการดาวน์เกรด: หากเวอร์ชันเป้าหมายเก่ากว่าเวอร์ชันปัจจุบันของคุณ OpenClaw จะถามเพื่อยืนยัน (ข้ามได้ด้วย --yes)
  • --channel beta แตกต่างจาก --tag beta: โฟลว์ของช่องทางสามารถย้อนกลับไปใช้ stable/latest ได้เมื่อไม่มี beta หรือเก่ากว่า ขณะที่ --tag beta จะกำหนดเป้าหมาย dist-tag beta ดิบสำหรับการรันครั้งนั้นครั้งเดียว

​
Dry run

ดูตัวอย่างว่า openclaw update จะทำอะไรโดยไม่เปลี่ยนแปลงอะไร: 
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
dry run จะแสดงช่องทางที่มีผล เวอร์ชันเป้าหมาย การดำเนินการที่วางแผนไว้ และ ต้องมีการยืนยันการดาวน์เกรดหรือไม่

​
Plugin และช่องทาง

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

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

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

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