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.

ข้อกำหนดของระบบ

  • Node 24 (แนะนำ) หรือ Node 22.16+ - สคริปต์ติดตั้งจัดการเรื่องนี้ให้อัตโนมัติ
  • macOS, Linux หรือ Windows - รองรับทั้ง Windows แบบเนทีฟและ WSL2; WSL2 มีความเสถียรมากกว่า ดู Windows
  • จำเป็นต้องใช้ pnpm เฉพาะเมื่อคุณ build จากซอร์ส

แนะนำ: สคริปต์ติดตั้ง

วิธีติดตั้งที่เร็วที่สุด โดยจะตรวจหา OS ของคุณ ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw และเริ่ม onboarding
curl -fsSL https://openclaw.ai/install.sh | bash
หากต้องการติดตั้งโดยไม่รัน onboarding:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
สำหรับ flags ทั้งหมดและตัวเลือก CI/automation ดู รายละเอียดภายในของตัวติดตั้ง

วิธีติดตั้งทางเลือก

ตัวติดตั้งแบบ local prefix (install-cli.sh)

ใช้วิธีนี้เมื่อคุณต้องการเก็บ OpenClaw และ Node ไว้ใต้ local prefix เช่น ~/.openclaw โดยไม่ต้องพึ่งการติดตั้ง Node ระดับทั้งระบบ:
curl -fsSL https://openclaw.ai/install-cli.sh | bash
โดยค่าเริ่มต้นรองรับการติดตั้งผ่าน npm รวมถึงการติดตั้งแบบ git-checkout ภายใต้ flow prefix เดียวกัน อ้างอิงฉบับเต็ม: รายละเอียดภายในของตัวติดตั้ง ติดตั้งไว้แล้วใช่ไหม สลับระหว่างการติดตั้งแบบ package และ git ด้วย openclaw update --channel dev และ openclaw update --channel stable ดู การอัปเดต

npm, pnpm หรือ bun

หากคุณจัดการ Node เองอยู่แล้ว:
npm install -g openclaw@latest
openclaw onboard --install-daemon
หาก sharp ล้มเหลวเนื่องจาก libvips ที่ติดตั้งแบบ global:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

จากซอร์ส

สำหรับผู้ร่วมพัฒนาหรือใครก็ตามที่ต้องการรันจาก checkout ภายในเครื่อง:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
หรือข้ามการ link แล้วใช้ pnpm openclaw ... จากภายใน repo ดู การตั้งค่า สำหรับ workflow การพัฒนาแบบเต็ม

ติดตั้งจาก GitHub main

npm install -g github:openclaw/openclaw#main

Containers และ package managers

Docker

การ deploy แบบ containerized หรือ headless

Podman

ทางเลือก container แบบ rootless แทน Docker

Nix

การติดตั้งแบบ declarative ผ่าน Nix flake

Ansible

การ provision fleet แบบอัตโนมัติ

Bun

การใช้งานเฉพาะ CLI ผ่านรันไทม์ Bun

ตรวจสอบการติดตั้ง

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
หากคุณต้องการ managed startup หลังติดตั้ง:
  • macOS: LaunchAgent ผ่าน openclaw onboard --install-daemon หรือ openclaw gateway install
  • Linux/WSL2: systemd user service ผ่านคำสั่งเดียวกัน
  • Windows แบบเนทีฟ: ใช้ Scheduled Task ก่อน โดยมีรายการ login ใน Startup-folder ต่อผู้ใช้เป็น fallback หากการสร้าง task ถูกปฏิเสธ

Hosting และ deployment

Deploy OpenClaw บน cloud server หรือ VPS:

VPS

VPS Linux ใดก็ได้

Docker VM

ขั้นตอน Docker ร่วมกัน

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

อัปเดต ย้าย หรือถอนการติดตั้ง

การอัปเดต

ทำให้ OpenClaw เป็นปัจจุบันอยู่เสมอ

การย้าย

ย้ายไปยังเครื่องใหม่

ถอนการติดตั้ง

ลบ OpenClaw ออกทั้งหมด

การแก้ไขปัญหา: ไม่พบ openclaw

หากติดตั้งสำเร็จแล้วแต่ไม่พบ openclaw ใน terminal ของคุณ:
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
หาก $(npm prefix -g)/bin ไม่อยู่ใน $PATH ของคุณ ให้เพิ่มลงในไฟล์ startup ของ shell (~/.zshrc หรือ ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
จากนั้นเปิด terminal ใหม่ ดู การตั้งค่า Node สำหรับรายละเอียดเพิ่มเติม