5.2 KiB
| summary | read_when | ||
|---|---|---|---|
| Cài đặt Moltbot (bản cài đặt khuyên dùng, cài đặt global, hoặc từ mã nguồn) |
|
Cài đặt (Install)
Hãy sử dụng trình cài đặt (installer) trừ khi bạn có lý do cụ thể để làm khác. Nó sẽ thiết lập CLI và khởi chạy quá trình thiết lập ban đầu (onboarding).
Cài đặt nhanh (Khuyên dùng)
curl -fsSL https://molt.bot/install.sh | bash
Windows (PowerShell):
iwr -useb https://molt.bot/install.ps1 | iex
Bước tiếp theo (nếu bạn đã bỏ qua phần onboarding):
moltbot onboard --install-daemon
Yêu cầu hệ thống
- Node >=22
- macOS, Linux, hoặc Windows thông qua WSL2
pnpm(chỉ cần nếu bạn cài đặt từ mã nguồn)
Lựa chọn phương thức cài đặt
1) Kịch bản cài đặt (Khuyên dùng)
Tự động cài đặt moltbot global qua npm và chạy onboarding.
curl -fsSL https://molt.bot/install.sh | bash
Các cờ lệnh của trình cài đặt:
curl -fsSL https://molt.bot/install.sh | bash -s -- --help
Chi tiết: Cơ chế bên trong trình cài đặt.
Chế độ không tương tác (bỏ qua onboarding):
curl -fsSL https://molt.bot/install.sh | bash -s -- --no-onboard
2) Cài đặt Global (Thủ công)
Nếu bạn đã cài sẵn Node:
npm install -g moltbot@latest
Nếu bạn đã cài libvips trên toàn hệ thống (phổ biến trên macOS qua Homebrew) và việc cài đặt thư viện sharp gặp lỗi, hãy ép buộc sử dụng các tệp nhị phân build sẵn:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g moltbot@latest
Nếu gặp lỗi sharp: Please add node-gyp to your dependencies, hãy cài đặt các công cụ build (macOS: Xcode CLT + npm install -g node-gyp) hoặc dùng cách SHARP_IGNORE_GLOBAL_LIBVIPS=1 ở trên để bỏ qua bước build native.
Hoặc dùng pnpm:
pnpm add -g moltbot@latest
Sau đó:
moltbot onboard --install-daemon
3) Cài đặt từ mã nguồn (Dành cho Dev/Người đóng góp)
git clone https://github.com/moltbot/moltbot.git
cd moltbot
pnpm install
pnpm ui:build # tự động cài đặt deps cho UI ở lần chạy đầu tiên
pnpm build
moltbot onboard --install-daemon
Mẹo: nếu bạn chưa cài bản global, hãy chạy các lệnh trong repo qua pnpm moltbot ....
4) Các tùy chọn cài đặt khác
Sau khi cài đặt
- Chạy onboarding:
moltbot onboard --install-daemon - Kiểm tra nhanh:
moltbot doctor - Kiểm tra sức khỏe gateway:
moltbot status+moltbot health - Mở bảng điều khiển:
moltbot dashboard
Phương thức cài đặt: npm vs git (installer)
Trình cài đặt hỗ trợ hai phương thức:
npm(mặc định):npm install -g moltbot@latestgit: clone/build từ GitHub và chạy trực tiếp từ thư mục mã nguồn
Các cờ lệnh CLI
# Cài đặt qua npm rõ ràng
curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method npm
# Cài đặt từ GitHub (source checkout)
curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git
Các cờ lệnh phổ biến:
--install-method npm|git--git-dir <đường_dẫn>(mặc định:~/moltbot)--no-git-update(bỏ quagit pullkhi sử dụng thư mục đã có sẵn)--no-prompt(tắt các yêu cầu nhập liệu; cần thiết cho CI/tự động hóa)--dry-run(chỉ in ra những gì sẽ thực hiện; không thay đổi hệ thống)--no-onboard(bỏ qua thiết lập ban đầu)
Biến môi trường
Các biến môi trường tương đương (hữu ích cho tự động hóa):
CLAWDBOT_INSTALL_METHOD=git|npmCLAWDBOT_GIT_DIR=...CLAWDBOT_GIT_UPDATE=0|1CLAWDBOT_NO_PROMPT=1CLAWDBOT_DRY_RUN=1CLAWDBOT_NO_ONBOARD=1SHARP_IGNORE_GLOBAL_LIBVIPS=0|1(mặc định:1; để tránhsharpbuild bằng hệ thống libvips)
Khắc phục lỗi: Không tìm thấy lệnh moltbot (PATH)
Kiểm tra nhanh:
node -v
npm -v
npm prefix -g
echo "$PATH"
Nếu $(npm prefix -g)/bin (macOS/Linux) hoặc $(npm prefix -g) (Windows) không xuất hiện trong kết quả echo "$PATH", shell của bạn sẽ không tìm thấy các file thực thi global của npm (bao gồm cả moltbot).
Cách sửa: thêm nó vào file khởi động shell của bạn (zsh: ~/.zshrc, bash: ~/.bashrc):
# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"
Trên Windows, hãy thêm đầu ra của lệnh npm prefix -g vào biến môi trường PATH của hệ thống.
Sau đó mở một terminal mới (hoặc chạy rehash trong zsh / hash -r trong bash).