campaign Thông báo

info Giới thiệu

ZeroClaw là hạ tầng trợ lý AI tự trị nhanh, nhỏ, hoàn toàn tự động viết bằng Rust. Một binary tĩnh đơn chạy trên phần cứng $10 với <5MB RAM — ít hơn 99% bộ nhớ so với các giải pháp dựa trên Node. Mọi hệ thống con là trait: hoán đổi provider, kênh, công cụ, memory backend và tunnel bằng thay đổi cấu hình.

download Cài đặt

ZeroClaw phân phối dưới dạng binary Rust đơn. Cài qua Homebrew, script bootstrap hoặc build thủ công từ mã nguồn.

Homebrew (macOS / Linuxbrew)

# macOS / Linuxbrew
brew install zeroclaw

Bootstrap một click (Khuyến nghị)

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./bootstrap.sh

# With system deps + Rust install on fresh machines
./bootstrap.sh --install-system-deps --install-rust

# With onboarding in the same flow
./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

# Remote one-liner
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash

Build & cài thủ công

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

# Ensure ~/.cargo/bin is in PATH
export PATH="$HOME/.cargo/bin:$PATH"

Fallback dev: thêm tiền tố cargo run --release -- trước lệnh để bỏ qua cài global.

rocket_launch Bắt đầu nhanh

Chạy onboarding một lần để thiết lập cấu hình, sau đó bắt đầu chat.

# Interactive onboarding wizard
zeroclaw onboard --interactive

# Or quick setup (no prompts)
zeroclaw onboard --api-key sk-... --provider openrouter --model "openrouter/auto"

# Quickly repair channels/allowlists only
zeroclaw onboard --channels-only

# Chat with the agent
zeroclaw agent -m "Hello, ZeroClaw!"

# Interactive mode
zeroclaw agent

# Start gateway + daemon
zeroclaw gateway
zeroclaw daemon

# Check status
zeroclaw status
zeroclaw doctor
zeroclaw channel doctor

# Bind Telegram identity into allowlist
zeroclaw channel bind-telegram 123456789

# Service + migration helpers
zeroclaw service install
zeroclaw config schema
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

Vị trí cấu hình: ~/.zeroclaw/config.toml — được tạo tự động bởi zeroclaw onboard.

terminal Lệnh

ZeroClaw là binary đơn với subcommand cho mọi quy trình.

smart_toy Chế độ Agent

Lệnh zeroclaw agent chạy trợ lý AI có thể sử dụng công cụ, gọi lại bộ nhớ và thực thi tác vụ.

# Single message
zeroclaw agent -m "List files in the current directory"

# Interactive REPL
zeroclaw agent

# Use a specific provider/model
zeroclaw agent --provider anthropic --model claude-sonnet-4-6 -m "Hello"

# Use a subscription auth profile
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "Hello"

dns Gateway & Daemon

Gateway mở webhook server cho tích hợp kênh. Daemon chạy runtime tự trị đầy đủ bao gồm heartbeat, cron và kênh.

# Start the gateway (webhook server, default 127.0.0.1:3000)
zeroclaw gateway
zeroclaw gateway --port 0        # random port (security hardened)

# Start full autonomous runtime
zeroclaw daemon

# Manage as a background service
zeroclaw service install
zeroclaw service status

forum Kênh

Kênh cho phép ZeroClaw nhận và trả lời tin nhắn từ Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Email, IRC, Lark, DingTalk và nhiều hơn. Mọi kênh dùng allowlist deny-by-default.

# Telegram
[channels_config.telegram]
bot_token = "123456:ABC..."
allowed_users = ["your_username"]   # or ["*"] for all

# Discord
[channels_config.discord]
bot_token = "..."
allowed_users = ["your-discord-id"]

# Slack
[channels_config.slack]
bot_token = "xoxb-..."
allowed_users = ["UMEMBERID"]

# Start channels via daemon
zeroclaw daemon

Mẹo: Chạy zeroclaw onboard --channels-only để cấu hình lại kênh mà không ảnh hưởng cài đặt khác.

build Công cụ

Công cụ là khả năng agent có thể gọi trong hội thoại. Mọi công cụ tích hợp đều được sandbox và giới hạn workspace mặc định.

# Built-in tools:
# shell, file_read, file_write, memory, cron,
# git, http_request, browser (opt-in), composio (opt-in),
# delegate, hardware, screenshot, pushover

