Skip to content

README.tl.md

Latest commit

 

History

History
914 lines (666 loc) · 42.8 KB

README.tl.md

File metadata and controls

914 lines (666 loc) · 42.8 KB

ZeroClaw

ZeroClaw 🦀

Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.
⚡️ Tumatakbo sa $10 hardware na may <5MB RAM: Ito ay 99% mas kaunting memorya kaysa sa OpenClaw at 98% mas mura kaysa sa isang Mac mini!

License: MIT OR Apache-2.0 Contributors Buy Me a Coffee X: @zeroclawlabs WeChat Group Xiaohongshu: Official Telegram: @zeroclawlabs Facebook Group Reddit: r/zeroclawlabs

Binuo ng mga mag-aaral at miyembro ng Harvard, MIT, at Sundai.Club na komunidad.

🌐 Mga Wika:🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

Mabilis na Pagsisimula | One-Click na Setup | Hub ng Dokumentasyon | Talaan ng Nilalaman

Mga mabilis na access: Reference · Operations · Troubleshooting · Security · Hardware · Mag-contribute

Mabilis, magaan, at ganap na autonomous na AI assistant infrastructure
I-deploy kahit saan. I-swap ang anumang bagay.

Ang ZeroClaw ay ang runtime operating system para sa agent workflows — isang infrastructure na nag-a-abstract ng mga modelo, tools, memory, at execution upang bumuo ng mga agent nang isang beses at patakbuhin ang mga ito kahit saan.

Trait-driven architecture · secure-by-default runtime · swappable provider/channel/tool · lahat ay pluggable

📢 Mga Anunsyo

Gamitin ang talahanayang ito para sa mahahalagang paunawa (compatibility changes, security notices, maintenance windows, at version blocks).

Petsa (UTC) Antas Paunawa Aksyon
2026-02-19 Kritikal Hindi kami kaugnay sa openagen/zeroclaw o zeroclaw.org. Ang domain na zeroclaw.org ay kasalukuyang tumuturo sa fork na openagen/zeroclaw, at ang domain/repository na ito ay nanggagaya sa aming opisyal na website/proyekto. Huwag magtiwala sa impormasyon, binaries, fundraising, o mga anunsyo mula sa mga pinagmulang ito. Gamitin lamang ang repository na ito at aming mga verified social media accounts.
2026-02-21 Mahalaga Ang aming opisyal na website ay ngayon online: zeroclawlabs.ai. Salamat sa iyong pasensya sa panahon ng paghihintay. Nakikita pa rin namin ang mga pagtatangka ng panliliko: huwag lumahok sa anumang investment/funding activity sa ngalan ng ZeroClaw kung hindi ito nai-publish sa pamamagitan ng aming mga opisyal na channel. Gamitin ang repository na ito bilang nag-iisang source of truth. Sundan X (@zeroclawlabs), Telegram (@zeroclawlabs), Facebook (grupo), Reddit (r/zeroclawlabs), at Xiaohongshu para sa mga opisyal na update.
2026-02-19 Mahalaga In-update ng Anthropic ang authentication at credential use terms noong 2026-02-19. Ang OAuth authentication (Free, Pro, Max) ay eksklusibo para sa Claude Code at Claude.ai; ang paggamit ng Claude Free/Pro/Max OAuth tokens sa anumang iba pang produkto, tool, o serbisyo (kasama ang Agent SDK) ay hindi pinapayagan at maaaring lumabag sa Consumer Terms of Use. Mangyaring pansamantalang iwasan ang Claude Code OAuth integrations upang maiwasan ang anumang potensyal na pagkawala. Orihinal na clause: Authentication and Credential Use.

✨ Mga Tampok

  • 🏎️ Lightweight Runtime by Default: Ang mga karaniwang CLI workflows at status commands ay tumatakbo sa loob ng ilang megabytes ng memory footprint sa production builds.
  • 💰 Cost-Effective Deployment: Dinisenyo para sa low-cost boards at maliliit na cloud instances nang walang mga heavy runtime dependencies.
  • ⚡ Fast Cold Starts: Ang single-binary Rust runtime ay nagpapanatili ng command at daemon startup na halos instant para sa pang-araw-araw na operasyon.
  • 🌍 Portable Architecture: Isang single-binary workflow sa ARM, x86, at RISC-V na may swappable na provider/channel/tool.

