ZeroClaw 是一款基于Rust构建的轻量级 AI 助手基础设施，以Trait 驱动架构为核心，将模型 Provider、通信 Channel、工具 Tool、内存 Memory 等核心能力全部抽象为可插拔接口，真正实现零厂商锁定——OpenAI、Claude、本地 Ollama 等 AI 模型，Telegram、Discord 等交互渠道，均可一键无缝切换，无需修改核心代码。
作为主打极致性能与低资源占用的 AI 基础设施，ZeroClaw 编译为单二进制文件，运行内存占用低于 5MB，冷启动速度快至 10ms 内，即便在 10 美元级廉价硬件上也能流畅运行，比同类方案节省超 98% 部署成本。它内置守护进程、自动故障恢复、安全沙箱三重防护，同时支持 OpenClaw 无痛迁移，兼顾稳定性与安全性。
定位为生产级 Agent 操作系统，ZeroClaw 彻底打破传统 AI 助手 “脚本工具” 的局限。它以模块化架构为基础，让 AI 助手从零散的功能组件，进化为可运维、可监控、可扩展的企业级服务，助力企业快速构建自主可控、高效灵活的智能体体系。
ZeroClaw的主要功能
基于 Rust Trait 接口设计，模型、渠道、工具、内存等核心模块均支持一键替换，改配置即可切换组件，无需改动代码，灵活适配不同业务场景。
单二进制文件仅约 8.8MB，内存占用低于 5MB，冷启动时间小于 10 毫秒，低配硬件（如树莓派）也能流畅运行。
支持 OpenAI、Claude、DeepSeek、Ollama 等主流 AI 服务商一键切换，彻底摆脱平台绑定，随心选择适配模型。
内置 Telegram、Discord、Slack、WhatsApp、邮件等 70 余种通讯渠道集成，多端触达用户，沟通无限制。
基于 SQLite 构建混合搜索引擎，融合向量相似度与 BM25 关键词检索，无需依赖 Pinecone、Elasticsearch 等外部工具，数据存储与检索更高效。
采用显式白名单授权、文件系统隔离、符号链接逃逸检测，默认拒绝访问敏感路径，从源头保障数据与系统安全。
内置 Supervisor 自动重启、Cron 定时任务调度，支持 systemd 和 OpenRC 服务托管，7×24 小时稳定运行，运维更省心。
Webhook 服务默认本地绑定，6 位一次性配对码验证，有效防止未授权访问，守护接入安全。
提供 doctor、status、channel doctor 等诊断命令，一键排查环境依赖、配置错误等问题，高效定位并解决故障。
如何使用ZeroClaw
ZeroClaw 提供三种轻量化部署方案，适配不同使用场景，全程无复杂依赖：
🏃♂️ 一键安装（推荐）：
- Linux/macOS 用户直接通过一键安装，无需额外配置，秒级完成部署；
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | sh
- Windows用户可下载预编译二进制或通过Docker运行。
🛠️ 源码构建：克隆仓库运行引导脚本，适合需自定义编译的开发者；
📦 预编译二进制：下载对应系统（Linux/macOS/Windows）的预编译包，解压后添加至系统 PATH 即可使用。
配置分两种模式，兼顾效率与灵活性，同时保障 API 密钥安全存储：
- ⚡ 快速配置：执行
zeroclaw onboard命令，传入 API 密钥与 AI 提供商参数（如 OpenRouter、Anthropic、Ollama 等），一键完成核心配置；
- 📝 交互式向导：运行
zeroclaw onboard --interactive，按终端提示逐项设置提供商、模型、渠道信息，适合新手逐环节确认；
- 🔒 安全特性：密钥自动加密存储，避免明文泄露，同时支持仅修复频道 / 白名单的快速补配。
快速启动 AI 交互，支持 CLI 场景快速沟通与持续对话：
- 🗨️ 单次问答：执行
zeroclaw agent -m "你的问题"，一键获取 AI 回复，适合快速查询、简单指令；
- 💬 交互式聊天：直接输入
zeroclaw agent进入对话模式，支持多轮上下文交互，连贯完成复杂任务。
搭建外部消息接入通道，实现 7×24 小时后台常驻，适配生产场景：
- 🌐 开启网关：执行
zeroclaw gateway启动本地 Webhook 服务器，接收外部渠道（Telegram、飞书、Webhook 等）消息；搭配--port 0启用随机端口，提升网关安全性；
- 🛡️ 后台守护：输入
zeroclaw daemon启动后台常驻进程，自动实现故障恢复与定时任务调度，关闭终端也不影响运行；
- ⚙️ 服务托管：执行
zeroclaw service install将进程注册为系统服务，支持 systemd 用户级与 OpenRC 系统级托管，开机自动运行。
内置全链路监控与诊断工具，保障服务稳定运行：
- 📊 运行状态：使用
zeroclaw status实时查看进程运行、资源占用、任务执行状态；
- 🔍 系统诊断：执行
zeroclaw doctor一键扫描系统环境、依赖、配置问题，快速定位异常；
- 📡 渠道健康：输入
zeroclaw channel doctor检查各消息渠道（飞书、钉钉、Webhook 等）连接状态，确保消息收发正常。
实现历史数据迁移与多 AI 订阅无缝对接：
- 🗂️ 数据迁移：运行
zeroclaw migrate openclaw --dry-run预览迁移效果，确认无误后执行正式命令，一键导入 OpenClaw 历史数据与配置；
- 🔑 订阅认证：通过
zeroclaw auth login或zeroclaw auth setup-token，配置 OpenAI Codex、Claude、DeepSeek 等主流 AI 订阅服务的身份凭证，支持加密存储与权限管控。
七. 启动运行
- 前台运行：
zeroclaw agent run
- 后台运行：
zeroclaw agent start
- 查看状态：
zeroclaw status
- 停止运行：
zeroclaw agent stop
八. Docker部署（推荐生产）
docker run -d \
-v ~/.zeroclaw:/root/.zeroclaw \
-p 3000:3000 \
ghcr.io/zeroclaw-labs/zeroclaw:latest gateway
也可使用docker-compose.yml管理多实例。
九、配置文件说明
主配置位于：~/.zeroclaw/config.toml
可配置：
-
- 模型提供商与参数
- 渠道凭证与开关
- 记忆存储路径
- 安全权限策略
- 日志与监控选项
ZeroClaw 凭借Rust 原生架构实现极致轻量化，单二进制体积小巧、跨平台兼容，可在 $10 边缘硬件上运行，同时默认内置沙箱隔离、密钥加密、网关安全等防护机制，是个人开发者与团队搭建 AI Agent 的高效选择。
常见问题解答（FAQ）
ZeroClaw和OpenClaw是什么关系？
ZeroClaw不是OpenClaw的官方版本，也不属于同一组织。它是由社区开发者用Rust从零重写的轻量级实现，定位、架构、代码库完全独立，追求极致轻量化与安全。
ZeroClaw可以在Windows上运行吗？
可以。官方提供Windows预编译二进制包，也支持WSL2与Docker运行，功能与Linux/macOS保持一致。
运行ZeroClaw需要什么配置的机器？
最低配置仅需：单核CPU、64MB内存、100MB磁盘空间。它可以运行在树莓派、廉价VPS、甚至更轻量的边缘设备上。
ZeroClaw支持本地大模型吗？
支持。可通过Ollama、LocalAI等兼容OpenAI接口的本地模型服务接入，实现完全离线运行。
数据会上传到第三方服务器吗？
不会。ZeroClaw默认本地优先，所有对话记录、文件、配置都存储在你自己的设备上，不会主动上传任何数据。
如何添加新的AI模型厂商？
无需修改源码，只需在配置中按规范填写Base URL与API密钥，兼容OpenAI格式的模型均可直接接入。
如何添加新的消息渠道？
官方已内置主流渠道，如需自定义渠道，可基于Channel Trait开发插件，编译后替换即可。
工具调用是否安全？
默认关闭所有高危工具，必须手动在配置中显式开启。Shell等操作受工作区隔离与权限白名单双重限制。
忘记配置密钥或配置损坏怎么办？
可重新执行zeroclaw onboard重新生成配置，原有记忆数据不会丢失。
ZeroClaw支持多智能体吗？
支持。通过多工作区或多配置文件，可同时运行多个独立的智能体，互不干扰。
低资源边缘设备部署：适配树莓派、ARM 开发板等 10 美元级低成本硬件，AI 助手运行内存占用低于 5MB，完美契合物联网终端、边缘计算节点的轻量化部署需求。
高并发 Agent 集群搭建：单台 4GB 配置服务器可稳定运行 200+Agent 实例，相较 OpenClaw 仅能运行 2 个实例的表现，大幅降低云服务器集群部署的硬件成本与运维开支。
自动化运维智能助手：依托 Cron 定时任务与守护进程运行模式，实现服务器状态监控、日志智能分析、数据定时备份等全流程无人值守运维，提升运维效率。
多平台客服机器人搭建：基于可插拔 Channel 架构，一站式接入 Telegram、Discord、Slack、WhatsApp 等主流沟通渠道，实现多平台用户交互的统一管理与响应。
安全敏感环境合规运行：通过显式访问白名单、文件系统隔离、设备配对验证等多重安全机制，可在企业内网、金融、医疗等合规要求严苛的场景中安全稳定运行。
写在最后
ZeroClaw是一款以Rust构建、坚持零开销与安全内置的全自主AI助手基础设施，凭借单文件分发、毫秒级启动、低于5MB内存占用、全架构移植、模块化插拔与强安全隔离，成为轻量化与私有化场景下的最优智能体运行时，它既满足个人用户对隐私与流畅度的需求，也适配企业与边缘设备的生产级要求，以极简架构实现了轻量化、安全性、扩展性三者的无妥协平衡。
