常见问题
关于 ZeroClaw 的常见问题和解答。
ZeroClaw 是一个用 Rust 编写的超轻量、完全自主的 AI Agent 运行时。它是基础设施层,抽象了模型、工具、记忆和执行,让 Agent 一次构建、到处运行——从 10 美元的 ARM 开发板到云服务器。
macOS:'brew install zeroclaw'。Linux:运行一键引导脚本 'curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash'。Windows:先通过 rustup 安装 Rust,然后 'cargo install zeroclaw'。所有平台也提供预编译二进制包。
ZeroClaw 内存占用 <5MB,OpenClaw 要 >1GB。同等硬件上启动时间 <10ms vs >500s。二进制约 8.8MB、零运行时依赖,而 OpenClaw 需要 Node.js(约 390MB 额外开销)。ZeroClaw 能在 10 美元的硬件上跑,OpenClaw 通常需要 599 美元的 Mac mini。
ZeroClaw 通过 Provider trait 实现完全模型无关。内置支持 OpenAI、Anthropic、Google Gemini、xAI Grok、Mistral、DeepSeek、Perplexity、Hugging Face、OpenRouter(100+ 模型),以及任何 OpenAI 兼容端点(包括通过 Ollama 使用本地模型)。
ZeroClaw 支持 17+ 频道:CLI、Telegram、Discord、Slack、WhatsApp、Signal、iMessage、Matrix、Mattermost、IRC、飞书、钉钉、QQ、Nostr、Email、Linq 和 Webhook。所有频道使用默认拒绝的白名单策略保障安全。
安全在每一层都有保障:网关仅绑定 localhost,6 位配对码认证,文件系统作用域 + 系统目录屏蔽,符号链接逃逸检测,默认拒绝的频道白名单,以及可选的 Docker 沙箱运行时。通过了社区安全检查清单的所有项目。
ZeroClaw 内置了一个零外部依赖的全栈搜索引擎。包括 SQLite 向量库 + 余弦相似度、FTS5 关键词搜索 + BM25 评分、自定义混合合并、可插拔的 Embedding Provider 和 LRU 缓存淘汰。后端支持:SQLite、PostgreSQL、Lucid、Markdown 或不使用。
完全可以。ZeroClaw 就是为低成本硬件设计的。<5MB 的内存占用和单个静态二进制意味着它能在树莓派、Orange Pi 和其他 ARM 单板机上轻松运行。在资源受限的设备上引导安装时用 '--prefer-prebuilt' 跳过编译。
ZeroClaw 的每个子系统(Provider、Channel、Tool、Memory、Tunnel、Runtime、Security、Identity、Observability)都定义为 Rust trait。你可以通过配置替换任何实现——不需要改代码。比如从 SQLite 切换到 PostgreSQL 记忆后端,或从 Cloudflare 切换到 ngrok 隧道。
项目在 github.com/zeroclaw-labs/zeroclaw 开源,采用 Apache 2.0 许可证。贡献指南见 docs/contributing/README.md。由 Harvard、MIT 和 Sundai.Club 社区的学生和成员构建。欢迎所有贡献。
内置工具包括 Shell/文件/记忆操作、定时/计划任务、Git 集成、浏览器自动化、HTTP 请求、截图/图片工具、Pushover 通知、Composio(可选)、任务委派和硬件工具。你还可以通过 TOML 清单使用社区 Skill 包扩展。
支持。ZeroClaw 支持 Cloudflare、Tailscale、ngrok 和自定义隧道二进制。为了安全,没有活跃隧道时网关拒绝公网绑定。通过配置中的 Tunnel trait 进行设置。
官方且唯一可信的仓库是 github.com/zeroclaw-labs/zeroclaw。官方网站是 zeroclawlabs.ai。不要信任 zeroclaw.org 或 zeroclaw.net——那些是另一个 fork 的冒充。
预编译二进制包支持 Linux (x86_64, aarch64, armv7)、macOS (x86_64, aarch64) 和 Windows (x86_64)。Rust 的可移植架构还支持 ARM、x86 和 RISC-V。
运行 'zeroclaw onboard --api-key sk-... --provider openrouter' 快速设置,或 'zeroclaw onboard --interactive' 使用向导。ZeroClaw 也支持 OpenAI Codex 和 Anthropic Claude Code 的订阅认证,使用加密 Profile 存储。
完整文档在仓库的 docs/README.md,目录在 docs/SUMMARY.md。快速入口:docs/reference 查 API 参考,docs/operations 查运维指南,docs/troubleshooting 查常见问题,docs/security 查安全细节。
官方渠道:X (@zeroclawlabs)、Reddit (r/zeroclawlabs)、Telegram (@zeroclawlabs,中文 @zeroclawlabs_cn,俄语 @zeroclawlabs_ru)、微信群和小红书。全部列在 GitHub README 中。