Bakit pinipili ng mga team ang ZeroClaw

  • Lightweight by default: maliit na Rust binary, mabilis na startup, mababang memory footprint.
  • Secure by design: pairing, strict sandboxing, explicit allowlists, workspace scope.
  • Fully swappable: ang core systems ay traits (providers, channels, tools, memory, tunnels).
  • No vendor lock-in: OpenAI-compatible provider support + pluggable custom endpoints.

Benchmark Snapshot (ZeroClaw vs OpenClaw, Reproducible)

Mabilis na benchmark sa lokal na machine (macOS arm64, Peb. 2026) na normalized para sa 0.8 GHz edge hardware.

OpenClaw NanoBot PicoClaw ZeroClaw 🦀
Wika TypeScript Python Go Rust
RAM > 1 GB > 100 MB < 10 MB < 5 MB
Startup (0.8 GHz core) > 500s > 30s < 1s < 10ms
Binary Size ~28 MB (dist) N/A (Scripts) ~8 MB 3.4 MB
Gastos Mac Mini $599 Linux SBC ~$50 Linux board $10 Kahit anong hardware $10

Mga Tala: Ang mga resulta ng ZeroClaw ay sinusukat sa production builds gamit ang /usr/bin/time -l. Ang OpenClaw ay nangangailangan ng Node.js runtime (typically ~390 MB additional memory overhead), habang ang NanoBot ay nangangailangan ng Python runtime. Ang PicoClaw at ZeroClaw ay static binaries. Ang mga RAM figure sa itaas ay runtime memory; ang build-time compilation requirements ay mas mataas.

ZeroClaw vs OpenClaw Comparison

Reproducible Local Measurement

Ang mga benchmark claim ay maaaring mag-drift habang ang code at toolchains ay nag-e-evolve, kaya palaging sukatin ang iyong current build locally:

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

Halimbawa ng sample (macOS arm64, nasukat noong Pebrero 18, 2026):

  • Release binary size: 8.8M
  • zeroclaw --help: real time na humigit-kumulang 0.02s, peak memory footprint ~3.9 MB
  • zeroclaw status: real time na humigit-kumulang 0.01s, peak memory footprint ~4.1 MB

Mga Kinakailangan

Windows

Windows — Kinakailangan

  1. Visual Studio Build Tools (nagbibigay ng MSVC linker at Windows SDK):

    winget install Microsoft.VisualStudio.2022.BuildTools

    Sa panahon ng installation (o sa pamamagitan ng Visual Studio Installer), piliin ang "Desktop development with C++" workload.

  2. Rust Toolchain:

    winget install Rustlang.Rustup

    Pagkatapos ng installation, magbukas ng bagong terminal at patakbuhin ang rustup default stable upang matiyak na ang stable toolchain ay aktibo.

  3. I-verify na ang pareho ay gumagana:

    rustc --version
cargo --version

Windows — Opsyonal

  • Docker Desktop — kinakailangan lamang kung gagamit ka ng Docker sandboxed runtime (runtime.kind = "docker"). I-install sa pamamagitan ng winget install Docker.DockerDesktop.
Linux / macOS

Linux / macOS — Kinakailangan

  1. Essential build tools:

    • Linux (Debian/Ubuntu): sudo apt install build-essential pkg-config
    • Linux (Fedora/RHEL): sudo dnf group install development-tools && sudo dnf install pkg-config
    • macOS: I-install ang Xcode Command Line Tools: xcode-select --install

  2. Rust Toolchain:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

    Tingnan ang rustup.rs para sa mga detalye.

  3. I-verify:

    rustc --version
cargo --version

Linux / macOS — Opsyonal

Mabilis na Pagsisimula

Option 1: Automated setup (inirerekomenda)

Ang bootstrap.sh script ay nag-i-install ng Rust, nagi-clone ng ZeroClaw, nagi-compile, at nagse-set up ng iyong paunang development environment:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/bootstrap.sh | bash

