### [ZeroClaw：32.4K Stars 的 Rust 全自主个人 AI 助理基础设施，6.6MB 单二进制、30+ 渠道、数据完全自持](https://www.willai.cc/article/4522)

**Published:** 2026-07-28T18:45:01

**Author:** hiyoho

**Excerpt:** ZeroClaw 是用 Rust 编写的全自主个人 AI 助理基础设施：单二进制部署、对接 20+ 模型提供商、30+ 消息渠道、OS 级沙箱与加密工具回执，还能控制树莓派等硬件。你拥有智能体、数据和机器。

![ZeroClaw Banner](https://admin.hiyoho.com/wp-content/uploads/2026/07/zeroclaw-banner.jpg)

## 项目简介

**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 硬件架构](https://admin.hiyoho.com/wp-content/uploads/2026/07/zeroclaw-hardware-architecture.jpg)  
_ZeroClaw 硬件接入架构：从单板机 GPIO 到智能体循环_

## 典型使用场景

1.  **私有化全天候个人助理**：在家庭服务器或 VPS 上以 systemd 服务常驻运行，用 Telegram/Discord 随时召唤——查资料、跑脚本、管日程、收发邮件，所有数据和 API Key 都留在自己机器上，零云端依赖
2.  **智能家居与硬件自动化中枢**：跑在树莓派上，结合 SOP 引擎的 MQTT/Cron/外设触发器，让 AI 根据传感器读数自动执行标准作业流程（如温度异常告警并开启风扇），审批门保证关键操作人工确认
3.  **离线/内网 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://github.com/zeroclaw-labs/zeroclaw)
-   **官方网站**：[https://www.zeroclawlabs.ai/](https://www.zeroclawlabs.ai/)
-   **官方文档**：[https://docs.zeroclawlabs.ai](https://docs.zeroclawlabs.ai/master/en/introduction.html)
-   **最新版本**：[GitHub Releases](https://github.com/zeroclaw-labs/zeroclaw/releases/latest)

**Tags:** Agent运行时, AI, AI Agent, AI开源项目, Apache许可, Docker, MCP, Ollama, Rust, Telegram

**Categories:** 开源项目

---