Nội bộ trình cài đặt¶
OpenClaw cung cấp ba script cài đặt, được phân phối từ openclaw.ai.
| Tập lệnh | Nền tảng | Chức năng |
|---|---|---|
install.sh |
macOS / Linux / WSL | Cài Node nếu cần, cài OpenClaw qua npm (mặc định) hoặc git, và có thể chạy onboarding. |
install-cli.sh |
macOS / Linux / WSL | Cài đặt Node + OpenClaw vào một tiền tố cục bộ (~/.openclaw). Không cần quyền root. |
install.ps1 |
Windows (PowerShell) | Cài Node nếu cần, cài OpenClaw qua npm (mặc định) hoặc git, và có thể chạy onboarding. |
Lệnh nhanh¶
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
```
````
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
```
````
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
````
```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun
```
````
openclaw không được tìm thấy trong terminal mới, hãy xem Xử lý sự cố Node.js.
install.sh¶
Luồng (install.sh)¶
--method If macOS is detected, installs Homebrew if missing.
npm (mặc định): cài npm toàn cục
- Phương thức git: clone/cập nhật repo, cài phụ thuộc bằng pnpm, build, rồi cài wrapper tại ~/.local/bin/openclaw
openclaw doctor --non-interactive khi nâng cấp và cài bằng git (cố gắng hết mức)
- Thử chạy onboarding khi phù hợp (có TTY, onboarding không bị tắt, và các kiểm tra bootstrap/cấu hình đạt)
- Mặc định SHARP_IGNORE_GLOBAL_LIBVIPS=1
Phát hiện source checkout¶
Nếu chạy bên trong một checkout OpenClaw (package.json + pnpm-workspace.yaml), script sẽ đề nghị:
- dùng checkout (
git), hoặc - dùng cài đặt toàn cục (
npm)
Nếu không có TTY và không đặt phương thức cài, mặc định sẽ là npm và hiển thị cảnh báo.
Script thoát với mã 2 khi chọn phương thức không hợp lệ hoặc giá trị --install-method không hợp lệ.
Ví dụ (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
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
| Flag | Mô tả |
|---|---|
--install-method npm\\|git |
Choose install method (default: npm). Ứng dụng macOS kiểm tra phiên bản gateway so với phiên bản của chính nó. |
--npm |
Lối tắt cho phương thức npm |
--git |
Lối tắt cho phương thức git. Alias: --github |
--version <version\\|dist-tag> |
Phiên bản npm hoặc dist-tag (mặc định: latest) |
--beta |
Dùng dist-tag beta nếu có, nếu không thì quay về latest |
--git-dir <path> |
Checkout directory (default: ~/openclaw). Alias: --dir |
--no-git-update |
Bỏ qua git pull cho checkout hiện có |
--no-prompt |
Tắt lời nhắc |
--no-onboard |
Bỏ qua onboarding |
--onboard |
Bật onboarding |
--dry-run |
In các hành động mà không áp dụng thay đổi |
--verbose |
Bật đầu ra debug (set -x, log npm mức notice) |
--help |
Hiển thị cách dùng (-h) |
| Variable | Mô tả |
|---|---|
OPENCLAW_INSTALL_METHOD=git\\|npm |
Phương thức cài |
OPENCLAW_VERSION=latest\\|next\\|<semver> |
Phiên bản npm hoặc dist-tag |
OPENCLAW_BETA=0\\|1 |
Dùng beta nếu có |
OPENCLAW_GIT_DIR=<path> |
Thư mục checkout |
OPENCLAW_GIT_UPDATE=0\\|1 |
Bật/tắt cập nhật git |
OPENCLAW_NO_PROMPT=1 |
Tắt lời nhắc |
OPENCLAW_NO_ONBOARD=1 |
Bỏ qua onboarding |
OPENCLAW_DRY_RUN=1 |
Chế độ chạy thử |
OPENCLAW_VERBOSE=1 |
Chế độ debug |
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice |
Mức log npm |
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1 |
Điều khiển hành vi sharp/libvips (mặc định: 1) |
install-cli.sh¶
~/.openclaw) và không phụ thuộc Node hệ thống.
Luồng (install-cli.sh)¶
22.22.0) vào <prefix>/tools/node-v<version> và xác minh SHA-256.
--prefix <prefix>, sau đó ghi wrapper vào <prefix>/bin/openclaw.
Ví dụ (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
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
| Flag | Mô tả |
|---|---|
--prefix <path> |
Prefix cài đặt (mặc định: ~/.openclaw) |
--version <ver> |
Phiên bản OpenClaw hoặc dist-tag (mặc định: latest) |
--node-version <ver> |
Phiên bản Node (mặc định: 22.22.0) |
--json |
Phát sự kiện NDJSON |
--onboard |
Chạy openclaw onboard sau khi cài |
--no-onboard |
Bỏ qua onboarding (mặc định) |
--set-npm-prefix |
Trên Linux, ép prefix npm sang ~/.npm-global nếu prefix hiện tại không ghi được |
--help |
Hiển thị cách dùng (-h) |
| Variable | Mô tả |
|---|---|
OPENCLAW_PREFIX=<path> |
Prefix cài đặt |
OPENCLAW_VERSION=<ver> |
Phiên bản OpenClaw hoặc dist-tag |
OPENCLAW_NODE_VERSION=<ver> |
Phiên bản Node |
OPENCLAW_NO_ONBOARD=1 |
Bỏ qua onboarding |
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice |
Mức log npm |
OPENCLAW_GIT_DIR=<path> |
Đường dẫn tra cứu dọn dẹp legacy (dùng khi gỡ checkout submodule Peekaboo cũ) |
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1 |
Điều khiển hành vi sharp/libvips (mặc định: 1) |
install.ps1¶
Luồng (install.ps1)¶
npm (mặc định): cài npm toàn cục bằng -Tag đã chọn
- Phương thức git: clone/cập nhật repo, cài/build với pnpm, và cài wrapper tại %USERPROFILE%\.local\bin\openclaw.cmd
openclaw doctor --non-interactive khi nâng cấp và cài bằng git (cố gắng hết mức).
Ví dụ (install.ps1)¶
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod 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
| Flag | Mô tả |
|---|---|
-InstallMethod npm\\|git |
Phương thức cài (mặc định: npm) |
-Tag <tag> |
dist-tag npm (mặc định: latest) |
-GitDir <path> |
Thư mục checkout (mặc định: %USERPROFILE%\openclaw) |
-NoOnboard |
Bỏ qua onboarding |
-NoGitUpdate |
Bỏ qua git pull |
-DryRun |
Chỉ in các hành động |
| Variable | Mô tả |
|---|---|
OPENCLAW_INSTALL_METHOD=git\\|npm |
Phương thức cài |
OPENCLAW_GIT_DIR=<path> |
Thư mục checkout |
OPENCLAW_NO_ONBOARD=1 |
Bỏ qua onboarding |
OPENCLAW_GIT_UPDATE=0 |
Tắt git pull |
OPENCLAW_DRY_RUN=1 |
Chế độ chạy thử |
-InstallMethod git và thiếu Git, script sẽ thoát và in liên kết Git for Windows.
CI và tự động hóa¶
Dùng các cờ/biến môi trường không tương tác để chạy ổn định, dự đoán được.
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
bash
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Xử lý sự cố¶
git install method. For npm installs, Git is still checked/installed to avoid spawn git ENOENT failures when dependencies use git URLs.
install.sh có thể chuyển prefix sang ~/.npm-global và thêm các lệnh export PATH vào các file rc của shell (khi các file đó tồn tại).
SHARP_IGNORE_GLOBAL_LIBVIPS=1 để tránh việc sharp build dựa trên libvips của hệ thống. To override:
````
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```
````
npm config get prefix, thêm \bin, thêm thư mục đó vào PATH người dùng, rồi mở lại PowerShell.