การอัปเดต

ทำให้ OpenClaw เป็นเวอร์ชันล่าสุดอยู่เสมอ

# แนะนำ: openclaw update

วิธีที่เร็วที่สุดในการอัปเดต คำสั่งนี้จะตรวจหาประเภทการติดตั้งของคุณ (npm หรือ git), ดึงเวอร์ชันล่าสุด, รัน openclaw doctor และรีสตาร์ท Gateway

openclaw update

เมื่อต้องการสลับช่องทางหรือระบุเวอร์ชันเป้าหมาย:

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # แสดงตัวอย่างโดยไม่ปรับใช้

openclaw update ไม่รับ --verbose สำหรับการวินิจฉัยการอัปเดต ให้ใช้ --dry-run เพื่อแสดงตัวอย่างการดำเนินการที่วางแผนไว้, --json สำหรับผลลัพธ์แบบมีโครงสร้าง หรือ openclaw update status --json เพื่อตรวจสอบช่องทางและสถานะความพร้อมใช้งาน ตัวติดตั้ง มีแฟล็ก --verbose ของตัวเอง แต่แฟล็กนั้นไม่ได้เป็นส่วนหนึ่งของ openclaw update

--channel beta จะให้ความสำคัญกับ beta แต่ runtime จะย้อนกลับไปใช้ stable/latest เมื่อ ไม่มีแท็ก beta หรือเก่ากว่า stable release ล่าสุด ใช้ --tag beta หากคุณต้องการ raw npm beta dist-tag สำหรับการอัปเดตแพ็กเกจครั้งเดียว

OpenClaw ยังไม่มีช่องทางอัปเดตแบบ LTS หรือการสนับสนุนรายเดือน เรากำลัง มุ่งไปสู่สายการสนับสนุนรายเดือนที่เข้ากันได้กับ SemVer แต่ในปัจจุบันช่องทางที่รองรับ ยังคงเป็น stable, beta และ dev

ดู ช่องทางการพัฒนา สำหรับความหมายของช่องทาง

# สลับระหว่างการติดตั้งแบบ npm และ git

ใช้ช่องทางเมื่อคุณต้องการเปลี่ยนประเภทการติดตั้ง ตัวอัปเดตจะเก็บ สถานะ, config, credentials และ workspace ของคุณไว้ใน ~/.openclaw; โดยเปลี่ยนเฉพาะ การติดตั้งโค้ด OpenClaw ที่ CLI และ Gateway ใช้

# ติดตั้งแพ็กเกจ npm -> เช็กเอาต์ git ที่แก้ไขได้
openclaw update --channel dev

# เช็กเอาต์ git -> ติดตั้งแพ็กเกจ npm
openclaw update --channel stable

รันพร้อม --dry-run ก่อนเพื่อแสดงตัวอย่างการสลับโหมดการติดตั้งแบบละเอียด:

openclaw update --channel dev --dry-run
openclaw update --channel stable --dry-run

ช่องทาง dev จะทำให้มีการเช็กเอาต์ git, build และติดตั้ง global CLI จากเช็กเอาต์นั้น ช่องทาง stable และ beta ใช้การติดตั้งแบบแพ็กเกจ หาก ติดตั้ง Gateway ไว้แล้ว openclaw update จะรีเฟรช service metadata และรีสตาร์ท เว้นแต่คุณจะส่ง --no-restart

# ทางเลือก: รันตัวติดตั้งอีกครั้ง

curl -fsSL https://openclaw.ai/install.sh | bash

เพิ่ม --no-onboard เพื่อข้าม onboarding หากต้องการบังคับประเภทการติดตั้งเฉพาะผ่าน ตัวติดตั้ง ให้ส่ง --install-method git --no-onboard หรือ --install-method npm --no-onboard

หาก openclaw update ล้มเหลวหลังขั้นตอนการติดตั้งแพ็กเกจ npm ให้รัน ตัวติดตั้งอีกครั้ง ตัวติดตั้งจะไม่เรียกตัวอัปเดตเก่า แต่จะรันการติดตั้ง แพ็กเกจ global โดยตรง และสามารถกู้คืนการติดตั้ง npm ที่อัปเดตไปแล้วบางส่วนได้

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

หากต้องการตรึงการกู้คืนไว้ที่เวอร์ชันหรือ dist-tag เฉพาะ ให้เพิ่ม --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

# ทางเลือก: npm, pnpm หรือ bun แบบแมนนวล

npm i -g openclaw@latest

