Hướng dẫn cài đặt

Chạy ZeroClaw

Một binary Rust duy nhất, nhiều cách cài. Chọn cách phù hợp với bạn.

checklist Yêu cầu hệ thống

build Rust

Rust toolchain (stable) qua rustup.rs — chỉ cần cho build từ mã nguồn

computer OS

Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)

memory RAM

Runtime: <5MB RAM. Build từ mã nguồn: 2GB+ RAM, khuyến nghị 4GB

hard_drive Disk

Binary: ~8.8MB. Build từ mã nguồn: 6GB ổ đĩa trống, khuyến nghị 10GB

extension Optional

Tùy chọn: Docker (cho runtime sandbox), Git (cho build từ mã nguồn)

wifi Network

Internet cho gọi AI API. Model local qua Ollama hoạt động hoàn toàn offline.

Script một dòng xử lý mọi thứ. Khuyến nghị cho hầu hết người dùng.

bolt

Remote One-Liner

macOS / Linux. Single command.

$ curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
rocket_launch

Local Bootstrap

Clone first, then bootstrap. More options.

$ git clone https://github.com/zeroclaw-labs/zeroclaw.git
$ cd zeroclaw && ./bootstrap.sh
$ # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust
$ # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

verified Xác minh cài đặt

Chạy các lệnh này để xác nhận ZeroClaw đã cài đúng.

1
$ zeroclaw --version

Sẽ in phiên bản đã cài. Chạy trong ~0.02s với ~3.9MB RAM đỉnh.

2
$ zeroclaw doctor

Chạy chẩn đoán hệ thống: phiên bản Rust, file cấu hình, kết nối provider, sức khỏe kênh.

3
$ zeroclaw onboard --interactive

Trình hướng dẫn thiết lập tương tác cho API key, chọn provider và cấu hình kênh.

settings Cấu hình ban đầu

Sau khi cài đặt, trình hướng dẫn onboard sẽ dẫn bạn qua thiết lập. Đây là chức năng từng bước.

1

Chọn nhà cung cấp AI

Chọn từ danh mục provider: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ model), hoặc bất kỳ endpoint tương thích OpenAI bao gồm Ollama cho model local.

2

Thêm API Key

Dán API key. Key được lưu local trong config.toml — không bao giờ gửi đi đâu ngoài nhà cung cấp AI. Xác thực subscription (OpenAI Codex, Anthropic) cũng được hỗ trợ với profile mã hóa.

3

Kết nối kênh

Liên kết Telegram (dán bot token), Discord (dán bot token), Slack (workspace app), WhatsApp (mã QR), hoặc bất kỳ kênh nào trong 17+ kênh hỗ trợ. Chính sách allowlist deny-by-default.

4

Khởi động Agent

Chạy 'zeroclaw agent -m "Hello!"' để test nhanh, 'zeroclaw daemon' cho runtime tự trị đầy đủ, hoặc 'zeroclaw service install' cho dịch vụ nền.

.env — Mọi cấu hình được lưu trong ~/.zeroclaw/config.toml. Chỉnh sửa trực tiếp để thay đổi provider, kênh, memory backend, tunnel và cài đặt bảo mật. Xem docs/reference/README.md để tham chiếu đầy đủ.

system_update_alt Nâng cấp ZeroClaw

Giữ ZeroClaw cập nhật để nhận tính năng, tích hợp và bản vá bảo mật mới nhất.

Homebrew
$ brew upgrade zeroclaw
Cargo
$ cargo install zeroclaw --force
Git
$ cd zeroclaw && git pull && cargo build --release --locked
Docker
$ ./bootstrap.sh --docker --skip-build

Xem changelog tại github.com/zeroclaw-labs/zeroclaw/releases để biết có gì mới trong mỗi phiên bản.

build Khắc phục sự cố

Các vấn đề thường gặp và cách sửa.

Cần trợ giúp?

Tham gia cộng đồng để được hỗ trợ cài đặt và khắc phục sự cố.

forum Tham gia Telegram menu_book Đọc tài liệu
hub Tích hợp • article Blog • menu_book Tài liệu
❯

Theo dõi tin mới

Nhận cập nhật về bản phát hành mới, tích hợp và hạ tầng agent chạy bằng Rust. Không spam, hủy đăng ký bất cứ lúc nào.