### [ZeroClaw：32K Stars 的 Rust 全自主 AI 个人助手基础设施，单二进制部署、30+通道接入、还能直控硬件](https://www.willai.cc/article/4496)

**Published:** 2026-07-28T12:45:46

**Author:** hiyoho

**Excerpt:** ZeroClaw 是用 Rust 编写的全自主 AI 个人助手基础设施：单二进制运行时对接约20家模型提供商与30+消息通道，默认监督模式+OS级沙箱+密码学工具回执，支持树莓派GPIO硬件直控，最小仅6.6MB。5个月斩获32,400+ Stars。

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

## 项目简介

**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

## 典型使用场景

1.  **7×24 小时私人 AI 管家**：注册为系统服务常驻后台，你在 Telegram 上问它日程、在邮件里让它整理附件、在 Discord 里让它跑脚本——同一个大脑，全渠道待命，数据永不出你的服务器
2.  **智能家居 / 硬件自动化中枢**：跑在树莓派上直控 GPIO 传感器与继电器，配合 SOP 引擎实现「温度超标→MQTT 触发→AI 判断→自动开风扇并通知你」这类带审批门的物理世界自动化
3.  **企业内网离线 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://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)

_项目数据：32,420+ Stars | 4,847 Forks | Rust | MIT OR Apache-2.0 双许可 | 创建于 2026 年 2 月_

**Tags:** Agent运行时, AI, AI Agent, AI开源项目, AI智能体, Apache许可, LLM, MCP, MIT许可, Ollama

**Categories:** 开源项目

---