Chi tiết Installer

OpenClaw cung cấp hai script cài đặt (được phục vụ từ openclaw.ai):

  • https://openclaw.ai/install.sh — installer “được khuyên dùng” (cài đặt npm global mặc định; cũng có thể cài từ GitHub checkout)
  • https://openclaw.ai/install-cli.sh — CLI installer không cần quyền root (cài vào một prefix với Node riêng)
  • https://openclaw.ai/install.ps1 — Windows PowerShell installer (npm mặc định; tùy chọn cài từ git)

Để xem các flag/hành vi hiện tại, chạy lệnh:

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

Trợ giúp cho Windows (PowerShell):

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

Nếu installer chạy xong nhưng lệnh openclaw không tìm thấy trong terminal mới, thường là do vấn đề PATH của Node/npm. Xem: Install.

install.sh (được khuyên dùng)

Script này làm gì (tổng quan):

  • Phát hiện hệ điều hành (macOS / Linux / WSL).
  • Đảm bảo Node.js 22+ (macOS qua Homebrew; Linux qua NodeSource).
  • Chọn phương thức cài đặt:
    • npm (mặc định): npm install -g openclaw@latest
    • git: clone/build từ source checkout và cài wrapper script
  • Trên Linux: tránh lỗi quyền npm global bằng cách chuyển prefix của npm sang ~/.npm-global khi cần.
  • Nếu đang nâng cấp bản cài sẵn có: chạy openclaw doctor --non-interactive (cố gắng hết sức).
  • Với cài đặt git: chạy openclaw doctor --non-interactive sau khi cài/cập nhật (cố gắng hết sức).
  • Giảm thiểu các vấn đề cài đặt native của sharp bằng cách mặc định SHARP_IGNORE_GLOBAL_LIBVIPS=1 (tránh build với system libvips).

Nếu các bạn muốn sharp link với libvips đã cài global (hoặc đang debug), set:

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

Khả năng phát hiện / prompt “git install”

Nếu các bạn chạy installer khi đang ở trong OpenClaw source checkout (phát hiện qua package.json + pnpm-workspace.yaml), nó sẽ hỏi:

  • cập nhật và dùng checkout này (git)
  • hoặc chuyển sang cài npm global (npm)

Trong các ngữ cảnh không tương tác (không có TTY / --no-prompt), các bạn phải truyền --install-method git|npm (hoặc set OPENCLAW_INSTALL_METHOD), nếu không script sẽ thoát với code 2.

Tại sao cần Git

Git là bắt buộc cho đường dẫn --install-method git (clone / pull).

Với cài đặt npm, Git thường không bắt buộc, nhưng một số môi trường vẫn cần nó (ví dụ khi một package hoặc dependency được fetch qua git URL). Installer hiện tại đảm bảo Git có mặt để tránh lỗi spawn git ENOENT trên các distro mới.

Tại sao npm gặp lỗi EACCES trên Linux mới

Trên một số cài đặt Linux (đặc biệt sau khi cài Node qua system package manager hoặc NodeSource), prefix global của npm trỏ đến vị trí thuộc sở hữu root. Khi đó npm install -g ... sẽ thất bại với lỗi quyền EACCES / mkdir.

install.sh giảm thiểu vấn đề này bằng cách chuyển prefix sang:

  • ~/.npm-global (và thêm nó vào PATH trong ~/.bashrc / ~/.zshrc khi có)

install-cli.sh (CLI installer không cần root)

Script này cài openclaw vào một prefix (mặc định: ~/.openclaw) và cũng cài một Node runtime riêng dưới prefix đó, để có thể hoạt động trên các máy mà các bạn không muốn động vào Node/npm hệ thống.

Trợ giúp:

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

install.ps1 (Windows PowerShell)

Script này làm gì (tổng quan):

  • Đảm bảo Node.js 22+ (winget/Chocolatey/Scoop hoặc thủ công).
  • Chọn phương thức cài đặt:
    • npm (mặc định): npm install -g openclaw@latest
    • git: clone/build từ source checkout và cài wrapper script
  • Chạy openclaw doctor --non-interactive khi nâng cấp và cài git (cố gắng hết sức).

Ví dụ:

iwr -useb https://openclaw.ai/install.ps1 | iex
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\\openclaw"

Biến môi trường:

  • OPENCLAW_INSTALL_METHOD=git|npm
  • OPENCLAW_GIT_DIR=...

Yêu cầu Git:

Nếu các bạn chọn -InstallMethod git mà thiếu Git, installer sẽ in link Git for Windows (https://git-scm.com/download/win) và thoát.

Các vấn đề thường gặp trên Windows:

  • npm error spawn git / ENOENT: cài Git for Windows và mở lại PowerShell, sau đó chạy lại installer.
  • “openclaw” is not recognized: thư mục npm global bin không có trong PATH. Hầu hết hệ thống dùng %AppData%\\npm. Các bạn cũng có thể chạy npm config get prefix và thêm \\bin vào PATH, sau đó mở lại PowerShell.