Ito ay:

  1. Mag-i-install ng Rust (kung wala)
  2. Magi-clone ng ZeroClaw repository
  3. Magi-compile ng ZeroClaw sa release mode
  4. Mag-i-install ng zeroclaw sa ~/.cargo/bin/
  5. Gagawa ng default workspace structure sa ~/.zeroclaw/workspace/
  6. Gagawa ng paunang configuration file na ~/.zeroclaw/workspace/config.toml

Pagkatapos ng bootstrap, i-reload ang iyong shell o patakbuhin ang source ~/.cargo/env para gamitin ang zeroclaw command globally.

Option 2: Manual installation

I-click para makita ang mga manual installation steps 
# 1. I-clone ang repository
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 2. I-compile sa release
cargo build --release --locked

# 3. I-install ang binary
cargo install --path . --locked

# 4. I-initialize ang workspace
zeroclaw init

# 5. I-verify ang installation
zeroclaw --version
zeroclaw status

Pagkatapos ng Installation

Kapag na-install (sa pamamagitan ng bootstrap o manual), dapat mong makita:

~/.zeroclaw/workspace/
├── config.toml          # Main configuration
├── .pairing             # Pairing secrets (generated on first launch)
├── logs/                # Daemon/agent logs
├── skills/              # Custom skills
└── memory/              # Conversation context storage

Mga susunod na hakbang:

  1. I-configure ang iyong AI providers sa ~/.zeroclaw/workspace/config.toml
  2. Tingnan ang configuration reference para sa advanced options
  3. Simulan ang agent: zeroclaw agent start
  4. I-test sa pamamagitan ng iyong preferred channel (tingnan ang channels reference)

Configuration

I-edit ang ~/.zeroclaw/workspace/config.toml para i-configure ang providers, channels, at system behavior.

Quick Configuration Reference

[providers.anthropic]
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
api_key = "sk-..."
model = "gpt-4o"

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

[memory]
kind = "markdown"  # o "sqlite" o "none"

[runtime]
kind = "native"    # o "docker" (nangangailangan ng Docker)

Mga kumpletong reference document:

Current Runtime Support

Sinusuportahan ng ZeroClaw ang dalawang code execution backends:

  • native (default) — direct process execution, pinakamabilis na path, ideal para sa trusted environments
  • docker — full container isolation, hardened security policies, nangangailangan ng Docker

Gamitin ang runtime.kind = "docker" kung kailangan mo ng strict sandboxing o network isolation. Tingnan ang configuration reference para sa buong detalye.

Mga Command

# Workspace management
zeroclaw init                # Nag-initialize ng bagong workspace
zeroclaw status              # Nagpapakita ng daemon/agent status
zeroclaw config validate     # Nag-verify ng config.toml syntax at values

# Daemon management
zeroclaw daemon start        # Nagse-start ng daemon sa background
zeroclaw daemon stop         # Naghihinto sa running daemon
zeroclaw daemon restart      # Nagre-restart ng daemon (config reload)
zeroclaw daemon logs         # Nagpapakita ng daemon logs

# Agent management
zeroclaw agent start         # Nagse-start ng agent (nangangailangan ng running daemon)
zeroclaw agent stop          # Naghihinto sa agent
zeroclaw agent restart       # Nagre-restart ng agent (config reload)

# Pairing operations
zeroclaw pairing init        # Nag-generate ng bagong pairing secret
zeroclaw pairing rotate      # Nag-rotate ng existing pairing secret

# Tunneling (para sa public exposure)
zeroclaw tunnel start        # Nagse-start ng tunnel sa local daemon
zeroclaw tunnel stop         # Naghihinto sa active tunnel

# Diagnostics
zeroclaw doctor              # Nagpapatakbo ng system health checks
zeroclaw version             # Nagpapakita ng version at build info

