简介ZeroClaw​ 是一个由ZeroClaw Labs开发的开源、快速、小型且完全自主的AI助手基础设施框架采用100% Rust编写秉持“零开销、零妥协”的设计哲学。该项目以其惊人的资源效率著称——能够在仅10美元的硬件上运行内存占用低于5MB启动时间短于10毫秒相比同类解决方案如OpenClaw减少99%的内存使用和98%的部署成本。ZeroClaw不仅是一个高性能的AI助手运行时更是一个完全可插拔的架构允许开发者“在任何地方部署交换任何组件”。核心价值极致效率3.4MB的独立二进制文件5MB内存占用10ms启动时间成本革命专为边缘设备和资源受限环境设计大幅降低AI助手部署门槛完全自主内置自治引擎支持从监督到完全自主的不同运行模式架构灵活基于trait的模块化设计所有核心子系统均可热插拔替换技术定位ZeroClaw填补了高性能AI助手框架与资源受限环境之间的空白。它既不是另一个“重型”AI平台也不是简单的脚本工具而是一个经过精心设计、可在从树莓派到服务器的全频谱硬件上提供一致体验的生产级基础设施。其Rust原生实现确保了内存安全、线程安全和卓越的性能表现。主要功能1. 超轻量级运行时ZeroClaw的核心二进制文件仅3.4MB完全静态链接无需外部运行时依赖。内存占用稳定在5MB以下即使在内存仅1GB的树莓派3上也能流畅运行。启动时间突破性地低于10毫秒实现了“即时响应”的用户体验。这种极致的资源效率使其成为边缘计算、物联网设备和移动场景的理想选择。2. 全栈可插拔架构框架的每个子系统都定义为trait支持零代码更改的组件替换。AI模型提供商系统支持22个服务OpenRouter、Anthropic、OpenAI、Ollama、Groq、Mistral、xAI、DeepSeek等以及任何OpenAI兼容的自定义端点。通信渠道支持CLI、Telegram、Discord、Slack、iMessage、Matrix、WhatsApp和Webhook。内存后端可在SQLite、Lucid桥接、Markdown或无持久化之间选择。工具系统、可观察性、运行时适配器、安全策略等全部模块化。3. 自主内存与搜索系统ZeroClaw内置完整的全栈搜索引擎无需依赖Pinecone、Elasticsearch或LangChain等外部服务。向量数据库将嵌入存储为SQLite BLOB支持余弦相似度搜索。关键词搜索基于FTS5虚拟表和BM25评分。混合合并使用自定义加权函数结合向量和关键词结果。嵌入通过EmbeddingProvider trait支持多种来源。系统自动进行记忆的保存、回忆和管理支持安全的重建索引。4. 多层安全加固安全不是事后考虑而是设计核心。网关默认绑定到127.0.0.1拒绝公开绑定除非明确配置隧道。配对系统要求6位一次性代码交换为Bearer令牌。文件系统作用域默认限制在工作空间内阻止对14个系统目录和4个敏感点文件的访问。空字节注入防护和符号链接逃逸检测。通道允许列表策略默认拒绝所有入站消息需显式配置授权发送者。支持Docker沙箱运行时可配置内存、CPU限制和只读根文件系统。5. 身份系统与AIEOS支持支持两种身份格式传统的OpenClaw Markdown文件IDENTITY.md、SOUL.md、USER.md、AGENTS.md和新兴的AIEOSAI实体对象规范v1.1 JSON格式。AIEOS支持使AI身份可跨模型和系统移植保持行为一致性。身份系统涵盖名称、心理学特征神经矩阵、MBTI、道德指南针、语言学风格、动机、能力、物理特征、历史和兴趣等完整维度。6. 浏览器与自动化工具可选浏览器工具支持多种后端agent_browser默认、rust_native和computer_use。计算机使用侧边栏通过HTTP端点实现鼠标点击、键盘输入等UI自动化。严格的域名允许列表和窗口标题过滤确保自动化安全。工具系统还包括shell执行、文件读写、记忆存储/回忆/遗忘等核心能力全部可扩展。7. 心跳与自治引擎内置心跳系统支持周期性任务执行间隔可配置。自治水平分为三级只读仅观察、监督需要用户确认和完全自主自主决策执行。工作空间作用域限制确保操作不超出授权范围。允许的命令列表和禁止路径列表提供细粒度控制。8. 隧道与网络集成支持多种隧道提供商Cloudflare、Tailscale、ngrok或自定义二进制。隧道集成使本地服务能够安全地暴露给外部网络同时保持安全策略。网关API提供健康检查、配对和Webhook端点支持与各种消息平台集成。安装与配置环境要求Windows系统Visual Studio Build Tools提供MSVC链接器和Windows SDKRust工具链通过rustup安装可选Docker Desktop用于Docker沙箱运行时Linux/macOS系统构建基础工具Linuxbuild-essential pkg-configmacOSXcode命令行工具Rust工具链通过rustup.rs安装可选Docker用于沙箱运行时低内存设备注意事项树莓派31GB RAM等设备在编译时可能需要设置CARGO_BUILD_JOBS1环境变量防止内核因内存不足终止编译进程。安装步骤克隆与构建git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw cargo build --release --locked全局安装cargo install --path . --force --locked快速设置ZeroClaw提供三种设置模式快速设置zeroclaw onboard --api-key sk-... --provider openrouter交互式向导zeroclaw onboard --interactive7步完整配置仅通道修复zeroclaw onboard --channels-only快速修复允许列表问题开发环境备用无需全局安装时可使用cargo run --release --前缀运行命令如cargo run --release -- status。配置说明配置文件位置~/.zeroclaw/config.toml由onboard命令自动创建核心配置项API密钥和默认提供商/模型内存后端选择sqlite、lucid、markdown、none网关安全设置配对要求、公开绑定控制自治级别readonly、supervised、full运行时类型native或docker浏览器工具启用与域名限制身份格式openclaw或aieos安全默认值workspace_only true操作限制在工作空间内require_pairing true首次连接需要配对码allow_public_bind false无隧道时拒绝0.0.0.0绑定通道允许列表默认为空拒绝所有入站消息环境变量支持关键参数的环境变量覆盖如ZEROCLAW_LUCID_CMD、ZEROCLAW_LUCID_BUDGET等用于Lucid内存后端调优。如何使用基本工作流程快速启动聊天# 单次消息模式 zeroclaw agent -m 你好ZeroClaw # 交互式聊天模式 zeroclaw agent启动网关服务# 默认本地端口8080 zeroclaw gateway # 随机端口模式安全强化 zeroclaw gateway --port 0运行自治守护进程# 启动长期运行的自治运行时 zeroclaw daemon系统管理命令# 检查完整系统状态 zeroclaw status # 运行系统诊断 zeroclaw doctor # 检查通道健康状态 zeroclaw channel doctor # 查看集成设置详情 zeroclaw integrations info Telegram服务管理后台服务控制# 安装用户级后台服务 zeroclaw service install # 服务状态检查 zeroclaw service status # 启动/停止服务 zeroclaw service start zeroclaw service stop # 卸载服务 zeroclaw service uninstall迁移与数据管理# 从OpenClaw安全迁移记忆先预览 zeroclaw migrate openclaw --dry-run # 执行实际迁移 zeroclaw migrate openclaw高级操作模式多提供商故障转移在配置中设置多个LLM端点系统自动在主端点不可用时无缝切换。复杂推理任务可通过在模型名称后添加-thinking后缀启用思考模式。通道安全配置Telegram允许列表添加用户名无前缀或数字用户IDDiscord允许列表添加用户IDSlack允许列表添加成员ID通常以U开头使用*仅用于临时开放测试WhatsApp商业集成通过Meta Cloud API配置需要访问令牌、电话号码ID和验证令牌。必须使用HTTPS隧道ngrok、Cloudflare、Tailscale Funnel满足Meta的Webhook要求。应用场景实例实例1边缘设备智能监控助手场景描述工业物联网环境中的传感器网络需要实时分析设备状态、预测故障并提供操作建议。传统云计算方案存在延迟高、带宽成本大、隐私泄露风险等问题。边缘AI助手能够在设备本地提供智能响应减少云端依赖。解决方案在树莓派4或类似边缘设备上部署ZeroClaw配置为完全自主运行模式。AI助手持续监控传感器数据流通过本地模型分析异常模式。当检测到潜在故障时自动生成维护建议并通过Telegram通道通知技术人员。记忆系统记录历史事件和解决方案形成设备专属知识库。安全沙箱确保即使助手被攻破也无法逃逸到主机系统。实施效果响应延迟从秒级降低到毫秒级实现真正实时监控带宽消耗减少90%仅关键摘要同步到云端数据隐私得到保障敏感信息不出本地设备运维成本显著降低减少现场巡检频率实例2安全敏感环境的研究助手场景描述金融机构、法律事务所或政府部门的内部研究需要处理敏感文档同时利用AI能力提高效率。传统云AI服务存在数据泄露风险本地部署的AI系统又往往资源消耗大、部署复杂。解决方案在隔离网络中的标准办公电脑上部署ZeroClaw配置严格的安全策略。工作空间作用域限制确保助手只能访问授权的研究目录。文件系统阻止列表防止访问系统敏感区域。配对系统要求物理接触设备完成初始认证。记忆后端使用加密SQLite确保研究记录安全存储。浏览器工具配合域名白名单允许安全访问内部知识库。实施效果敏感数据完全控制在内部网络消除云泄露风险研究效率提升3-5倍AI助手快速整理文献、提取要点合规性满足金融、法律行业严格的数据处理要求部署简便普通办公电脑即可运行无需专用服务器实例3多模型AI实验平台场景描述AI研究团队需要快速测试不同模型在特定任务上的表现比较响应质量、速度和成本。传统方法需要为每个模型搭建独立环境配置复杂且难以统一比较。解决方案利用ZeroClaw的可插拔提供商架构同时配置多个LLM端点OpenAI、Anthropic、Claude、本地Ollama等。通过统一的CLI接口向不同模型发送相同提示收集并比较响应。内置的基准测试工具可测量响应时间、令牌使用和成本。记忆系统记录每次实验的详细参数和结果支持后续分析。隧道功能使远程团队成员也能访问实验平台。实施效果模型切换时间从小时级缩短到秒级提高实验迭代速度统一比较框架提供客观的性能、质量和成本数据实验记录完整可追溯支持复现和深入分析团队协作效率提升共享实验平台减少环境差异实例4智能家居中央控制大脑场景描述现代智能家居包含数十种设备灯光、温控、安防、娱乐等但控制界面分散自动化规则复杂难配置。用户需要自然、统一的交互方式管理整个家居环境。解决方案在家庭服务器或专用硬件上部署ZeroClaw配置“管家”人格。通过Webhook通道集成家庭自动化平台Home Assistant、OpenHAB等。语音接口通过Telegram语音消息或专用硬件实现。助手学习家庭成员的习惯偏好自动调整环境设置。完全自主模式在用户外出时处理安防警报。记忆系统记录设备状态历史优化能源使用。实施效果控制统一性提升一个入口管理所有智能设备个性化体验增强家居环境自适应家庭成员偏好能源效率优化基于使用模式智能调整设备状态安防响应自动化及时处理异常情况实例5教育机构编程学习助手场景描述计算机科学课程中学生需要大量编程练习和即时反馈。教师资源有限难以提供个性化指导。传统在线判题系统只检查正确性缺乏解释和教学指导。解决方案在实验室计算机上部署ZeroClaw配置为监督自治模式。学生通过CLI或Web界面提交代码问题助手分析代码质量、提出改进建议、解释编程概念。记忆系统跟踪每个学生的学习进度和常见错误提供个性化练习推荐。安全沙箱确保学生代码在隔离环境中运行防止系统破坏。教师仪表板汇总班级整体表现。实施效果学生获得7×24小时个性化指导学习效率显著提升教师从重复性代码审查中解放专注于教学设计学习数据分析帮助识别教学难点优化课程内容安全环境允许学生自由实验无系统损坏风险实例6初创公司全能商务助手场景描述资源有限的初创团队需要处理客户支持、市场研究、竞争分析、文档撰写等多方面任务但无法雇佣多个专职人员。传统SaaS工具功能分散集成复杂。解决方案部署ZeroClaw作为团队共享AI助手配置多通道集成Slack团队沟通、WhatsApp客户支持、电子邮件处理。不同部门通过允许列表控制访问权限。助手处理常见客户咨询、竞品信息收集、会议纪要生成、基础代码编写等任务。完全自主模式在非工作时间处理低风险任务。成本控制通过模型优先级路由实现简单查询使用经济模型复杂分析使用高级模型。实施效果运营成本降低AI助手相当于多个初级员工的工作量响应速度提升客户咨询处理时间缩短80%知识集中化团队共享助手的记忆和学习成果可扩展性强业务增长时无需立即增加人力GitHub地址项目地址https://github.com/zeroclaw-labs/zeroclaw项目关键数据截至2026年2月⭐ Stars7.3k持续快速增长 Forks691 Issues13 Pull Requests42️ Watchers49 Contributors2511位贡献者技术栈构成Rust97.9%核心实现Shell1.3%构建和部署脚本其他0.8%文档和资源文件版本状态最新版本v0.1.02026年2月13日发布开发活跃379次提交87个分支测试覆盖1,017个测试用例确保稳定性许可证与治理许可证MIT License安全政策SECURITY.md详细定义漏洞披露流程贡献指南CONTRIBUTING.md规范协作流程代码审查PR工作流和审查员手册确保代码质量社区资源完整文档README.md提供详细使用指南配置示例.env.example展示环境变量设置开发指南CONTRIBUTING.md说明如何添加新提供商、通道、工具等测试套件RUN_TESTS.md指导测试执行集成文档TESTING_TELEGRAM.md等平台特定指南快速参考命令# 开发构建 cargo build # 发布构建 cargo build --release # 运行测试 cargo test # 代码检查 cargo clippy # 格式化代码 cargo fmt项目愿景ZeroClaw不仅仅是一个技术项目更是一场关于AI民主化的运动。通过将企业级AI能力带到10美元的硬件上它打破了资源垄断使个人开发者、小型团队和资源受限组织都能享受先进的AI助手技术。其开源本质和活跃社区确保项目持续进化响应真实世界需求。特别致谢项目维护者向哈佛大学、MIT、Sundai Club等启发机构致谢强调开放知识、开源协作和技术普惠的核心价值观。ZeroClaw诞生于这样的精神土壤并致力于将其传递给全球开发者社区。ZeroClaw代表了AI基础设施发展的一个重要方向在追求强大功能的同时不妥协于效率和可及性。它证明通过精心的架构设计和Rust的性能优势可以在微小的资源占用下提供完整的AI助手能力。随着边缘计算和隐私保护需求的增长这种“小而美”的设计哲学将越来越重要。无论是作为学习Rust和AI系统开发的优秀案例还是作为生产环境部署的实际解决方案ZeroClaw都提供了独特的价值和启示。