OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

กลไกภายในของตัวติดตั้ง

OpenClaw มาพร้อมสคริปต์ติดตั้งสามรายการ ซึ่งให้บริการจาก openclaw.ai

สคริปต์ แพลตฟอร์ม การทำงาน
install.sh macOS / Linux / WSL ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw ผ่าน npm (ค่าเริ่มต้น) หรือ git และสามารถเริ่มกระบวนการตั้งค่าได้
install-cli.sh macOS / Linux / WSL ติดตั้ง Node + OpenClaw ลงในคำนำหน้าภายในเครื่อง (~/.openclaw) ผ่าน npm หรือ git โดยไม่ต้องใช้สิทธิ์ root
install.ps1 Windows (PowerShell) ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw ผ่าน npm (ค่าเริ่มต้น) หรือ git และสามารถเริ่มกระบวนการตั้งค่าได้

ทั้งสามรายการรองรับ Node 22.19+, 23.11+ หรือ 24+ โดย Node 24 เป็นเป้าหมายเริ่มต้นสำหรับการติดตั้งใหม่

คำสั่งด่วน

install.sh

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

install-cli.sh

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

install.ps1

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

install.sh

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

  • ตรวจหาระบบปฏิบัติการ

    รองรับ macOS และ Linux (รวมถึง WSL)

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

    ตรวจสอบเวอร์ชัน Node และติดตั้ง Node 24 หากจำเป็น (ใช้ Homebrew บน macOS และสคริปต์ตั้งค่า NodeSource บน Linux ที่ใช้ apt/dnf/yum) บน macOS จะติดตั้ง Homebrew เฉพาะเมื่อตัวติดตั้งจำเป็นต้องใช้สำหรับ Node หรือ Git เท่านั้น Node 22.19+ และ 23.11+ ยังคงรองรับเพื่อความเข้ากันได้ บน Alpine/musl Linux ตัวติดตั้งจะใช้แพ็กเกจ apk แทน NodeSource โดยคลังแพ็กเกจ Alpine ที่กำหนดค่าไว้ต้องมี Node เวอร์ชันที่รองรับ (Alpine 3.21 หรือใหม่กว่า ณ เวลาที่เขียน)

  • ตรวจสอบให้มี Git

    ติดตั้ง Git หากยังไม่มีโดยใช้ตัวจัดการแพ็กเกจที่ตรวจพบ รวมถึง Homebrew บน macOS และ apk บน Alpine

  • ติดตั้ง OpenClaw

    • วิธี npm (ค่าเริ่มต้น): ติดตั้ง npm แบบส่วนกลาง
    • วิธี git: โคลน/อัปเดตที่เก็บ ติดตั้งการขึ้นต่อกันด้วย pnpm สร้างโปรแกรม แล้วติดตั้งตัวห่อคำสั่งที่ ~/.local/bin/openclaw

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

    • ระบุตำแหน่งไบนารี openclaw ที่เพิ่งติดตั้งเพื่อใช้กับคำสั่งถัดไป
    • สำหรับการติดตั้งที่ยังไม่ได้กำหนดค่า จะเริ่มกระบวนการตั้งค่าก่อนตรวจสอบด้วย doctor หรือทดสอบ Gateway เมื่อใช้ --no-onboard หรือไม่มี TTY ระบบจะแสดงคำสั่งสำหรับตั้งค่าให้เสร็จในภายหลัง
    • สำหรับการติดตั้งที่กำหนดค่าแล้ว จะรีเฟรชและเริ่มบริการ Gateway ที่โหลดอยู่ใหม่แบบพยายามให้ดีที่สุด แล้วเรียกใช้ doctor การอัปเกรดจะอัปเดต Plugin เมื่อทำได้ หรือแสดงคำสั่งสำหรับดำเนินการด้วยตนเองในการทำงานแบบไม่มีส่วนติดต่อที่เปิดใช้พรอมต์
    • เมื่อเรียกใช้ --verify ระบบจะตรวจสอบเวอร์ชันที่ติดตั้ง และตรวจสอบสถานะ Gateway เฉพาะเมื่อมีการกำหนดค่าแล้วเท่านั้น

    • การตรวจหาสำเนาซอร์สโค้ด

    หากเรียกใช้ภายในสำเนาซอร์สโค้ด OpenClaw (package.json + pnpm-workspace.yaml) สคริปต์จะเสนอตัวเลือกดังนี้:

    • ใช้สำเนาซอร์สโค้ด (git) หรือ
    • ใช้การติดตั้งแบบส่วนกลาง (npm)

    หากไม่มี TTY และไม่ได้กำหนดวิธีติดตั้ง ระบบจะใช้ npm เป็นค่าเริ่มต้นและแสดงคำเตือน

    สคริปต์จะจบการทำงานด้วยรหัส 2 เมื่อเลือกวิธีไม่ถูกต้องหรือระบุค่า --install-method ไม่ถูกต้อง

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

    ค่าเริ่มต้น

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

    ข้ามกระบวนการตั้งค่า

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

    ติดตั้งด้วย Git

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

    สำเนาซอร์สโค้ด main จาก GitHub

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

    ทดลองทำงาน

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

    ตรวจสอบหลังติดตั้ง

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verify
    ข้อมูลอ้างอิงแฟล็ก
    แฟล็ก คำอธิบาย
    --install-method | --method npm|git เลือกวิธีติดตั้ง (ค่าเริ่มต้น: npm)
    --npm ทางลัดสำหรับวิธี npm
    --git | --github ทางลัดสำหรับวิธี git
    --version <version|dist-tag|spec> เวอร์ชัน npm, dist-tag หรือข้อกำหนดแพ็กเกจ (ค่าเริ่มต้น: latest)
    --beta ใช้ dist-tag รุ่นเบต้าหากมี มิฉะนั้นให้ย้อนกลับไปใช้ latest
    --git-dir | --dir <path> ไดเรกทอรีสำเนาซอร์สโค้ด (ค่าเริ่มต้น: ~/openclaw)
    --no-git-update ข้าม git pull สำหรับสำเนาซอร์สโค้ดที่มีอยู่
    --no-prompt ปิดใช้งานพรอมต์
    --no-onboard ข้ามกระบวนการตั้งค่า
    --onboard เปิดใช้กระบวนการตั้งค่า
    --verify เรียกใช้การตรวจสอบเบื้องต้นหลังติดตั้ง (--version และสถานะ Gateway หากโหลดอยู่)
    --dry-run แสดงการดำเนินการโดยไม่ใช้การเปลี่ยนแปลง
    --verbose เปิดใช้ผลลัพธ์การดีบัก (set -x และบันทึกระดับ notice ของ npm)
    --help | -h แสดงวิธีใช้
    ข้อมูลอ้างอิงตัวแปรสภาพแวดล้อม
    ตัวแปร คำอธิบาย
    OPENCLAW_INSTALL_METHOD=git|npm วิธีติดตั้ง
    OPENCLAW_VERSION=latest|next|<semver>|<spec> เวอร์ชัน npm, dist-tag หรือข้อกำหนดแพ็กเกจ
    OPENCLAW_BETA=0|1 ใช้รุ่นเบต้าหากมี
    OPENCLAW_HOME=<path> ไดเรกทอรีฐานสำหรับสถานะ OpenClaw และเส้นทางเริ่มต้นของ git/กระบวนการตั้งค่า
    OPENCLAW_GIT_DIR=<path> ไดเรกทอรีสำเนาซอร์สโค้ด
    OPENCLAW_GIT_UPDATE=0|1 เปิดหรือปิดการอัปเดต git
    OPENCLAW_NO_PROMPT=1 ปิดใช้งานพรอมต์
    OPENCLAW_VERIFY_INSTALL=1 เรียกใช้การตรวจสอบเบื้องต้นหลังติดตั้ง
    OPENCLAW_NO_ONBOARD=1 ข้ามกระบวนการตั้งค่า
    OPENCLAW_DRY_RUN=1 โหมดทดลองทำงาน
    OPENCLAW_VERBOSE=1 โหมดดีบัก
    OPENCLAW_NPM_LOGLEVEL=error|warn|notice ระดับบันทึกของ npm (ค่าเริ่มต้น: error ซึ่งซ่อนข้อความการเลิกสนับสนุนของ npm)

    install-cli.sh

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

  • ติดตั้งสภาพแวดล้อมรันไทม์ Node ภายในเครื่อง

    ดาวน์โหลดไฟล์ tarball ของ Node LTS เวอร์ชันที่รองรับและตรึงไว้ (เวอร์ชันฝังอยู่ในสคริปต์และอัปเดตแยกกัน โดยค่าเริ่มต้นคือ 22.22.2) ไปยัง <prefix>/tools/node-v<version> และตรวจสอบ SHA-256 บน Alpine/musl Linux ซึ่ง Node ไม่มีไฟล์ tarball ที่เข้ากันได้สำหรับรันไทม์ที่ตรึงไว้ ระบบจะติดตั้ง nodejs และ npm ด้วย apk และเชื่อมโยงรันไทม์นั้นเข้ากับเส้นทางตัวห่อคำสั่งของคำนำหน้า คลังแพ็กเกจ Alpine ต้องมี Node เวอร์ชันที่รองรับ (22.19+, 23.11+ หรือ 24+) ให้ใช้ Alpine 3.21 หรือใหม่กว่าหากคลังแพ็กเกจรุ่นเก่ามีเพียง Node 20 หรือ 21

  • ตรวจสอบให้มี Git

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

  • ติดตั้ง OpenClaw ภายใต้คำนำหน้า

    • วิธี npm (ค่าเริ่มต้น): ติดตั้งภายใต้คำนำหน้าด้วย npm แล้วเขียนตัวห่อคำสั่งไปยัง <prefix>/bin/openclaw
    • วิธี git: โคลน/อัปเดตสำเนาซอร์สโค้ด (ค่าเริ่มต้น ~/openclaw) และยังคงเขียนตัวห่อคำสั่งไปยัง <prefix>/bin/openclaw

  • รีเฟรชบริการ Gateway ที่โหลดอยู่

    หากมีบริการ Gateway ที่โหลดจากคำนำหน้าเดียวกันอยู่แล้ว สคริปต์จะเรียกใช้ openclaw gateway install --force จากนั้นเรียกใช้ openclaw gateway restart และ ทดสอบสถานะ Gateway แบบพยายามให้ดีที่สุด

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

    ค่าเริ่มต้น

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

    คำนำหน้ากำหนดเอง + เวอร์ชัน

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

    ติดตั้งด้วย Git

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

    ผลลัพธ์ JSON สำหรับระบบอัตโนมัติ

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

    เรียกใช้กระบวนการตั้งค่า

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

    install.ps1

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

  • ตรวจสอบสภาพแวดล้อม PowerShell + Windows

    ต้องใช้ PowerShell 5 ขึ้นไป

  • ตรวจสอบให้มี Node.js 24 โดยค่าเริ่มต้น

    หากไม่มี สคริปต์จะพยายามติดตั้งผ่าน winget จากนั้น Chocolatey แล้วจึง Scoop หากไม่มีตัวจัดการแพ็กเกจ สคริปต์จะดาวน์โหลดไฟล์ zip ทางการของ Node.js 24 สำหรับ Windows ไปยัง %LOCALAPPDATA%\OpenClaw\deps\portable-node และเพิ่มลงใน PATH ของกระบวนการปัจจุบันและผู้ใช้ Node 22.19 ขึ้นไปและ 23.11 ขึ้นไปยังคงรองรับเพื่อความเข้ากันได้

  • ติดตั้ง OpenClaw

    • วิธี npm (ค่าเริ่มต้น): ติดตั้ง npm แบบส่วนกลางโดยใช้ -Tag ที่เลือก เรียกใช้จากไดเรกทอรีชั่วคราวของตัวติดตั้งที่เขียนได้ เพื่อให้เชลล์ที่เปิดในโฟลเดอร์ที่ได้รับการป้องกัน เช่น C:\ ยังคงทำงานได้
    • วิธี git: โคลน/อัปเดตที่เก็บ ติดตั้ง/บิลด์ด้วย pnpm และติดตั้งตัวห่อคำสั่งที่ %USERPROFILE%\.local\bin\openclaw.cmd หากไม่มี Git สคริปต์จะบูตสแตรป MinGit เฉพาะผู้ใช้ภายใต้ %LOCALAPPDATA%\OpenClaw\deps\portable-git และเพิ่มลงใน PATH ของกระบวนการปัจจุบันและผู้ใช้

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

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

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

    การติดตั้งด้วย iwr ... | iex และ scriptblock จะรายงานข้อผิดพลาดที่ยุติการทำงานโดยไม่ปิดเซสชัน PowerShell ปัจจุบัน ส่วนการติดตั้งโดยตรงด้วย powershell -File / pwsh -File จะยังคงออกด้วยรหัสที่ไม่ใช่ศูนย์สำหรับระบบอัตโนมัติ

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

    ค่าเริ่มต้น

    powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex

    ติดตั้งด้วย Git

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

    เช็กเอาต์ main จาก GitHub

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

    ไดเรกทอรี git กำหนดเอง

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

    ทดลองทำงาน

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

    CI และระบบอัตโนมัติ

    ใช้แฟล็ก/ตัวแปรสภาพแวดล้อมแบบไม่โต้ตอบเพื่อให้การทำงานคาดการณ์ได้

    install.sh (npm แบบไม่โต้ตอบ)

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

    install.sh (git แบบไม่โต้ตอบ)

    bash
    OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

    install-cli.sh (JSON)

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

    install.ps1 (ข้ามการเริ่มต้นใช้งาน)

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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

    เหตุใดจึงต้องใช้ Git

    วิธีติดตั้งแบบ git จำเป็นต้องใช้ Git สำหรับการติดตั้งแบบ npm ระบบยังคงตรวจสอบ/ติดตั้ง Git เพื่อหลีกเลี่ยงความล้มเหลว spawn git ENOENT เมื่อการขึ้นต่อกันใช้ URL ของ git

    เหตุใด npm จึงพบ EACCES บน Linux

    การตั้งค่า Linux บางแบบชี้คำนำหน้าส่วนกลางของ npm ไปยังพาธที่ root เป็นเจ้าของ install.sh สามารถเปลี่ยนคำนำหน้าเป็น ~/.npm-global และเพิ่มคำสั่งส่งออก PATH ลงในไฟล์ rc ของเชลล์ (เมื่อมีไฟล์เหล่านั้น)

    Windows: "npm error spawn git / ENOENT"

    เรียกใช้ตัวติดตั้งอีกครั้งเพื่อให้สามารถบูตสแตรป MinGit เฉพาะผู้ใช้ หรือติดตั้ง Git for Windows แล้วเปิด PowerShell ใหม่

    Windows: "openclaw is not recognized"

    เรียกใช้ npm config get prefix และเพิ่มไดเรกทอรีนั้นลงใน PATH ของผู้ใช้ (ไม่ต้องมีส่วนต่อท้าย \bin บน Windows) แล้วเปิด PowerShell ใหม่

    Windows: วิธีดูผลลัพธ์โดยละเอียดจากตัวติดตั้ง

    install.ps1 ไม่มีสวิตช์ -Verbose ใช้การติดตามของ PowerShell สำหรับการวินิจฉัยระดับสคริปต์:

    powershell
    Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0
    ไม่พบ openclaw หลังการติดตั้ง

    โดยทั่วไปเป็นปัญหาเกี่ยวกับ PATH โปรดดูการแก้ไขปัญหา Node.js

    เนื้อหาที่เกี่ยวข้อง

    Was this useful?
    On this page

    On this page