哲学

ZeroClaw 基于四个观点构建，按优先级排列。

1. 你拥有它

该二进制文件可在您的本地机器、VPS 或 SBC 上运行。您的 API 密钥存储在配置文件中，对话历史保存在数据库中。无遥测、无云租户、无许可证服务器。如果拔掉电源线，代理将停止运行——且不会引发其他问题。

这是基础约束。下面所有的其他决策都由此衍生。

2. 以安全为先，同时提供逃生通道

本地优先并不意味着没有后果。能够执行 shell 命令、调用 HTTP 端点并写入文件的代理是一个特权进程。默认的自主级别是 supervised（监督模式）——中等风险操作需要批准，高风险操作将被阻止。

运行时附带：

• 工作区边界（智能体只能访问其配置的工作区内的路径）
• 命令允许/拒绝列表
• Shell 策略验证
• 操作系统级沙箱（Linux 上的 Docker、Firejail、Bubblewrap、Landlock；macOS 上的 Seatbelt）
• 工具收据——每个工具调用的密码学链接审计日志
• 紧急停止（zeroclaw estop）和 OTP 门控操作

对于理解权衡利弊的开发者和家庭实验室用户，YOLO 模式 提供了一种配置预设，它会禁用所有安全护栏。该模式输出大量日志，名称也显而易见，但并非默认选项。

3. 最小化——在二进制大小、依赖项和攻击面方面

ZeroClaw is written in Rust and optimised for a small binary and fast startup. A microkernel roadmap (RFC #5574) is actively splitting functionality behind feature flags so you only ship what you use. A release build of the core runtime fits in tens of megabytes; adding channel integrations or hardware support is opt-in.

The same discipline applies to the agent’s prompt surface. Tool descriptions are Fluent-localised and terse. There are no hidden system prompts injecting personality. The model sees what you configure.

4. 与提供商无关

The agent’s brain is pluggable. Anthropic, OpenAI, Ollama, Bedrock, Gemini, Azure, OpenRouter, and any OpenAI-compatible endpoint (Groq, Mistral, xAI, and ~20 others) work out of the box. Per-agent dispatch and hint-based model routes let you run reasoning-heavy tasks on one model and cheap chat on another.

这是有意为之。我们对质量有明确的标准，但对供应商没有偏好。如果明天有其他品牌推出了更优秀的模型，配置只需修改一行即可。

这不是

• 不是 SaaS。 没有托管版本，没有账户系统，也没有计费功能。
• 不是聊天界面。 它是一个代理运行时。你提供前端——CLI、聊天平台频道、REST 网关或 ACP JSON-RPC 接口。
• 不是一个框架。 你不需要在 ZeroClaw 之上构建应用程序。你只需配置它并连接频道。
• 非玩具。 生产环境部署在家庭实验室单板计算机（SBC）、VPS 和云虚拟机上，全天候 24/7 运行。zeroclaw service 子命令开箱即用，支持 systemd / launchctl / Windows 服务注册。

决策是如何做出的

实质性变更需通过 RFC 流程——请参阅 贡献指南 → RFCs。已接受的 RFC 具有权威性。开放的 RFC 是讨论文档，它们是了解后续计划及其原因的主要参考。

已批准的 RFC 基础规范：

• #5574 — Microkernel transition (v0.7.0 → v1.0.0). Crate splits, feature-flag taxonomy.
• #5576 — Documentation standards and knowledge architecture.
• #5577 — Project governance: core-team structure, two-thirds-majority voting.
• #5579 — Engineering infrastructure: CI pipelines, release automation.
• #5615 — Contribution culture: human/AI co-authorship norms.
• #5653 — Zero Compromise: error handling, dead-code policy, release-readiness.