跳到主要内容
项目档案应用项目

ZeroClaw 个人 AI 助手:轻量级本地部署与多通道交互指南

ZeroClaw 是一个用 Rust 开发的全平台个人 AI 助手,内存占用低于 5MB,可在树莓派等低成本设备上本地运行。它支持 WhatsApp、Telegram、Slack 等数十种通信渠道,并提供硬件外设集成和 web 控制面板。本文详细介绍其项目定位、安装步骤、使用方法及技术架构特点。

32,841RustStar 于 2026年2月14日2026年9月19日 更新

AI 总结

ZeroClaw 是一个用 Rust 编写的超轻量级个人 AI 助手,可在树莓派等低成本硬件上本地部署,支持 WhatsApp、Telegram 等数十种通信渠道,提供零开销、隐私优先的始终在线助理服务。

中文项目介绍

ZeroClaw 是一个用 Rust 开发的全平台个人 AI 助手基础设施,旨在提供零开销、轻量级且完全自主的助理服务。它解决了传统 AI 助手对高性能硬件和云服务的依赖,允许用户在低成本设备(如树莓派)上本地部署,从而降低成本和隐私风险。 该项目适用于需要在多种场景下使用个人助理的用户:在树莓派等设备上部署始终在线的助手;通过常用聊天应用(如 WhatsApp、Telegram、Slack)与 AI 交互;集成控制智能家居或机器人硬件;以及追求完全本地运行、数据隐私保护的场景。 技术层面,ZeroClaw 采用 Rust 编写,内存占用低于 5MB,支持任意操作系统和平台。其架构采用工作空间模块化设计,核心库提供代理引擎和工具系统,硬件集成通过 aardvark-sys 和 robot-kit 实现,通信支持 Matrix、Telegram 等渠道。工具状态共享采用 Arc<RwLock<T>> handle 模式确保并发安全,并使用 ClientId 实现多客户端隔离。配置通过环境变量和 TOML 文件管理,提供 CLI 和 Tauri 桌面界面。 从当前仓库信息可见,安装需复制 .env.example 到 .env 并配置 API 密钥,可通过 Docker 或 cargo build 部署;使用方式包括在支持渠道发送消息、访问 web 仪表板、连接硬件外设等。

详细信息与使用说明

1. 项目定位与用途

ZeroClaw 是一个个人 AI 助手基础设施,定位为轻量、本地、跨平台的自主助理系统。它允许用户在自己的设备(如树莓派、旧电脑)上运行 AI 助理,通过已使用的通信渠道(WhatsApp、Telegram 等)进行交互,并提供 web 仪表板实时控制。其核心用途是替代依赖云服务的商业助理,实现数据隐私保护和低成本部署。

2. 解决的问题

ZeroClaw 主要解决个人 AI 助手对高性能硬件和云服务的依赖问题。传统方案需要昂贵硬件(如 Mac mini)或持续云服务费用,且数据隐私难以保障。ZeroClaw 通过 Rust 优化实现 <5MB 内存占用,可在 $10 硬件上运行,并完全本地部署,从而降低 98% 硬件成本和隐私风险。同时,它统一了多通道通信,避免用户在不同平台间切换。

3. 适用场景

适用场景包括:在树莓派等低成本设备上部署始终在线的个人助理;通过常用聊天应用(如 WhatsApp、Telegram、Slack、Discord)与 AI 交互;集成控制智能家居或机器人硬件(如 ESP32、Arduino);需要完全本地运行、数据隐私保护的个人或家庭助理;以及开发者用于构建自定义 AI 代理的基础设施。从仓库信息可见,它还支持企业渠道如 DingTalk、Lark 等。

4. 安装方式

安装需先复制 .env.example 到 .env 并填写所需 API 密钥(如 OPENROUTER_API_KEY、OPENAI_API_KEY 等),以配置 AI 提供商。部署方式有两种:使用 Docker(参考 docker-compose.yml 或 Dockerfile)或通过 Rust 工具链编译(cargo build)。桌面端可通过 Tauri 构建应用(需安装 Tauri 依赖,参考 apps/tauri 目录)。仓库中未明确给出具体编译命令或 Docker 运行参数,需参考相关配置文件。

5. 使用方式

启动服务后,用户可在支持的通信渠道(如 Telegram、WhatsApp)中向助手发送自然语言消息进行交互;访问 web 仪表板(默认端口)进行实时控制和监控;通过配置连接硬件外设(如 ESP32),发送命令如 'scan i2c bus' 操作硬件;使用 CLI 命令(如 `zeroclaw` 二进制)进行管理操作。仓库中未列出所有可用命令的完整手册,但 AGENTS.md 和文档目录可能提供更多细节。

6. 实现特点

ZeroClaw 采用工作空间模块化设计:核心库(zeroclaw)提供代理引擎和工具系统;硬件集成通过 crates/robot-kit(机器人控制)和 crates/aardvark-sys(Total Phase 适配器绑定)实现;通信网关支持 Matrix、Telegram 等;Tauri 应用提供跨平台桌面界面。技术特点包括:轻量优化(tokio 和 reqwest 禁用默认特性)、工具状态共享采用 Arc<RwLock<T>> handle 模式、多客户端隔离使用 ClientId、配置驱动(环境变量 + TOML)。从当前仓库信息可见,还支持 Prometheus 指标、浏览器自动化等可选集成。

思维导图

ZeroClaw
核心库
代理引擎
工具系统
CLI 入口
Web 服务器
硬件集成
aardvark-sys
robot-kit
应用界面
Tauri 桌面应用
Web 仪表板
工具系统
过程宏
状态共享 (Arc<RwLock<T>>)
配置管理
环境变量
TOML 配置
通信渠道
Matrix
Telegram
WhatsApp
Slack

常见问题

ZeroClaw 是什么?

ZeroClaw 是一个用 Rust 编写的个人 AI 助手基础设施,强调零开销、轻量级(<5MB 内存)和完全自主运行,支持在任意操作系统和平台部署,并通过多种通信渠道(如 WhatsApp、Telegram)进行交互。

如何安装和配置 ZeroClaw?

安装需复制 .env.example 到 .env 并填写 API 密钥(如 OPENROUTER_API_KEY)。部署可通过 Docker(使用 docker-compose.yml)或 Rust 编译(cargo build)。桌面端可构建 Tauri 应用。仓库中未明确给出详细命令,需参考配置文件。

ZeroClaw 支持哪些通信渠道?

从 README 可见,ZeroClaw 支持 WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、Nostr、Mattermost、Nextcloud Talk、DingTalk、Lark、QQ、Reddit、LinkedIn、Twitter、MQTT、WeChat Work 等数十种渠道。

ZeroClaw 的硬件要求是什么?

ZeroClaw 设计为轻量级,可运行在 $10 硬件(如树莓派)上,内存占用低于 5MB,比 OpenClaw 节省 99% 内存。它还能连接 ESP32、STM32、Arduino、Raspberry Pi 等硬件外设。

ZeroClaw 是开源的吗?使用什么许可证?

是,ZeroClaw 在 GitHub 上开源,采用 MIT OR Apache-2.0 双许可证,允许自由使用、修改和分发。