项目简介
ZeroClaw 是一个用 Rust 编写的全自主 AI 个人助手基础设施——一个单二进制的智能体运行时（Agent Runtime），口号非常硬核：「You own the agent. You own the data. You own the machine it runs on.」（智能体是你的，数据是你的，跑它的机器也是你的）。它对接 Anthropic、OpenAI、Ollama 等约 20 家模型提供商，通过 Discord、Telegram、Matrix、邮件、语音、Webhook 等 30+ 消息通道与你交互，并能调用 Shell、浏览器、HTTP、硬件（树莓派 GPIO！）和自定义 MCP 服务器执行任务。整个系统跑在你自己的机器上，用你自己的密钥。项目 2026 年 2 月创建，短短 5 个多月即斩获 32,400+ Stars，由 Harvard、MIT、Sundai Club 社区孵化，是当前 GitHub 上最火的 Rust AI 基础设施项目之一。
安装要求和过程
环境要求
- 操作系统：Linux / macOS / Windows / FreeBSD / NixOS / Docker 全平台支持，也可跑在树莓派等硬件上
- Rust：仅源码构建需要（Rust Edition 2024）；官方提供预编译二进制，无需工具链
- 磁盘占用：minimal 内核精简版仅约 6.6 MB
- 模型来源：任一 LLM 提供商 API Key，或本地 Ollama（完全离线可用）
快速安装
# 一键安装（自动选择预编译二进制，失败则回退源码构建）
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash
# 或克隆后安装（可交互选择功能特性）
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw && ./install.sh
# 常用安装选项
./install.sh --preset minimal # 仅内核精简版（约6.6MB）
./install.sh --prebuilt # 强制使用预编译二进制
./install.sh --source --features agent-runtime,channel-discord # 自定义特性快速上手
zeroclaw quickstart # 一站式引导：选择模型提供商、生成可用配置
zeroclaw agent -a <alias> # 与指定智能体交互式对话
zeroclaw service install # 注册为 systemd/launchctl/Windows 服务
zeroclaw service start # 后台常驻运行所有配置集中在一个 TOML 文件（~/.zeroclaw/config.toml），provider、channel、agent、安全策略全部声明式定义。
核心功能
- 多通道统一接入：Discord、Telegram、Matrix、邮件、语音、Webhook、CLI 等 30+ 通道适配器，所有入站消息汇入同一个智能体循环——一个 Agent 在所有平台回复你
- 模型提供商无关：可插拔接入 Anthropic、OpenAI、本地 Ollama 及任意 OpenAI 兼容端点，支持故障回退链与智能路由，某家 API 抽风时自动切换保持在线
- 安全优先架构：默认「supervised」监督模式——中风险操作需审批、高风险直接拦截；工作区边界、命令策略、OS 级沙箱（Landlock / Bubblewrap / Seatbelt / Docker）、每次工具调用都有密码学签名回执（Tool Receipts）；开发机可切 YOLO 模式放飞
- 硬件直控能力：通过 Peripheral trait 支持树莓派、STM32、Arduino、ESP32 的 GPIO / I2C / SPI / USB——让 AI 助手直接操控物理世界
- SOP 事件引擎 + 网关面板：MQTT / Webhook / Cron / 外设事件触发标准作业流程（含审批门与断点续跑）；HTTP/WebSocket 网关自带 Web 仪表盘，可视化管理聊天、记忆、配置与定时任务；还支持 ACP 协议接入 IDE
典型使用场景
- 7×24 小时私人 AI 管家：注册为系统服务常驻后台，你在 Telegram 上问它日程、在邮件里让它整理附件、在 Discord 里让它跑脚本——同一个大脑，全渠道待命，数据永不出你的服务器
- 智能家居 / 硬件自动化中枢：跑在树莓派上直控 GPIO 传感器与继电器，配合 SOP 引擎实现「温度超标→MQTT 触发→AI 判断→自动开风扇并通知你」这类带审批门的物理世界自动化
- 企业内网离线 AI 运维助手：搭配本地 Ollama 全离线部署，利用命令策略与 OS 级沙箱严格限权，工具回执提供完整审计链——在合规敏感环境中安全落地 AI 自动化
推荐理由
试用下来最大的感受是「克制而完整」。市面上的个人 AI 助手项目大多是 Python 全家桶+一堆依赖，而 ZeroClaw 是一个 Rust 单二进制，最小 6.6MB，装完即跑，树莓派上也轻松常驻。它的安全设计诚意十足：默认监督模式、OS 级沙箱、每个工具调用带密码学回执，这在同类项目中相当罕见——大多数 Agent 框架是「先跑起来再说」，它是「先关进笼子再放权」。多通道统一智能体循环的设计也很优雅：不是每个平台一个 Bot，而是一个智能体在所有渠道等你。如果你想要一个真正属于自己、数据不外流、还能摸到硬件的 AI 助手，这可能是目前最工程化的开源答案。MIT/Apache-2.0 双许可，商用无忧。注意：官方特别提醒有仿冒仓库/域名，认准唯一官方仓库 zeroclaw-labs/zeroclaw。
下载地址
- GitHub 仓库：https://github.com/zeroclaw-labs/zeroclaw
- 官方网站：https://www.zeroclawlabs.ai/
- 官方文档：https://docs.zeroclawlabs.ai
- 最新版本：GitHub Releases
项目数据：32,420+ Stars | 4,847 Forks | Rust | MIT OR Apache-2.0 双许可 | 创建于 2026 年 2 月