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 มีสคริปต์ติดตั้งให้มาสามรายการ โดยให้บริการจาก openclaw.ai
สคริปต์แพลตฟอร์มหน้าที่
install.shmacOS / Linux / WSLติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw ผ่าน npm (ค่าเริ่มต้น) หรือ git และสามารถเรียกใช้ onboarding ได้
install-cli.shmacOS / Linux / WSLติดตั้ง Node + OpenClaw ลงใน prefix ภายในเครื่อง (~/.openclaw) ด้วยโหมด npm หรือ git checkout ไม่ต้องใช้ root
install.ps1Windows (PowerShell)ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw ผ่าน npm (ค่าเริ่มต้น) หรือ git และสามารถเรียกใช้ onboarding ได้

​
คำสั่งด่วน

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
หากติดตั้งสำเร็จแต่ไม่พบ openclaw ใน terminal ใหม่ ให้ดู การแก้ปัญหา Node.js

​
install.sh

แนะนำสำหรับการติดตั้งแบบโต้ตอบส่วนใหญ่บน macOS/Linux/WSL

​
ลำดับการทำงาน (install.sh)

1

Detect OS

รองรับ macOS และ Linux (รวมถึง WSL) หากตรวจพบ macOS จะติดตั้ง Homebrew หากยังไม่มี
2

Ensure Node.js 24 by default

ตรวจสอบเวอร์ชัน Node และติดตั้ง Node 24 หากจำเป็น (Homebrew บน macOS, สคริปต์ตั้งค่า NodeSource บน Linux apt/dnf/yum) OpenClaw ยังรองรับ Node 22 LTS ซึ่งปัจจุบันคือ 22.16+ เพื่อความเข้ากันได้
3

Ensure Git

ติดตั้ง Git หากยังไม่มี
4

Install OpenClaw

  • วิธี npm (ค่าเริ่มต้น): ติดตั้ง npm แบบ global
  • วิธี git: clone/update repo, ติดตั้ง deps ด้วย pnpm, build จากนั้นติดตั้ง wrapper ที่ ~/.local/bin/openclaw
5

Post-install tasks

  • refresh บริการ gateway ที่โหลดอยู่แบบ best-effort (openclaw gateway install --force แล้ว restart)
  • เรียกใช้ openclaw doctor --non-interactive เมื่อ upgrade และติดตั้งด้วย git (best effort)
  • พยายามเริ่ม onboarding เมื่อเหมาะสม (มี TTY, ไม่ได้ปิด onboarding และการตรวจสอบ bootstrap/config ผ่าน)
  • ตั้งค่าเริ่มต้น SHARP_IGNORE_GLOBAL_LIBVIPS=1

​
การตรวจหา source checkout

หากเรียกใช้ภายใน checkout ของ OpenClaw (package.json + pnpm-workspace.yaml) สคริปต์จะเสนอ:
  • ใช้ checkout (git) หรือ
  • ใช้การติดตั้งแบบ global (npm)
หากไม่มี TTY และไม่ได้ตั้งค่าวิธีติดตั้งไว้ ระบบจะใช้ค่าเริ่มต้นเป็น npm และแสดงคำเตือน สคริปต์จะ exit ด้วย code 2 เมื่อเลือกวิธีไม่ถูกต้องหรือค่า --install-method ไม่ถูกต้อง

