项目简介
ZeroClaw 是一个用 Rust 编写的全自主个人 AI 助理基础设施（Agent Runtime）——一个体积小、速度快的单二进制程序，让你在自己的机器上跑一个 7×24 小时在线的私人 AI 助理：它对接 Anthropic、OpenAI、Ollama 等 20 余家模型提供商，通过 Discord、Telegram、Matrix、邮件、语音、Webhook 等 30+ 渠道与你对话，并能调用 Shell、浏览器、HTTP、硬件外设与自定义 MCP 服务器执行真实操作。项目口号非常直白：“You own the agent. You own the data. You own the machine it runs on.”（智能体是你的，数据是你的，机器也是你的。）
项目诞生于 2026 年 2 月，由 Harvard、MIT 与 Sundai Club 社区孵化，短短 5 个多月即斩获 32,400+ Stars、4,800+ Fork，是当下最火的 Rust AI 项目之一。采用 MIT OR Apache-2.0 双许可，可自由选择。
安装要求和过程
环境要求
- 操作系统：Linux / macOS / Windows / FreeBSD / NixOS / Docker 全平台支持，也可跑在树莓派等单板机上
- 运行环境：预编译二进制开箱即用；从源码构建需 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
# 极简内核（约6.6MB）
./install.sh --preset minimal
快速上手
zeroclaw quickstart # 一站式配置：选择模型提供商，生成可用配置
zeroclaw agent -a <alias> # 交互式对话
zeroclaw service install # 注册为 systemd/launchctl/Windows 服务
zeroclaw service start # 后台常驻运行
所有配置集中在一个 TOML 文件（~/.zeroclaw/config.toml），支持 Codex 订阅、Claude Max setup-token 等多种认证方式导入。
核心功能
- 多渠道统一接入：Discord、Telegram、Matrix、邮件、语音、Webhook、CLI 等 30+ 渠道适配器，全部消息汇入同一个智能体循环，一个助理全端响应
- 模型提供商无关：可插拔接入 Anthropic、OpenAI、本地 Ollama 及任意 OpenAI 兼容端点约 20+ 家，支持故障回退链与智能路由，单家挂掉不影响服务
- 安全优先架构：默认 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 集成
ZeroClaw 硬件接入架构：从单板机 GPIO 到智能体循环
典型使用场景
- 私有化全天候个人助理：在家庭服务器或 VPS 上以 systemd 服务常驻运行，用 Telegram/Discord 随时召唤——查资料、跑脚本、管日程、收发邮件，所有数据和 API Key 都留在自己机器上，零云端依赖
- 智能家居与硬件自动化中枢：跑在树莓派上，结合 SOP 引擎的 MQTT/Cron/外设触发器，让 AI 根据传感器读数自动执行标准作业流程（如温度异常告警并开启风扇），审批门保证关键操作人工确认
- 离线/内网 AI 运维助手：搭配本地 Ollama 在无外网环境下运行，通过 Shell 与 HTTP 工具执行巡检、日志分析等任务，沙箱与工具回执满足安全审计要求
推荐理由
体验下来最深的感受是「轻」和「稳」：相比动辄上 GB 依赖的 Python Agent 框架，ZeroClaw 一个 6.6MB 起步的 Rust 二进制就能常驻后台，树莓派也毫无压力；配置只有一个 TOML 文件，quickstart 三分钟跑通。它的安全设计是我见过的开源助理里最认真的——默认监督模式、OS 级沙箱、每次工具调用都有加密回执，敢放心给它 Shell 权限。多渠道 + 多提供商 + 故障回退的组合意味着它真的能当”基础设施”用，而不只是玩具 Demo。如果你想要一个数据完全自持、能接硬件、7×24 在线的私人 Jarvis，ZeroClaw 是目前 Rust 生态里最值得入手的选择。注意：官方仓库只有 zeroclaw-labs/zeroclaw 一个，谨防仿冒包。
下载地址
- GitHub 仓库：https://github.com/zeroclaw-labs/zeroclaw
- 官方网站：https://www.zeroclawlabs.ai/
- 官方文档：https://docs.zeroclawlabs.ai
- 最新版本：GitHub Releases