Tingnan ang Commands Reference para sa buong options at examples.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        Channels (trait)                         │
│  Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Agent Orchestrator                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Message    │  │   Context    │  │    Tool      │          │
│  │   Routing    │  │   Memory     │  │  Execution   │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│   Providers  │  │   Memory     │  │    Tools     │
│   (trait)    │  │   (trait)    │  │   (trait)    │
├──────────────┤  ├──────────────┤  ├──────────────┤
│  Anthropic   │  │   Markdown   │  │  Filesystem  │
│   OpenAI     │  │    SQLite    │  │     Bash     │
│   Gemini     │  │     None     │  │   Web Fetch  │
│   Ollama     │  │    Custom    │  │   Custom     │
│   Custom     │  └──────────────┘  └──────────────┘
└──────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────┐
│                   Runtime (trait)                               │
│                  Native │ Docker                                │
└─────────────────────────────────────────────────────────────────┘

Mga pangunahing prinsipyo:

  • Ang lahat ay isang trait — providers, channels, tools, memory, tunnels
  • Ang mga channel ay tumatawag sa orchestrator; ang orchestrator ay tumatawag sa providers + tools
  • Ang memory system ay nagmamaneho ng conversation context (markdown, SQLite, o none)
  • Ang runtime ay nag-a-abstract ng code execution (native o Docker)
  • Walang provider lock-in — i-swap ang Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama nang walang code changes

Tingnan ang architecture documentation para sa mga detalyadong diagram at implementation details.

Mga Halimbawa

Telegram Bot

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."
allowed_users = [987654321]  # Ang iyong Telegram user ID

Simulan ang daemon + agent, pagkatapos ay magpadala ng mensahe sa iyong bot sa Telegram:

/start
Hello! Could you help me write a Python script?

Ang bot ay tumutugon gamit ang AI-generated code, nagpapatupad ng mga tool kung hiniling, at nagpapanatili ng conversation context.

Matrix (end-to-end encryption)

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@zeroclaw:matrix.org"
password = "..."
device_name = "zeroclaw-prod"
e2ee_enabled = true

Imbitahan ang @zeroclaw:matrix.org sa isang encrypted room, at ang bot ay tutugon gamit ang full encryption. Tingnan ang Matrix E2EE Guide para sa device verification setup.

Multi-Provider

[providers.anthropic]
enabled = true
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
enabled = true
api_key = "sk-..."
model = "gpt-4o"

[orchestrator]
default_provider = "anthropic"
fallback_providers = ["openai"]  # Failover on provider error

Kung ang Anthropic ay mabigo o ma-rate-limit, ang orchestrator ay awtomatikong mag-failover sa OpenAI.

Custom Memory

[memory]
kind = "sqlite"
path = "~/.zeroclaw/workspace/memory/conversations.db"
retention_days = 90  # Automatic purge after 90 days

O gamitin ang Markdown para sa human-readable storage:

[memory]
kind = "markdown"
path = "~/.zeroclaw/workspace/memory/"

Tingnan ang Configuration Reference para sa lahat ng memory options.

Provider Support

Provider Status API Key Example Models
Anthropic ✅ Stable ANTHROPIC_API_KEY claude-sonnet-4-20250514, claude-opus-4-20250514
OpenAI ✅ Stable OPENAI_API_KEY gpt-4o, gpt-4o-mini, o1, o1-mini
Google Gemini ✅ Stable GOOGLE_API_KEY gemini-2.0-flash-exp, gemini-exp-1206
Ollama ✅ Stable N/A (local) llama3.3, qwen2.5, phi4
Cerebras ✅ Stable CEREBRAS_API_KEY llama-3.3-70b
Groq ✅ Stable GROQ_API_KEY llama-3.3-70b-versatile
Mistral 🚧 Planned MISTRAL_API_KEY TBD
Cohere 🚧 Planned COHERE_API_KEY TBD

Custom Endpoints

Sinusuportahan ng ZeroClaw ang OpenAI-compatible endpoints:

[providers.custom]
enabled = true
api_key = "..."
base_url = "https://api.your-llm-provider.com/v1"
model = "your-model-name"

Halimbawa: gamitin ang LiteLLM bilang proxy para ma-access ang anumang LLM sa pamamagitan ng OpenAI interface.

Tingnan ang Providers Reference para sa kumpletong configuration details.

