Fast, small, and fully autonomous AI personal assistant infrastructure, ANY OS, ANY PLATFORM — deploy anywhere, swap anything 🦀
Go to file
2026-03-03 23:23:11 +00:00
.cargo fix(windows): increase stack size to resolve runtime overflow 2026-03-03 15:09:58 +08:00
.gemini Add ZeroClaw Code Style Guide 2026-02-14 14:13:58 -05:00
.githooks docs(security): refine local secret management guidance 2026-02-17 18:39:13 +08:00
.github ci: allow hetzner/linux/x64 labels in actionlint 2026-03-02 15:23:03 +08:00
benches use std::hint::black_box instead of deprecated criterion::black_box 2026-02-24 13:59:11 +08:00
crates/robot-kit chore(deps): bump the rust-all group across 1 directory with 4 updates (#1689) 2026-02-24 19:23:35 -05:00
dev feat: harden non-CLI approval governance and runtime policy sync 2026-02-26 02:19:14 +08:00
docs docs(ci): clarify PR intake re-trigger semantics 2026-03-01 22:12:43 +08:00
examples fix(channels): enforce reply_target naming consistency 2026-02-18 19:56:31 +08:00
firmware chore(unsafe-debt): enforce strict full crate coverage defaults (RMN-54) 2026-02-24 21:00:46 +08:00
fuzz feat(unsafe-debt): deepen crate-root guard enforcement (RMN-52) 2026-02-24 19:48:28 +08:00
python docs(i18n): consolidate localized readmes under docs/i18n 2026-02-25 21:37:51 +08:00
scripts test(ci): assert checkout commands in scope tests 2026-02-28 14:06:08 +08:00
site feat(site): deepen docs IA with pathways and taxonomy 2026-02-26 15:20:44 +08:00
skills feat(skills): add trusted domain policy and transparent preloads 2026-03-01 00:57:31 +08:00
src feat(tools): add Chrome/Firefox support to browser_open tool 2026-03-03 15:07:09 +08:00
test_helpers fix(telegram): add message splitting, timeout, and validation fixes (#246) 2026-02-16 05:59:11 -05:00
tests fix(agent): improve iteration-limit recovery and defaults 2026-02-25 17:33:32 -05:00
web docs(readme): simplify to essential info only 2026-02-27 11:57:53 -05:00
.coderabbit.yaml fix(ci): correct CodeRabbit config schema for reviews.poem 2026-02-25 18:42:49 +08:00
.dockerignore fix: run Docker container as non-root user (closes #34) 2026-02-14 13:16:33 -05:00
.editorconfig Add nix package (#1829) 2026-02-26 04:57:15 -05:00
.env.example docs(env): add missing environment variables to .env.example 2026-02-19 11:31:43 -08:00
.envrc chore: Add nix files for easy on-boarding on the project 2026-02-19 16:29:32 +08:00
.gitattributes feat(repo): add .gitattributes for cross-platform line ending normalization 2026-02-17 21:12:25 -05:00
.gitignore chore(gitignore): add common editor patterns (.vscode etc.) 2026-03-03 23:23:11 +00:00
.gitleaks.toml feat(ci): complete security audit governance and resilient CI control lanes 2026-02-24 16:25:53 +08:00
.markdownlint-cli2.yaml docs: strengthen collaboration governance and AGENTS engineering protocol (#263) 2026-02-16 05:59:04 -05:00
.tmp_todo_probe feat: enhance agent personality, tool guidance, and memory hygiene 2026-02-14 11:28:39 -05:00
AGENTS.md ci: align main-first policy wording and harden add assertions 2026-02-28 14:06:08 +08:00
bootstrap.sh feat(installer): add guided zeroclaw installer and distro hardening (#887) 2026-02-20 04:34:14 -05:00
Cargo.lock feat(repl): use rustyline for UTF-8 input and history support 2026-02-26 05:01:26 -05:00
Cargo.toml feat(repl): use rustyline for UTF-8 input and history support 2026-02-26 05:01:26 -05:00
CHANGELOG.md fix(gateway): switch default port to 42617 across runtime and docs (#1179) 2026-02-21 02:28:56 -05:00
CLA.md legal: add dual MIT+Apache 2.0 license, trademark policy, and CLA (#941) 2026-02-19 09:20:03 -05:00
CLAUDE.md ci: align main-first policy wording and harden add assertions 2026-02-28 14:06:08 +08:00
clippy.toml fix(test): stabilize cron output capture and clippy cleanups 2026-02-18 20:29:26 +08:00
CODE_OF_CONDUCT.md Add Contributor Covenant Code of Conduct (#867) 2026-02-18 20:28:41 -05:00
CONTRIBUTING.el.md docs(i18n): unify greek localization and docs structure parity 2026-02-25 00:08:28 +08:00
CONTRIBUTING.md ci(workflow): adopt main/dev split with dev->main promotion gate (#1283) 2026-02-21 13:39:07 -05:00
deny.toml hardening(deps): govern matrix indexeddb derivative advisory 2026-02-25 19:23:53 +08:00
docker-compose.yml fix(gateway): switch default port to 42617 across runtime and docs (#1179) 2026-02-21 02:28:56 -05:00
Dockerfile chore(deps): bump rust from 9663b80 to 7e6fa79 (#1766) 2026-02-26 04:56:17 -05:00
flake.lock chore: Add nix files for easy on-boarding on the project 2026-02-19 16:29:32 +08:00
flake.nix Add nix package (#1829) 2026-02-26 04:57:15 -05:00
LICENSE-APACHE fix(license): restore canonical apache-2.0 text for detection (#1309) 2026-02-21 16:49:58 -05:00
LICENSE-MIT chore(license): make apache primary while preserving dual-license (#1307) 2026-02-21 16:43:36 -05:00
NOTICE legal: add dual MIT+Apache 2.0 license, trademark policy, and CLA (#941) 2026-02-19 09:20:03 -05:00
overlay.nix Add nix package (#1829) 2026-02-26 04:57:15 -05:00
package.nix Add nix package (#1829) 2026-02-26 04:57:15 -05:00
quick_test.sh fix(telegram): add message splitting, timeout, and validation fixes (#246) 2026-02-16 05:59:11 -05:00
README.md docs(readme): simplify to essential info only 2026-02-27 11:57:53 -05:00
RUN_TESTS.md fix(telegram): add message splitting, timeout, and validation fixes (#246) 2026-02-16 05:59:11 -05:00
rustfmt.toml feat(tooling): add .editorconfig, rustfmt.toml, and clippy.toml 2026-02-18 10:02:09 +08:00
SECURITY.md docs(security): standardize private vuln workflow and SLA templates 2026-02-25 21:32:32 +08:00
test_telegram_integration.sh fix(telegram): add message splitting, timeout, and validation fixes (#246) 2026-02-16 05:59:11 -05:00
TESTING_TELEGRAM.md feat(channel): add mention_only option for Telegram groups 2026-02-18 19:51:42 +08:00
TRADEMARK.md legal: add dual MIT+Apache 2.0 license, trademark policy, and CLA (#941) 2026-02-19 09:20:03 -05:00
zero-claw.jpeg docs: update README with benchmarks, features, and specs comparison image 2026-02-15 06:58:30 -05:00
zeroclaw_install.sh feat(installer): add guided zeroclaw installer and distro hardening (#887) 2026-02-20 04:34:14 -05:00
zeroclaw.png feat: initial release — ZeroClaw v0.1.0 2026-02-13 12:19:14 -05:00

ZeroClaw

ZeroClaw 🦀

Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.
Runs on $10 hardware with <5MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a 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

Built by students and members of the Harvard, MIT, and Sundai.Club communities.

🌐 Languages: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

Getting Started | One-Click Setup | Docs Hub | Docs TOC

Quick Routes: Reference · Operations · Troubleshoot · Security · Hardware · Contribute

Fast, small, and fully autonomous AI assistant infrastructure
Deploy anywhere. Swap anything.

ZeroClaw is the runtime operating system for agentic workflows — infrastructure that abstracts models, tools, memory, and execution so agents can be built once and run anywhere.

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

📢 Announcements

Use this board for important notices (breaking changes, security advisories, maintenance windows, and release blockers).

Date (UTC) Level Notice Action
2026-02-19 Critical We are not affiliated with openagen/zeroclaw, zeroclaw.org or zeroclaw.net. The zeroclaw.org and zeroclaw.net domains currently points to the openagen/zeroclaw fork, and that domain/repository are impersonating our official website/project. Do not trust information, binaries, fundraising, or announcements from those sources. Use only this repository and our verified social accounts.
2026-02-21 Important Our official website is now live: zeroclawlabs.ai. Thanks for your patience while we prepared the launch. We are still seeing impersonation attempts, so do not join any investment or fundraising activity claiming the ZeroClaw name unless it is published through our official channels. Use this repository as the single source of truth. Follow X (@zeroclawlabs), Telegram (@zeroclawlabs), Facebook (Group), Reddit (r/zeroclawlabs), and Xiaohongshu for official updates.
2026-02-19 Important Anthropic updated the Authentication and Credential Use terms on 2026-02-19. Claude Code OAuth tokens (Free, Pro, Max) are intended exclusively for Claude Code and Claude.ai; using OAuth tokens from Claude Free/Pro/Max in any other product, tool, or service (including Agent SDK) is not permitted and may violate the Consumer Terms of Service. Please temporarily avoid Claude Code OAuth integrations to prevent potential loss. Original clause: Authentication and Credential Use.

Features

  • 🏎️ Lean Runtime by Default: Common CLI and status workflows run in a few-megabyte memory envelope on release builds.
  • 💰 Cost-Efficient Deployment: Designed for low-cost boards and small cloud instances without heavyweight runtime dependencies.
  • Fast Cold Starts: Single-binary Rust runtime keeps command and daemon startup near-instant for daily operations.
  • 🌍 Portable Architecture: One binary-first workflow across ARM, x86, and RISC-V with swappable providers/channels/tools.
  • 🔍 Research Phase: Proactive information gathering through tools before response generation — reduces hallucinations by fact-checking first.

Why teams pick ZeroClaw

  • Lean by default: small Rust binary, fast startup, low memory footprint.
  • Secure by design: pairing, strict sandboxing, explicit allowlists, workspace scoping.
  • Fully swappable: core systems are traits (providers, channels, tools, memory, tunnels).
  • No lock-in: OpenAI-compatible provider support + pluggable custom endpoints.

Benchmark Snapshot (ZeroClaw vs OpenClaw, Reproducible)

Local machine quick benchmark (macOS arm64, Feb 2026) normalized for 0.8GHz edge hardware.

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

Notes: ZeroClaw results are measured on release builds using /usr/bin/time -l. OpenClaw requires Node.js runtime (typically ~390MB additional memory overhead), while NanoBot requires Python runtime. PicoClaw and ZeroClaw are static binaries. The RAM figures above are runtime memory; build-time compilation requirements are higher.

ZeroClaw vs OpenClaw Comparison


For full documentation, see docs/README.md | docs/SUMMARY.md

⚠️ Official Repository & Impersonation Warning

This is the only official ZeroClaw repository:

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

Any other repository, organization, domain, or package claiming to be "ZeroClaw" or implying affiliation with ZeroClaw Labs is unauthorized and not affiliated with this project. Known unauthorized forks will be listed in TRADEMARK.md.

If you encounter impersonation or trademark misuse, please open an issue.


License

ZeroClaw is dual-licensed for maximum openness and contributor protection:

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

You may choose either license. Contributors automatically grant rights under both — see CLA.md for the full contributor agreement.

Contributing

See CONTRIBUTING.md and CLA.md. Implement a trait, submit a PR.


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

Star History

Star History Chart