🦀 ZeroClaw — 个人 AI 助手

你拥有 agent。你拥有数据。你拥有运行它的机器。

文档 · 理念 · 快速开始 · 架构 · Discord

ZeroClaw 是一个 agent 运行时——一个您可以配置和运行的单个 Rust 二进制文件。它与 LLM 提供商（Anthropic、OpenAI、Ollama 等 20 余家）通信，通过 30 多个渠道（Discord、Telegram、Matrix、电子邮件、语音、webhook、您自己的 CLI）触达外部世界，并通过工具（shell、浏览器、HTTP、硬件、自定义 MCP 服务器）执行操作。一切都在您的机器上、使用您的密钥、在您的工作区中运行。 请阅读[理念](docs/book/src/philosophy.md)，了解塑造该项目的四个核心观点。 ## 安装 ``` 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 ``` 安装程序会询问您是想要预编译的二进制文件（快速，约几秒钟）还是源码构建（较慢，可自定义）。两者最终结果一致——`zeroclaw onboard` 会自动启动。 标志： ``` ./install.sh --prebuilt # always prebuilt; don't ask ./install.sh --source # always build from source ./install.sh --minimal # kernel only (~6.6 MB) ./install.sh --source --features agent-runtime,channel-discord # custom feature set ./install.sh --skip-onboard # install only, run `zeroclaw onboard` later ./install.sh --list-features # print available feature flags ``` 特定平台的注意事项：[Linux](docs/book/src/setup/linux.md) · [macOS](docs/book/src/setup/macos.md) · [Windows](docs/book/src/setup/windows.md) · [Docker](docs/book/src/setup/container.md) ## 快速开始 ``` zeroclaw onboard # wizard: picks a provider, wires channels zeroclaw agent # interactive chat in the terminal zeroclaw service install # register as systemd/launchctl/Windows Service zeroclaw service start # run it always-on in the background ``` 完整演练：[快速开始](docs/book/src/getting-started/quick-start.md)——或者，如果是在开发机上，可以使用 [YOLO 模式](docs/book/src/getting-started/yolo.md)跳过安全关卡。 ## ZeroClaw 的功能 - **多渠道** —— 一个 agent 在您配置的[每个渠道](docs/book/src/channels/overview.md)上为您答疑解惑。来自 Discord、Telegram、Matrix、电子邮件、webhook、CLI 的入站消息——全部传送到同一个 agent 循环中。 - **提供商无关** —— [模型提供商](docs/book/src/providers/overview.md)是可插拔的。您可以配置 Anthropic、OpenAI、本地 Ollama，或任何兼容 OpenAI 的端点。[回退链和路由](docs/book/src/providers/fallback-and-routing.md)确保在某个提供商出现问题时，agent 仍能继续运行。 - **安全第一，设有逃生通道** —— 默认的自主权级别为 `supervised`：中等风险的操作需要批准，高风险操作被阻止。工作区边界、命令策略、OS 级别的沙箱（Landlock / Bubblewrap / Seatbelt / Docker），以及针对每个操作的加密[工具收据](docs/book/src/security/tool-receipts.md)。对于受信任的开发环境，可以使用 [YOLO 模式](docs/book/src/getting-started/yolo.md)。 - **硬件支持** —— 通过 `Peripheral` trait 支持 Raspberry Pi、STM32、Arduino 和 ESP32 上的 GPIO / I2C / SPI / USB。请参阅[硬件](docs/book/src/hardware/index.md)。 - **网关与仪表盘** —— 为客户端提供 HTTP / WebSocket 网关，并配备用于聊天、内存浏览、配置编辑、cron 管理和工具检查的 Web 仪表盘。 - **SOP 引擎** —— 事件触发的[标准操作程序](docs/book/src/sop/index.md) (MQTT / webhook / cron / 外围设备)，带有批准关卡和可恢复的运行过程。 - **ACP** —— 通过 [Agent Client Protocol](docs/book/src/channels/acp.md)（基于 stdio 的 JSON-RPC 2.0）进行 IDE / 编辑器集成。 ## 配置 配置文件位于 `~/.zeroclaw/config.toml` 的单个 TOML 文件。相关指引： - [提供商配置](docs/book/src/providers/configuration.md) —— 通用的 `[providers.models.]` schema - [渠道概述](docs/book/src/channels/overview.md) —— 每个渠道的 `[channels.]` 块 - [安全概述](docs/book/src/security/overview.md) —— 自主性、沙箱、工具收据 - [完整配置参考](docs/book/src/reference/config.md) —— 从实时 schema 生成；每个键均有文档说明 ## 架构 ``` ┌──────────────────────────────────────────────────────────────┐ │ channels gateway ACP │ │ (30+ adapters) (REST/WS) (JSON-RPC) │ │ ↓ │ │ ZeroClaw runtime │ │ ┌──────────┬──────────┬──────────┐ │ │ │ agent │ security │ SOP │ │ │ │ loop │ policy │ engine │ │ │ └──────────┴──────────┴──────────┘ │ │ ↓ ↓ ↓ │ │ providers tools memory │ │ (Anthropic, (shell, (SQLite, │ │ OpenAI, browser, embeddings) │ │ Ollama, HTTP, │ │ ~20 more) hardware) │ └──────────────────────────────────────────────────────────────┘ ``` 包含 Mermaid 图表的完整细节：[架构概述](docs/book/src/architecture/overview.md) · [请求生命周期](docs/book/src/architecture/request-lifecycle.md) · [Crates](docs/book/src/architecture/crates.md)。 ## 安全 请勿公开提交安全漏洞问题。请发送电子邮件至 `security@zeroclaw.dev`。完整政策请参阅 [SECURITY.md](SECURITY.md)。 ## 官方仓库及侵权声明 这是唯一的官方 ZeroClaw 仓库： 任何其他声称是“ZeroClaw”或暗示与 ZeroClaw Labs 有关联的仓库、组织、域名或软件包，均**未经授权且与本作品无关**。 ## 许可证 双重许可：[MIT](LICENSE-MIT) 或 [Apache 2.0](LICENSE-APACHE)。您可以任选其一。贡献者将自动授予这两种许可下的权利——请参阅 [CLA](docs/book/src/contributing/cla.md)。**ZeroClaw** 名称和标志是 ZeroClaw Labs 的商标。 ## 致谢 由社区构建和维护——原创建者 [@theonlyhennygod](https://github.com/theonlyhennygod)；项目负责人 [@JordanTheJet](https://github.com/JordanTheJet)。完整的维护者列表请见[交流](docs/book/src/contributing/communication.md)。 感谢孕育了早期工作的各个社区：**哈佛大学**、**麻省理工学院**、**Sundai Club**，以及每一位推动项目向前发展的贡献者。

标签：Agent Runtime, AI个人助理, AI智能体, Anthropic, CIS基准, Discord, DLL 劫持, LangChain, LLM评估, LLM集成, Matrix, Ollama, OpenAI, Python安全, Rust, Rust语言, Telegram, 人工智能, 内存规避, 单一二进制文件, 即时通讯, 可视化界面, 多平台接入, 大语言模型, 开源基础设施, 数据所有权, 本地部署, 模块化设计, 用户模式Hook绕过, 电子邮件, 网络安全, 网络流量审计, 自主代理, 自动化修复, 请求拦截, 跨操作系统, 轻量级, 通知系统, 隐私保护