+14
日增长
+261
周增长
+413
月增长
33,378
stars
5,020
forks
84
watchers
8,149
prs
3,589
issues
156
releases
README
🦀 ZeroClaw — Personal AI Assistant
You own the agent. You own the data. You own the machine it runs on.
Website ·
Docs ·
Philosophy ·
Quick start ·
Architecture ·
Discord
---
ZeroClaw is an agent runtime — a single Rust binary you configure and run. It talks to LLM providers (Anthropic, OpenAI, Ollama, and ~20 others), reaches the world through 30+ channels (Discord, Telegram, Matrix, email, voice, webhooks, your own CLI), and acts through tools (shell, browser, HTTP, hardware, custom MCP servers). Everything runs on your machine, with your keys, in your workspace.
Read the Philosophy for the four opinions that shape it.
Install
Unix (recommended)
generated:readme-unix-fast by cargo generate installers - do not edit
sh
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
"${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart
end generated:readme-unix-fast
Windows (recommended)
Use the Rust-free prebuilt PowerShell path in the Windows setup guide. It installs the current release, updates PATH, and runs Quickstart.
For the guided Unix installer, source builds, app and feature selection, and PATH behavior, compare the installation paths.
Run ./install.sh --help for the complete Unix installer flag reference.
Working on the docs? The translated documentation catalogues live in a
git submodule (docs/book/po). The Rust build does not need it, but building
or syncing the docs does. Clone with it, or add it to an existing clone:
bash
git clone --recurse-submodules https://github.com/zeroclaw-labs/zeroclaw.git
git submodule update --init docs/book/po existing clone
Platform-specific notes: Linux · macOS · Windows · FreeBSD · NixOS · Docker
Quick start
bash
zeroclaw quickstart one-shot setup: pick a provider, write a working config
zeroclaw agent -a interactive chat using the [agents.] entry
zeroclaw service install register as systemd/launchctl/Windows Service
zeroclaw service start run it always-on in the background
Full walkthrough: Quick start — or skip the safety gates with YOLO mode for dev boxes.
What ZeroClaw does
- Multi-channel — one agent answering you across every channel you configure. Inbound messages from Discord, Telegram, Matrix, email, webhooks, CLI — all delivered to the same agent loop.
- Provider-agnostic — model providers are pluggable. Configure Anthropic, OpenAI, local Ollama, or any OpenAI-compatible endpoint. Fallback chains and routing keep the agent running when a provider flakes.
- Security-first, with escape hatches — default autonomy is supervised: medium-risk ops require approval, high-risk blocked. Workspace boundaries, command policy, OS-level sandboxes (Landlock / Bubblewrap / Seatbelt / Docker), and cryptographic tool receipts on every action. YOLO mode exists for trusted dev environments.
- Hardware-capable — GPIO / I2C / SPI / USB on Raspberry Pi, STM32, ArTop issues
#6996RFC: Granular sandbox policy - filesystem restrictions29 comments · 2026-05-28#6808RFC: Work Lanes, Board Automation, and Label Cleanup24 comments · 2026-05-20#8396RFC: Make wire protocol first-class in provider construction and onboarding19 comments · 2026-06-27#7462[Bug]: 74 test failures on Windows — Unix-only test commands, path semantics, console encoding19 comments · 2026-06-10#7432[Tracker]: Runtime, dashboard sign-in and gateway delivery17 comments · 2026-06-09#10118[Tracker]: Rust anti-slop policy debt remediation16 comments · 2026-08-19#9600[Tracker]: Session-persistence contract ownership and layer ordering16 comments · 2026-07-31#9965[Task]: harden runtime-written executable test fixtures under the parallel runtime gate15 comments · 2026-08-13
Discussions
#12414Show and tell: ZeroClaw for CyberOps with XMPP, browser voice, and scoped credentials0 comments · 2026-11-13#12411Multi-user organisational assistant: which capabilities does ZeroClaw support?2 comments · 2026-11-13#12378Can any board member aprove my feature sugestion? If aproved I will develop the PR Thanks2 comments · 2026-11-10#11850Contributor recognition and a scoped path toward maintainership1 comments · 2026-10-19#11800ZeroClaw catalog support in AgentManager0 comments · 2026-10-16#11766One spending ceiling across several ZeroClaw instances (tested on v0.8.5)0 comments · 2026-10-15#11338Usage call: which built-in tools and integrations do you rely on?1 comments · 2026-10-01#11077Welcome Aarlington to the ZeroClaw Core Team0 comments · 2026-09-24
Latest release
v0.9.0 v0.9.0 2026-11-12ZeroClaw v0.9.0 ZeroClaw v0.9.0 is the first release in which people other than the operator can sign in, spanning 117 commits from 22 contributors. The dashboard can sign people in through your own OpenID Connect provider, accounts that aren't administrators get their own scoped chat, and the daemon keeps each account inside what its permission profile allows. The dashboard can also be served through a ZeroRelay, servers can install a build without the dashboard, and the configuration moves to schema version 4: read Breaking Changes before upgrading. In brief Dashboard sign-in through you
相关报道 (8)
80aj突发异动:ZeroClaw GitHub 组织及核心代码仓库全网下架2026-04-01blog.csdnKimiClaw/MaxClaw/OpenFang/CoPaw/OpenClawChinese/ZeroClaw/PicoClaw/TinyClaw等16大小龙虾系列AI Agent框架2026-03-0780ajClaw 生态03: ZeroClaw vs IronClaw - Rust 重写的两种哲学2026-02-22blog.csdn【GitHub项目推荐--ZeroClaw:零开销、零妥协的Rust原生AI助手基础设施】⭐⭐⭐2026-02-17x區塊先生 ⚠️ (rock #58)2026-02-14www.80aj.comiOS 强力 AI Agent 应用 iClaw 上架 TestFlight:支持多架构协作与本地代码沙盒2026-04-02新浪网OpenClaw火出天际 工程院院士王坚:AI龙虾价格很快打下来2026-03-08QQ News当AI助手只需要5MB内存和10美元硬件2026-02-15
News & coverage (9)
Hacker NewsZeroClaw - Zero overhead. Zero compromise. 100% Rust.▲ 6 · 2 comments · 2026-02-17Hacker NewsGetting a 404 when accessing the ZeroClaw repository▲ 2 · 0 comments · 2026-03-30マイナビニュースZeroClawをバージョンアップしよう2026-05-06マイナビニュースZeroClawとは?2026-04-16ForkLogResearchers detail botnet risk from AI agent hallucinations2026-07-10AIMultipleOpenClaw Alternatives: Hermes vs ZeroClaw vs Grok Bot2026-05-02KDnuggets10 GitHub Repositories to Master OpenClaw2026-03-26It's FOSSOpenClaw Alternatives That You Can Run on Raspberry Pi Like Devices2026-02-23Raspberry PiTurn your Raspberry Pi into an AI agent with OpenClaw2026-02-19