# Enable browser tools
[browser]
enabled = true
allowed_domains = ["docs.rs", "github.com"]

# Enable Composio (1000+ OAuth integrations)
[composio]
enabled = true
api_key = "cmp_..."

database Hệ thống bộ nhớ

Công cụ tìm kiếm full-stack không phụ thuộc bên ngoài — không Pinecone, không Elasticsearch, không LangChain.

[memory]
backend = "sqlite"             # sqlite | lucid | postgres | markdown | none
auto_save = true
embedding_provider = "none"    # none | openai | custom:https://...
vector_weight = 0.7
keyword_weight = 0.3

# PostgreSQL remote backend
# [storage.provider.config]
# provider = "postgres"
# db_url = "postgres://user:pass@host:5432/zeroclaw"

settings File cấu hình

Cấu hình nằm tại ~/.zeroclaw/config.toml — được tạo bởi zeroclaw onboard.

api_key = "sk-..."
default_provider = "openrouter"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

[memory]
backend = "sqlite"
auto_save = true

[gateway]
port = 3000
host = "127.0.0.1"
require_pairing = true
allow_public_bind = false

[autonomy]
level = "supervised"
workspace_only = true
allowed_commands = ["git", "npm", "cargo", "ls", "cat", "grep"]

[runtime]
kind = "native"

[tunnel]
provider = "none"

[secrets]
encrypt = true

model_training Nhà cung cấp AI

ZeroClaw hỗ trợ 28+ provider tích hợp cùng bất kỳ endpoint tùy chỉnh tương thích OpenAI hoặc Anthropic.

Chạy zeroclaw providers để liệt kê mọi provider và alias có sẵn.

key Biến môi trường

API key provider và override tùy chọn.

# Provider API keys
OPENROUTER_API_KEY=sk-or-v1-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# Lucid memory backend
ZEROCLAW_LUCID_CMD=/usr/local/bin/lucid
ZEROCLAW_LUCID_BUDGET=200

# Ollama remote endpoint
OLLAMA_API_KEY=your-key

shield Bảo mật

ZeroClaw thực thi bảo mật ở mọi tầng và đạt mọi mục từ checklist bảo mật cộng đồng.

[gateway]
require_pairing = true
allow_public_bind = false   # refuse 0.0.0.0 without tunnel

[autonomy]
workspace_only = true       # scoped to workspace by default

account_tree Kiến trúc

Mọi hệ thống con là Rust trait — hoán đổi triển khai bằng thay đổi cấu hình, không cần sửa code.

runtime.kind = "native" và "docker" được hỗ trợ hiện tại. Runtime WASM/edge đang được lên kế hoạch.

api Gateway API

HTTP API tối giản cho tích hợp kênh và kiểm tra sức khỏe.

# Health check (no auth required)
curl http://127.0.0.1:3000/health

# Exchange pairing code for bearer token
curl -X POST http://127.0.0.1:3000/pair \
  -H "X-Pairing-Code: 847291"

# Send a message (requires bearer token)
curl -X POST http://127.0.0.1:3000/webhook \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, ZeroClaw!"}'

lock Xác thực & Pairing

Profile xác thực subscription-native (đa tài khoản, mã hóa khi lưu trữ) cho OpenAI Codex và Anthropic.

# OpenAI Codex (device code — recommended for servers)
zeroclaw auth login --provider openai-codex --device-code

# Browser/callback flow
zeroclaw auth login --provider openai-codex --profile default

# Anthropic setup token
zeroclaw auth paste-token --provider anthropic --profile default

# Check / refresh / switch profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

code Phát triển

Quy trình Rust tiêu chuẩn. Git hook pre-push tự động chạy fmt + clippy + test.

# Dev build
cargo build

# Release build (works on all devices including Raspberry Pi)
cargo build --release

# Run tests
cargo test

# Lint
cargo clippy --locked --all-targets -- -D clippy::correctness

# Format
cargo fmt

# Enable pre-push hook (fmt + clippy + test)
git config core.hooksPath .githooks

menu_book Trung tâm tài liệu

Để xem tài liệu hướng dẫn theo tác vụ, bắt đầu từ trung tâm tài liệu trong repository chính thức.

brew install zeroclaw && zeroclaw onboard --interactive