แนะนำให้ใช้ openclaw update สำหรับการติดตั้งที่มีการควบคุม เพราะสามารถประสาน การสลับแพ็กเกจกับบริการ Gateway ที่กำลังทำงานอยู่ได้ หากคุณอัปเดตด้วยตนเองขณะที่ Gateway ที่มีการจัดการกำลังทำงาน ให้รีสตาร์ท Gateway ทันทีหลังจาก package manager ทำงานเสร็จ เพื่อไม่ให้โปรเซสเก่ายังคงให้บริการจากไฟล์แพ็กเกจ ที่ถูกแทนที่แล้ว

เมื่อ openclaw update จัดการการติดตั้ง global npm คำสั่งจะติดตั้งเป้าหมายลงใน npm prefix ชั่วคราวก่อน ตรวจสอบ packaged dist inventory แล้วจึงสลับ package tree ที่สะอาดเข้าไปใน global prefix จริง วิธีนี้หลีกเลี่ยงไม่ให้ npm วาง แพ็กเกจใหม่ทับไฟล์ค้างจากแพ็กเกจเก่า หากคำสั่งติดตั้งล้มเหลว OpenClaw จะลองซ้ำหนึ่งครั้งด้วย --omit=optional การลองซ้ำนี้ช่วยโฮสต์ที่ native optional dependencies คอมไพล์ไม่ได้ ขณะที่ยังคงแสดงข้อผิดพลาดเดิม หาก fallback ก็ล้มเหลวเช่นกัน

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# หัวข้อขั้นสูงเกี่ยวกับการติดตั้ง npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

# ตัวอัปเดตอัตโนมัติ

ตัวอัปเดตอัตโนมัติปิดอยู่โดยค่าเริ่มต้น เปิดใช้งานใน ~/.openclaw/openclaw.json:

{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}

Gateway ยังบันทึกคำแนะนำการอัปเดตเมื่อเริ่มต้นด้วย (ปิดด้วย update.checkOnStart: false) สำหรับการ downgrade หรือการกู้คืนจากเหตุการณ์ ให้ตั้ง OPENCLAW_NO_AUTO_UPDATE=1 ในสภาพแวดล้อมของ Gateway เพื่อบล็อกการปรับใช้อัตโนมัติแม้จะตั้งค่า update.auto.enabled แล้วก็ตาม คำแนะนำการอัปเดตตอนเริ่มต้นยังสามารถทำงานได้ เว้นแต่จะปิด update.checkOnStart ด้วย

การอัปเดตผ่าน package-manager ที่ร้องขอผ่านตัวจัดการ live Gateway control-plane จะบังคับให้รีสตาร์ทการอัปเดตแบบไม่เลื่อนและไม่มี cooldown หลังการสลับแพ็กเกจ วิธีนี้ หลีกเลี่ยงการปล่อยให้โปรเซสเก่าในหน่วยความจำค้างอยู่นานพอที่จะ lazy-load chunks จาก package tree ที่ถูกแทนที่แล้ว Shell openclaw update ยังคงเป็นเส้นทางที่แนะนำสำหรับการติดตั้งที่มีการควบคุม เพราะสามารถหยุดและ รีสตาร์ทบริการรอบการอัปเดตได้

# หลังอัปเดต

openclaw doctor

openclaw gateway restart

openclaw health

# ย้อนกลับ

# ตรึงเวอร์ชัน (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart

# ตรึง commit (source)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart

หากต้องการกลับไปยังเวอร์ชันล่าสุด: git checkout main && git pull

# หากคุณติดขัด

• รัน openclaw doctor อีกครั้งและอ่านผลลัพธ์อย่างรอบคอบ
• สำหรับ openclaw update --channel dev บน source checkouts ตัวอัปเดตจะ bootstrap pnpm อัตโนมัติเมื่อจำเป็น หากคุณเห็นข้อผิดพลาดเกี่ยวกับ pnpm/corepack bootstrap ให้ติดตั้ง pnpm ด้วยตนเอง (หรือเปิดใช้ corepack อีกครั้ง) แล้วรันการอัปเดตใหม่
• ตรวจสอบ: การแก้ไขปัญหา
• ถามใน Discord: https://discord.gg/clawd

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

• ภาพรวมการติดตั้ง: วิธีการติดตั้งทั้งหมด
• Doctor: การตรวจสุขภาพหลังการอัปเดต
• การย้ายระบบ: คู่มือการย้ายเวอร์ชันหลัก