Channel Support

Channel Status Authentication Notes
Telegram ✅ Stable Bot Token Full support including files, images, inline buttons
Matrix ✅ Stable Password or Token E2EE support with device verification
Slack 🚧 Planned OAuth or Bot Token Requires workspace access
Discord 🚧 Planned Bot Token Requires guild permissions
WhatsApp 🚧 Planned Twilio or official API Requires business account
CLI ✅ Stable None Direct conversational interface
Web 🚧 Planned API Key or OAuth Browser-based chat interface

Tingnan ang Channels Reference para sa kumpletong configuration instructions.

Tool Support

Nagbibigay ang ZeroClaw ng built-in tools para sa code execution, filesystem access, at web retrieval:

Tool Description Required Runtime
bash Executes shell commands Native or Docker
python Executes Python scripts Python 3.8+ (native) or Docker
javascript Executes Node.js code Node.js 18+ (native) or Docker
filesystem_read Reads files Native or Docker
filesystem_write Writes files Native or Docker
web_fetch Fetches web content Native or Docker

Execution Security

  • Native Runtime — runs as daemon's user process, full filesystem access
  • Docker Runtime — full container isolation, separate filesystems and networks

I-configure ang execution policy sa config.toml:

[runtime]
kind = "docker"
allowed_tools = ["bash", "python", "filesystem_read"]  # Explicit allowlist

Tingnan ang Configuration Reference para sa kumpletong security options.

Deployment

Local Deployment (Development)

zeroclaw daemon start
zeroclaw agent start

Server Deployment (Production)

Gamitin ang systemd para mamaneho ang daemon at agent bilang services:

# I-install ang binary
cargo install --path . --locked

# I-configure ang workspace
zeroclaw init

# Gumawa ng systemd service files
sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/
sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/

# I-enable at i-start ang services
sudo systemctl enable zeroclaw-daemon zeroclaw-agent
sudo systemctl start zeroclaw-daemon zeroclaw-agent

# I-verify ang status
sudo systemctl status zeroclaw-daemon
sudo systemctl status zeroclaw-agent

Tingnan ang Network Deployment Guide para sa kumpletong production deployment instructions.

Docker

# I-build ang image
docker build -t zeroclaw:latest .

# I-run ang container
docker run -d \
  --name zeroclaw \
  -v ~/.zeroclaw/workspace:/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  zeroclaw:latest

Tingnan ang Dockerfile para sa build details at configuration options.

Edge Hardware

Ang ZeroClaw ay dinisenyo para tumakbo sa low-power hardware:

  • Raspberry Pi Zero 2 W — ~512 MB RAM, single ARMv8 core, < $5 hardware cost
  • Raspberry Pi 4/5 — 1 GB+ RAM, multi-core, ideal for concurrent workloads
  • Orange Pi Zero 2 — ~512 MB RAM, quad-core ARMv8, ultra-low cost
  • x86 SBCs (Intel N100) — 4-8 GB RAM, fast builds, native Docker support

Tingnan ang Hardware Guide para sa device-specific setup instructions.

Tunneling (Public Exposure)

I-expose ang iyong local ZeroClaw daemon sa public network sa pamamagitan ng secure tunnels:

zeroclaw tunnel start --provider cloudflare

Mga supported tunnel provider:

  • Cloudflare Tunnel — free HTTPS, no port exposure, multi-domain support
  • Ngrok — quick setup, custom domains (paid plan)
  • Tailscale — private mesh network, no public port

Tingnan ang Configuration Reference para sa kumpletong configuration options.

Security

Nagpapatupad ang ZeroClaw ng maraming layer ng security:

Pairing

Ang daemon ay nag-generate ng pairing secret sa unang launch na nakaimbak sa ~/.zeroclaw/workspace/.pairing. Ang mga client (agent, CLI) ay dapat mag-present ng secret na ito para kumonekta.

zeroclaw pairing rotate  # Gagawa ng bagong secret at i-invalidate ang dati

Sandboxing

  • Docker Runtime — full container isolation na may separate filesystems at networks
  • Native Runtime — runs as user process, scoped sa workspace by default

