README.tl.md

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!

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

🚀 What's New in v0.3.1 (March 2026)

Area	Highlights
ci	add Termux (aarch64-linux-android) release target

📢 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.

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

• Docker — kinakailangan lamang kung gagamit ka ng Docker sandboxed runtime (runtime.kind = "docker").
  • Linux (Debian/Ubuntu): tingnan ang docs.docker.com
  • Linux (Fedora/RHEL): tingnan ang docs.docker.com
  • macOS: i-install ang Docker Desktop sa pamamagitan ng docker.com/products/docker-desktop

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:

• Configuration Reference — lahat ng settings, validations, defaults
• Providers Reference — AI provider-specific configurations
• Channels Reference — Telegram, Matrix, Slack, Discord, at higit pa
• Operations — production monitoring, secret rotation, scaling

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.

Collaboration & Docs

Magsimula sa documentation hub para sa task-based map:

• Documentation Hub: docs/README.md
• Unified Docs TOC: docs/SUMMARY.md
• Commands Reference: docs/commands-reference.md
• Configuration Reference: docs/config-reference.md
• Providers Reference: docs/providers-reference.md
• Channels Reference: docs/channels-reference.md
• Operations Runbook: docs/operations-runbook.md
• Troubleshooting: docs/troubleshooting.md
• Docs Inventory/Classification: docs/docs-inventory.md
• PR/Issue Triage Snapshot (as of Feb 18, 2026): docs/project-triage-snapshot-2026-02-18.md

Mga pangunahing collaboration references:

• Documentation Hub: docs/README.md
• Documentation Template: docs/doc-template.md
• Documentation Change Checklist: docs/README.md#4-documentation-change-checklist
• Channel Configuration Reference: docs/channels-reference.md
• Matrix Encrypted Room Operations: docs/matrix-e2ee-guide.md
• Contributing Guide: CONTRIBUTING.md
• PR Workflow Policy: docs/pr-workflow.md
• Reviewer Playbook (triage + deep review): docs/reviewer-playbook.md
• Ownership and CI Triage Map: docs/ci-map.md
• Security Disclosure Policy: SECURITY.md

Para sa deployment at runtime operations:

• Network Deployment Guide: docs/network-deployment.md
• Proxy Agent Playbook: docs/proxy-agent-playbook.md

Suportahan ang ZeroClaw

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

🙏 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. 🦀❤️

🌟 Recent Contributors (v0.3.1)

3 contributors shipped features, fixes, and improvements in this release cycle:

• Argenis
• argenis de la rosa
• Claude Opus 4.6

Thank you to everyone who opened issues, reviewed PRs, translated docs, and helped test. Every contribution matters. 🦀

⚠️ 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