Fast, small, and fully autonomous AI personal assistant infrastructure, ANY OS, ANY PLATFORM — deploy anywhere, swap anything 🦀
Go to file
2026-02-28 20:48:22 +08:00
.cargo feat(release): add Android target support (armv7 + aarch64) (#1456) 2026-02-23 08:05:44 -05: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 Fix shellcheck redirect style in queue hygiene workflow 2026-02-28 20:48:22 +08:00
benches use std::hint::black_box instead of deprecated criterion::black_box 2026-02-24 13:59:11 +08:00
clients ci(security): include android/template crates in unsafe debt audit 2026-02-28 17:44:47 +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 fix: harden browser and web search validation paths 2026-02-28 15:50:06 +08:00
examples fix(channels): enforce reply_target naming consistency 2026-02-18 19:56:31 +08:00
extensions/hello-world feat: plugin system 2026-02-26 21:49:10 -05: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 ci(security): include android/template crates in unsafe debt audit 2026-02-28 17:44:47 +08:00
site chore: remove install scripts - APK is the product 2026-02-26 22:04:26 -08:00
src fix(delivery): handle HEARTBEAT_OK sentinel case-insensitively 2026-02-28 07:31:45 -05:00
templates ci(security): include android/template crates in unsafe debt audit 2026-02-28 17:44:47 +08:00
test_helpers fix(telegram): add message splitting, timeout, and validation fixes (#246) 2026-02-16 05:59:11 -05:00
tests Merge pull request #2157 from zeroclaw-labs/feat/providers-sf-volcengine 2026-02-28 01:28:09 -05:00
web fix(web): add mobile sidebar toggle and responsive layout offset 2026-02-26 21:32:50 -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 feat(skills): add WASM skill engine with secure registry install 2026-02-26 22:09:24 -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: add .idea to .gitignore 2026-02-27 10:45:01 -05: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 fix(ci): stabilize post-2142 local quality gates (COM-2142) (#2171) 2026-02-27 23:18:25 -08:00
bootstrap.sh feat(installer): add guided zeroclaw installer and distro hardening (#887) 2026-02-20 04:34:14 -05:00
Cargo.lock fix(security): patch wasmtime advisories by pinning 24.0.6 2026-02-28 17:44:47 +08:00
Cargo.toml fix(security): patch wasmtime advisories by pinning 24.0.6 2026-02-28 17:44:47 +08:00
CHANGELOG.md fix(ci): stabilize post-2142 local quality gates (COM-2142) (#2171) 2026-02-27 23:18:25 -08: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 fix(ci): stabilize post-2142 local quality gates (COM-2142) (#2171) 2026-02-27 23:18:25 -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 ci(security): allow transitive paste advisory in cargo-deny 2026-02-28 17:44:47 +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 fix(docker): support feature builds and include templates 2026-02-27 08:08:58 -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 chore: promote dev snapshot to main (resolve #1978/#1970) 2026-02-26 21:09:33 -05:00
LICENSE-APACHE chore(release): promote dev to main for v0.1.5 (#1325) 2026-02-21 21:14:34 -05:00
LICENSE-MIT chore(release): promote dev to main for v0.1.5 (#1325) 2026-02-21 21:14:34 -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 chore: promote dev snapshot to main (resolve #1978/#1970) 2026-02-26 21:09:33 -05:00
package.nix chore: promote dev snapshot to main (resolve #1978/#1970) 2026-02-26 21:09:33 -05:00
PR_DESCRIPTION_UPDATE.md fix(android): Address CodeRabbit HIGH and MEDIUM severity issues 2026-02-27 11:46:38 -08: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: update hardware references 2026-02-27 20:18:47 -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): codify official anti-fraud channels statement 2026-02-26 22:57:46 -05: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 ci: remove blacksmith action dependencies 2026-02-28 05:00:01 +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 any 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

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

🙏 Special Thanks

A heartfelt thank you to the communities and institutions that inspire and fuel this open-source work:

  • Harvard University — for fostering intellectual curiosity and pushing the boundaries of what's possible.
  • MIT — for championing open knowledge, open source, and the belief that technology should be accessible to everyone.
  • Sundai Club — for the community, the energy, and the relentless drive to build things that matter.
  • The World & Beyond 🌍 — to every contributor, dreamer, and builder out there making open source a force for good. This is for you.

We're building in the open because the best ideas come from everywhere. If you're reading this, you're part of it. Welcome. 🦀❤️

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

Trademark

The ZeroClaw name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See TRADEMARK.md for permitted and prohibited uses.

Contributor Protections

  • You retain copyright of your contributions
  • Patent grant (Apache 2.0) shields you from patent claims by other contributors
  • Your contributions are permanently attributed in commit history and NOTICE
  • No trademark rights are transferred by contributing

Contributing

New to ZeroClaw? Look for issues labeled good first issue — see our Contributing Guide for how to get started.

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

  • CI workflow guide: docs/ci-map.md
  • New Providersrc/providers/
  • New Channelsrc/channels/
  • New Observersrc/observability/
  • New Toolsrc/tools/
  • New Memorysrc/memory/
  • New Tunnelsrc/tunnel/
  • New Skill~/.zeroclaw/workspace/skills/<name>/

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

Star History

Star History Chart