Allowlists

Ang mga channel ay maaaring mag-limit ng access by user ID:

[channels.telegram]
enabled = true
allowed_users = [123456789, 987654321]  # Explicit allowlist

Encryption

  • Matrix E2EE — full end-to-end encryption with device verification
  • TLS Transport — all API and tunnel traffic uses HTTPS/TLS

Tingnan ang Security Documentation para sa kumpletong policies at practices.

Observability

Ang ZeroClaw ay naglo-log sa ~/.zeroclaw/workspace/logs/ by default. Ang mga log ay nakaimbak by component:

~/.zeroclaw/workspace/logs/
├── daemon.log           # Daemon logs (startup, API requests, errors)
├── agent.log            # Agent logs (message routing, tool execution)
├── telegram.log         # Channel-specific logs (if enabled)
└── matrix.log           # Channel-specific logs (if enabled)

Logging Configuration

[logging]
level = "info"                           # debug, info, warn, error
path = "~/.zeroclaw/workspace/logs/"
rotation = "daily"                       # daily, hourly, size
max_size_mb = 100                        # For size-based rotation
retention_days = 30                      # Automatic purge after N days

Tingnan ang Configuration Reference para sa lahat ng logging options.

Metrics (Planned)

Prometheus metrics support para sa production monitoring ay coming soon. Tracking sa #234.

Skills

Sinusuportahan ng ZeroClaw ang custom skills — reusable modules na nag-e-extend sa system capabilities.

Skill Definition

Ang mga skill ay nakaimbak sa ~/.zeroclaw/workspace/skills/<skill-name>/ na may ganitong structure:

skills/
└── my-skill/
    ├── skill.toml       # Skill metadata (name, description, dependencies)
    ├── prompt.md        # System prompt for the AI
    └── tools/           # Optional custom tools
        └── my_tool.py

Skill Example

# skills/web-research/skill.toml
[skill]
name = "web-research"
description = "Searches the web and summarizes results"
version = "1.0.0"

[dependencies]
tools = ["web_fetch", "bash"]
<!-- skills/web-research/prompt.md -->

You are a research assistant. When asked to research something:

1. Use web_fetch to retrieve content
2. Summarize results in an easy-to-read format
3. Cite sources with URLs

Skill Usage

Ang mga skill ay automatically loaded sa agent startup. I-reference ang mga ito by name sa conversations:

User: Use the web-research skill to find the latest AI news
Bot: [loads web-research skill, executes web_fetch, summarizes results]

Tingnan ang Skills section para sa kumpletong skill creation instructions.

Open Skills

Sinusuportahan ng ZeroClaw ang Open Skills — isang modular at provider-agnostic system para sa pag-extend sa AI agent capabilities.

Enable Open Skills

[skills]
open_skills_enabled = true
# open_skills_dir = "/path/to/open-skills"  # optional

Maaari mo ring i-override sa runtime gamit ang ZEROCLAW_OPEN_SKILLS_ENABLED at ZEROCLAW_OPEN_SKILLS_DIR.

Development

cargo build              # Dev build
cargo build --release    # Release build (codegen-units=1, works on all devices including Raspberry Pi)
cargo build --profile release-fast    # Faster build (codegen-units=8, requires 16 GB+ RAM)
cargo test               # Run full test suite
cargo clippy --locked --all-targets -- -D clippy::correctness
cargo fmt                # Format

# Run SQLite vs Markdown comparison benchmark
cargo test --test memory_comparison -- --nocapture

Pre-push hook

Ang isang git hook ay nagpapatakbo ng cargo fmt --check, cargo clippy -- -D warnings, at cargo test bago ang bawat push. I-enable ito nang isang beses:

git config core.hooksPath .githooks

Build Troubleshooting (OpenSSL errors on Linux)

Kung makakita ka ng openssl-sys build error, i-sync ang dependencies at i-recompile gamit ang repository's lockfile:

git pull
cargo build --release --locked
cargo install --path . --force --locked

Ang ZeroClaw ay naka-configure na gumamit ng rustls para sa HTTP/TLS dependencies; ang --locked ay nagpapanatili sa transitive graph na deterministic sa clean environments.