​
ตัวอย่าง (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
Flagคำอธิบาย
--install-method npm|gitเลือกวิธีติดตั้ง (ค่าเริ่มต้น: npm) Alias: --method
--npmทางลัดสำหรับวิธี npm
--gitทางลัดสำหรับวิธี git Alias: --github
--version <version|dist-tag|spec>เวอร์ชัน npm, dist-tag หรือ package spec (ค่าเริ่มต้น: latest)
--betaใช้ beta dist-tag หากมี มิฉะนั้น fallback ไปที่ latest
--git-dir <path>ไดเรกทอรี checkout (ค่าเริ่มต้น: ~/openclaw) Alias: --dir
--no-git-updateข้าม git pull สำหรับ checkout ที่มีอยู่แล้ว
--no-promptปิด prompts
--no-onboardข้าม onboarding
--onboardเปิดใช้ onboarding
--dry-runพิมพ์การดำเนินการโดยไม่ใช้การเปลี่ยนแปลงจริง
--verboseเปิดใช้ output สำหรับ debug (set -x, log ระดับ notice ของ npm)
--helpแสดงวิธีใช้ (-h)
Variableคำอธิบาย
OPENCLAW_INSTALL_METHOD=git|npmวิธีติดตั้ง
OPENCLAW_VERSION=latest|next|main|<semver>|<spec>เวอร์ชัน npm, dist-tag หรือ package spec
OPENCLAW_BETA=0|1ใช้ beta หากมี
OPENCLAW_GIT_DIR=<path>ไดเรกทอรี checkout
OPENCLAW_GIT_UPDATE=0|1เปิด/ปิดการ update git
OPENCLAW_NO_PROMPT=1ปิด prompts
OPENCLAW_NO_ONBOARD=1ข้าม onboarding
OPENCLAW_DRY_RUN=1โหมด dry run
OPENCLAW_VERBOSE=1โหมด debug
OPENCLAW_NPM_LOGLEVEL=error|warn|noticeระดับ log ของ npm
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1ควบคุมพฤติกรรม sharp/libvips (ค่าเริ่มต้น: 1)

​
install-cli.sh

ออกแบบมาสำหรับสภาพแวดล้อมที่คุณต้องการให้ทุกอย่างอยู่ภายใต้ prefix ภายในเครื่อง (ค่าเริ่มต้น ~/.openclaw) และไม่มี dependency ของ Node ระดับระบบ รองรับการติดตั้งด้วย npm เป็นค่าเริ่มต้น พร้อมทั้งการติดตั้งแบบ git-checkout ภายใต้ลำดับ prefix เดียวกัน

​
ลำดับการทำงาน (install-cli.sh)

1

Install local Node runtime

ดาวน์โหลด tarball ของ Node LTS ที่รองรับและปักหมุดไว้ (เวอร์ชันฝังอยู่ในสคริปต์และอัปเดตแยกต่างหาก) ไปยัง <prefix>/tools/node-v<version> และตรวจสอบ SHA-256
2

Ensure Git

หากไม่มี Git จะพยายามติดตั้งผ่าน apt/dnf/yum บน Linux หรือ Homebrew บน macOS
3

Install OpenClaw under prefix

  • วิธี npm (ค่าเริ่มต้น): ติดตั้งภายใต้ prefix ด้วย npm จากนั้นเขียน wrapper ไปที่ <prefix>/bin/openclaw
  • วิธี git: clone/update checkout (ค่าเริ่มต้น ~/openclaw) และยังเขียน wrapper ไปที่ <prefix>/bin/openclaw
4

Refresh loaded gateway service

หากบริการ gateway โหลดจาก prefix เดียวกันอยู่แล้ว สคริปต์จะเรียกใช้ openclaw gateway install --force จากนั้น openclaw gateway restart และ probe สถานะ gateway health แบบ best-effort

​
ตัวอย่าง (install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
Flagคำอธิบาย
--prefix <path>prefix สำหรับติดตั้ง (ค่าเริ่มต้น: ~/.openclaw)
--install-method npm|gitเลือกวิธีติดตั้ง (ค่าเริ่มต้น: npm) Alias: --method
--npmทางลัดสำหรับวิธี npm
--git, --githubทางลัดสำหรับวิธี git
--git-dir <path>ไดเรกทอรี Git checkout (ค่าเริ่มต้น: ~/openclaw) Alias: --dir
--version <ver>เวอร์ชัน OpenClaw หรือ dist-tag (ค่าเริ่มต้น: latest)
--node-version <ver>เวอร์ชัน Node (ค่าเริ่มต้น: 22.22.0)
--jsonส่งออก event แบบ NDJSON
--onboardเรียกใช้ openclaw onboard หลังติดตั้ง
--no-onboardข้าม onboarding (ค่าเริ่มต้น)
--set-npm-prefixบน Linux บังคับ prefix ของ npm เป็น ~/.npm-global หาก prefix ปัจจุบันเขียนไม่ได้
--helpแสดงวิธีใช้ (-h)
ตัวแปรคำอธิบาย
OPENCLAW_PREFIX=<path>คำนำหน้าการติดตั้ง
OPENCLAW_INSTALL_METHOD=git|npmวิธีการติดตั้ง
OPENCLAW_VERSION=<ver>เวอร์ชัน OpenClaw หรือ dist-tag
OPENCLAW_NODE_VERSION=<ver>เวอร์ชัน Node
OPENCLAW_GIT_DIR=<path>ไดเรกทอรี Git checkout สำหรับการติดตั้งด้วย git
OPENCLAW_GIT_UPDATE=0|1เปิด/ปิดการอัปเดต git สำหรับ checkout ที่มีอยู่
OPENCLAW_NO_ONBOARD=1ข้ามการเริ่มต้นใช้งาน
OPENCLAW_NPM_LOGLEVEL=error|warn|noticeระดับบันทึกของ npm
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1ควบคุมพฤติกรรม sharp/libvips (ค่าเริ่มต้น: 1)

​
install.ps1

​
โฟลว์ (install.ps1)

1

ตรวจสอบให้แน่ใจว่ามีสภาพแวดล้อม PowerShell + Windows

ต้องใช้ PowerShell 5+.
2

ตรวจสอบให้แน่ใจว่ามี Node.js 24 เป็นค่าเริ่มต้น

หากไม่มี จะพยายามติดตั้งผ่าน winget จากนั้น Chocolatey แล้วจึง Scoop ส่วน Node 22 LTS ซึ่งปัจจุบันคือ 22.16+ ยังรองรับอยู่เพื่อความเข้ากันได้
3

ติดตั้ง OpenClaw

  • วิธี npm (ค่าเริ่มต้น): ติดตั้ง npm แบบ global โดยใช้ -Tag ที่เลือก เรียกจากไดเรกทอรี temp ของตัวติดตั้งที่เขียนได้ เพื่อให้ shell ที่เปิดในโฟลเดอร์ที่มีการป้องกัน เช่น C:\ ยังทำงานได้
  • วิธี git: clone/update repo, install/build ด้วย pnpm และติดตั้ง wrapper ที่ %USERPROFILE%\.local\bin\openclaw.cmd
4

งานหลังการติดตั้ง

  • เพิ่มไดเรกทอรี bin ที่จำเป็นลงใน PATH ของผู้ใช้เมื่อทำได้
  • รีเฟรชบริการ Gateway ที่โหลดอยู่แบบ best-effort (openclaw gateway install --force จากนั้น restart)
  • รัน openclaw doctor --non-interactive เมื่ออัปเกรดและเมื่อติดตั้งด้วย git (best effort)
5

จัดการความล้มเหลว

การติดตั้งด้วย iwr ... | iex และ scriptblock จะรายงานข้อผิดพลาดแบบ terminating error โดยไม่ปิดเซสชัน PowerShell ปัจจุบัน การติดตั้งโดยตรงด้วย powershell -File / pwsh -File ยังคงออกด้วยสถานะ non-zero สำหรับ automation

​
ตัวอย่าง (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex
Flagคำอธิบาย
-InstallMethod npm|gitวิธีการติดตั้ง (ค่าเริ่มต้น: npm)
-Tag <tag|version|spec>npm dist-tag, เวอร์ชัน หรือ package spec (ค่าเริ่มต้น: latest)
-GitDir <path>ไดเรกทอรี checkout (ค่าเริ่มต้น: %USERPROFILE%\openclaw)
-NoOnboardข้ามการเริ่มต้นใช้งาน
-NoGitUpdateข้าม git pull
-DryRunพิมพ์เฉพาะการดำเนินการ
ตัวแปรคำอธิบาย
OPENCLAW_INSTALL_METHOD=git|npmวิธีการติดตั้ง
OPENCLAW_GIT_DIR=<path>ไดเรกทอรี checkout
OPENCLAW_NO_ONBOARD=1ข้ามการเริ่มต้นใช้งาน
OPENCLAW_GIT_UPDATE=0ปิดใช้งาน git pull
OPENCLAW_DRY_RUN=1โหมด dry run
หากใช้ -InstallMethod git และไม่มี Git สคริปต์จะออกและพิมพ์ลิงก์ Git for Windows

​
CI และ automation

ใช้ flags/env vars แบบ non-interactive เพื่อให้การรันคาดเดาได้ 
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

​
การแก้ไขปัญหา

ต้องใช้ Git สำหรับวิธีติดตั้งแบบ git สำหรับการติดตั้งแบบ npm ยังคงตรวจสอบ/ติดตั้ง Git เพื่อหลีกเลี่ยงความล้มเหลว spawn git ENOENT เมื่อ dependency ใช้ URL แบบ git
การตั้งค่า Linux บางแบบชี้ npm global prefix ไปยัง path ที่ root เป็นเจ้าของ install.sh สามารถเปลี่ยน prefix เป็น ~/.npm-global และเพิ่ม PATH exports ต่อท้ายไฟล์ shell rc ได้ (เมื่อไฟล์เหล่านั้นมีอยู่)
สคริปต์ตั้งค่าเริ่มต้น SHARP_IGNORE_GLOBAL_LIBVIPS=1 เพื่อหลีกเลี่ยงไม่ให้ sharp build โดยอิงกับ system libvips หากต้องการ override:
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
ติดตั้ง Git for Windows เปิด PowerShell ใหม่ แล้วรันตัวติดตั้งอีกครั้ง
รัน npm config get prefix และเพิ่มไดเรกทอรีนั้นลงใน PATH ของผู้ใช้ของคุณ (บน Windows ไม่จำเป็นต้องมี suffix \bin) จากนั้นเปิด PowerShell ใหม่
ปัจจุบัน install.ps1 ยังไม่มีสวิตช์ -Verbose ใช้ PowerShell tracing สำหรับการวินิจฉัยระดับสคริปต์:
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
โดยปกติเป็นปัญหา PATH ดู การแก้ไขปัญหา Node.js

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