zeroclaw-labs/zeroclaw

项目介绍

ZeroClaw 是一个以单个 Rust 二进制分发的智能体运行时。你用一个 TOML 文件配置它，在本机、用自己的 provider 密钥和工作区运行。它支持 Anthropic、OpenAI、本地 Ollama 等约 20 家模型提供商，通过 30 多个渠道（Discord、Telegram、Matrix、邮件、Webhook、语音、CLI）接收输入，并通过 shell、浏览器、HTTP、硬件外设、自定义 MCP 服务器等工具执行操作；所有渠道的消息进入同一个智能体循环 渠道说明。

除了对话循环，运行时还包含安全、SOP 和记忆几个组件 架构说明。提供商的回退链和路由能在某个服务不稳定时保持运行 路由。默认自主级别是 supervised：中风险操作需要审批，高风险操作直接被拦截；配合工作区边界、命令策略、系统级沙箱（Landlock、Bubblewrap、Seatbelt、Docker）和每个操作的工具凭证 安全说明。Peripheral trait 支持树莓派、STM32、Arduino、ESP32 上的 GPIO、I2C、SPI、USB 硬件支持。此外还有 HTTP/WebSocket 网关和 Web 面板（聊天、浏览记忆、改配置、cron 管理、工具检查）、事件触发的 SOP 引擎，以及供编辑器集成的 ACP。

它适合想要一个自己托管、可跨聊天平台和设备扩展的个人智能体，而不是托管式助手的人。

快速开始

Unix 上推荐用生成的安装脚本，然后跑一次性的配置向导 Unix 安装：

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
"${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart

quickstart 会让你选择提供商，并把可用配置写入 ~/.zeroclaw/config.toml。之后常用命令是：

zeroclaw agent -a <alias>         # 使用 [agents.<alias>] 条目进入交互对话
zeroclaw service install          # 注册为 systemd/launchctl/Windows 服务
zeroclaw service start            # 后台常驻运行

结果是进入与已配置智能体的交互对话，也可以把它注册成后台服务。Windows 不需要 Rust，按 Windows 安装指南 使用预编译的 PowerShell 安装方式，它会安装当前版本、更新 PATH 并启动 Quickstart。源码构建和引导式安装等选项见 快速开始里的安装对比，安装脚本参数可运行 ./install.sh --help 查看。

如果已经用 OpenAI Codex CLI 登录，Quickstart 可以直接导入该会话，而不必再填 key：

zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json
zeroclaw quickstart --model-provider openai-codex --model gpt-5.4

手写 V3 配置至少要有提供商条目、引用它的智能体条目和风险配置四类 <type>.<alias> 段落，并声明 schema_version = 4 提供商配置。

使用约束

• 默认自主级别为 supervised，想减少审批需要调整风险配置或启用 YOLO 模式，文档明确把它定位为可信开发机专用。安全模型基于策略，因此中风险工具调用会弹审批。
• 配置集中在单个带版本号的 TOML 文件（当前为 4）。旧文件或手改文件需要符合文档里的段落结构才能加载。
• 必须能访问模型提供商。OpenAI Codex、Claude Max setup token 这类订阅认证存放在认证配置里，而不是提供商条目上的 api_key 字段 提供商配置。
• 硬件渠道依赖 Peripheral trait 和文档列出的板卡，并不是任意设备都支持。
• 构建或同步翻译文档需要 docs/book/po 子模块；Rust 构建不需要。
• 双许可 MIT OR Apache-2.0；ZeroClaw 名称和 logo 是 ZeroClaw Labs 的商标。

HotRepo 点评

这个项目受到的关注远超一个小众运行时：2026 年 2 月创建以来约 3.3 万 Star、5000 Fork，2 月 17 日还有一条 Hacker News 讨论。两条站内记录的 HN 帖子信息量都不大：一条 6 分 2 评论的发布帖，一条报告仓库 404 的帖子。值得注意的是发布帖里有一条质疑评论，评论者认为项目谈安全时集中在“谁能通过 Telegram 和机器人对话”这类门禁上，没有正面处理 lethal trifecta 这类问题 讨论原文。这只是单个评论者的看法，不是核实过的结论，但它指向自托管智能体运行时最该被审视的地方：策略层控制与提示诱导型数据外泄风险之间的差距。评估默认 supervised 模式时，这个区别就是尚未回答的问题。