Skip to content

zeroclaw-labs/zeroclaw

⭐ 31,208  ·  Rust  ·  GitHub 仓库

快速、小巧且完全自主的AI个人助理基础设施,适用于任何操作系统、任何平台——可部署于任何环境,可替换任何组件 🦀

agent agentic ai infra ml openclaw os zeroclaw

一句话总结

您专属的全自主AI智能体:自托管、单二进制文件、任意操作系统、任意平台,数据完全归您所有。

🔥 核心能力与独特卖点

  • 多通道通信:单一智能体循环可同时服务30+通道(Discord、Telegram、Matrix、电子邮件、CLI、Webhook)。痛点解决:无需再为每个平台管理独立的机器人,也不会因碎片化通信工具而遗漏消息。
  • 供应商无关的模型支持:可插拔的LLM提供商(Anthropic、OpenAI、Ollama及约20家其他服务商),支持自动故障转移链和路由。痛点解决:消除供应商锁定和单点故障风险;即使某家服务商宕机,您的智能体仍能持续运行。
  • 安全优先设计:默认采用监督式自主模式,配备审批关卡、工作空间边界、操作系统级沙箱(Landlock/Bubblewrap/Seatbelt/Docker),并为每次操作提供加密收据。痛点解决:放心让智能体执行操作,无需担心意外系统修改或数据泄露。
  • 硬件能力:通过外设特性(Peripheral trait)直接控制Raspberry Pi、STM32、Arduino和ESP32上的GPIO/I2C/SPI/USB。痛点解决:为机器人技术和物联网项目架起软件智能体与物理世界自动化的桥梁。
  • SOP引擎与网关:事件触发的标准操作流程(MQTT/Webhook/Cron/外设),支持审批关卡,外加HTTP/WebSocket网关和Web仪表盘。痛点解决:无需编写胶水代码即可自动化复杂多步骤工作流,同时保持人工监督。

独特卖点:ZeroClaw是唯一一款完全自主、自托管的AI智能体基础设施,以单个Rust二进制文件形式运行于任何操作系统或平台,让您完全掌控自己的智能体、数据和算力。

Architecture

技术架构

层级组件描述
通道层30+适配器(Discord、Telegram、Matrix、电子邮件、Webhook、CLI)将来自任何来源的消息接入同一智能体循环
网关层REST API + WebSocket + Web仪表盘提供聊天、记忆、配置和工具管理UI
ACPJSON-RPC 2.0协议用于外部集成的标准化智能体通信协议
运行时智能体循环 + 安全策略 + SOP引擎核心编排,支持审批关卡和事件触发
提供商层Anthropic、OpenAI、Ollama及约20家其他服务商可插拔的LLM后端,支持故障转移链
工具层文件系统、Shell、GPIO、Web等可扩展的工具系统,附带加密收据
记忆层SQLite + 嵌入向量持久化状态和向量搜索,用于上下文保留

技术栈:Rust(2024版)、单二进制部署、模块化插件架构、操作系统级沙箱。

快速入门指南

bash
# 一键安装
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 --prebuilt              # 始终使用预编译版本;无需询问
./install.sh --source                # 始终从源码构建
./install.sh --minimal               # 仅内核(约6.6 MB)
./install.sh --source --features agent-runtime,channel-discord  # 自定义功能集
./install.sh --skip-onboard          # 仅安装,稍后运行 `zeroclaw onboard`
./install.sh --list-features         # 打印可用功能标志

# 快速启动
zeroclaw onboard                  # 向导:选择提供商,配置通道
zeroclaw agent                    # 终端交互式聊天
zeroclaw service install          # 注册为systemd/launchctl/Windows服务
zeroclaw service start            # 在后台持续运行

优缺点与使用场景

优点

  • 真正自主:完全自托管运行,无云端依赖
  • 跨平台:单个二进制文件适用于任何操作系统(Linux、macOS、Windows)和任何硬件(x86、ARM、RISC-V)
  • 默认安全:沙箱执行、审批关卡和加密收据
  • 极致灵活:无需修改代码即可切换提供商、通道、工具和记忆后端
  • 硬件集成:直接控制外设,适用于机器人和物联网

缺点

  • 手动配置:需要编辑TOML文件;无图形化设置向导
  • 安全摩擦:默认监督模式要求每次操作都需审批,对普通用户可能略显繁琐
  • 无托管云选项:您必须自行提供算力和基础设施
  • 学习曲线:理解模块化架构和配置选项需要时间

不适合谁使用?

  • 普通用户:希望即插即用、零配置的AI助手
  • 需要托管SaaS解决方案的团队:要求SLA和支持合同
  • 不习惯CLI工具和配置文件的用户
  • 需要云原生扩展的项目:如自动扩展、跨实例负载均衡

理想使用场景

  • 构建自定义AI智能体的开发者:需要完全控制模型、工具和数据
  • 注重隐私的用户:希望将所有数据保留在本地
  • 物联网/机器人爱好者:将AI与物理硬件集成(Raspberry Pi、Arduino、ESP32)
  • DevOps团队:通过安全、可审计的智能体操作自动化基础设施任务
  • 多平台重度用户:需要一个智能体横跨Discord、Telegram、电子邮件和CLI

社区与活跃度

ZeroClaw 火爆异常,拥有 31,208颗星标,最近更新于 2026年5月10日——这是一个快速演进、积极维护的项目。社区势头强劲,表明开发者广泛采用且高度信任。凭借单个Rust二进制文件解决AI助手碎片化问题的能力,ZeroClaw有望成为自托管智能体基础设施的事实标准。活跃的开发节奏和庞大的星标数量表明,该项目既适合生产环境稳定使用,又在持续改进。

热点项目数据来自 GitHub API,实时更新