Para i-skip ang hook kapag kailangan mo ng quick push habang nagde-develop:

git push --no-verify

Collaboration & Docs

Magsimula sa documentation hub para sa task-based map:

Mga pangunahing collaboration references:

Para sa deployment at runtime operations:

Suportahan ang ZeroClaw

Kung tinutulungan ng ZeroClaw ang iyong trabaho at nais mong suportahan ang patuloy na development, maaari kang mag-donate dito:

Bilhan Mo Ako ng Kape

🙏 Special Thanks

Isang taos-pusong pasasalamat sa mga komunidad at institusyon na nagbibigay-inspirasyon at nagpapakain sa open-source work na ito:

  • Harvard University — para sa pagpapaunlad ng intelektwal na kuryosidad at pagtulak sa mga hangganan ng kung ano ang posible.
  • MIT — para sa pagtatanggol ng open knowledge, open source, at ang paniniwala na ang teknolohiya ay dapat na accessible sa lahat.
  • Sundai Club — para sa komunidad, enerhiya, at ang walang-humpay na kagustuhang bumuo ng mga bagay na mahalaga.
  • Ang Mundo at Higit Pa 🌍✨ — sa bawat contributor, dreamer, at builder doon sa labas na gumagawa ng open source bilang isang puwersa para sa kabutihan. Ito ay para sa iyo.

Kami ay bumubuo sa open source dahil ang mga pinakamahusay na ideya ay nagmumula sa lahat ng dako. Kung binabasa mo ito, ikaw ay bahagi nito. Maligayang pagdating. 🦀❤️

⚠️ Official Repository at Impersonation Warning

Ito ang tanging opisyal na ZeroClaw repository:

https://github.com/zeroclaw-labs/zeroclaw

Ang anumang iba pang repository, organization, domain, o package na nagpapanggap na "ZeroClaw" o nagpapahiwatig ng affiliation sa ZeroClaw Labs ay hindi awtorisado at hindi kaugnay sa proyektong ito. Ang mga kilalang unauthorized forks ay ililista sa TRADEMARK.md.

Kung makakita ka ng impersonation o trademark misuse, mangyaring magbukas ng isyu.

License

Ang ZeroClaw ay dual-licensed para sa maximum openness at contributor protection:

License Use Cases
MIT Open-source, research, academic, personal use
Apache 2.0 Patent protection, institutional, commercial deployment

Maaari mong piliin ang alinmang license. Ang mga contributor ay awtomatikong nagbibigay ng rights sa ilalim ng pareho — tingnan ang CLA.md para sa kumpletong contributor agreement.

Trademark

Ang pangalang ZeroClaw at logo ay mga rehistradong trademark ng ZeroClaw Labs. Ang license na ito ay hindi nagbibigay ng pahintulot na gamitin ang mga ito upang ipahiwatig ang endorsement o affiliation. Tingnan ang TRADEMARK.md para sa mga allowed at prohibited uses.

Contributor Protections

  • Mo namang pinapanatili ang copyright ng iyong mga kontribusyon
  • Patent grant (Apache 2.0) ay nagpoprotekta sa iyo laban sa patent claims ng ibang mga contributor
  • Ang iyong mga kontribusyon ay permanenteng naa-attributed sa commit history at NOTICE
  • Walang trademark rights ang naililipat sa pamamagitan ng pagko-contribute

Mag-contribute

Tingnan ang CONTRIBUTING.md at CLA.md. Mag-implement ng isang trait, mag-submit ng PR:

  • CI workflow guide: docs/ci-map.md
  • Bagong Provider → src/providers/
  • Bagong Channel → src/channels/
  • Bagong Observer → src/observability/
  • Bagong Tool → src/tools/
  • Bagong Memory → src/memory/
  • Bagong Tunnel → src/tunnel/
  • Bagong Skill → ~/.zeroclaw/workspace/skills/<n>/

ZeroClaw — Zero overhead. Zero compromise. Deploy anywhere. Swap anything. 🦀

Star History

Star History Graph