打造个人助手,ZeroClaw安装踩坑总结
ZeroClaw 是用 Rust 编写的 AI 助手框架,主要特点是运行时资源占用更低、依赖更少。
在实际运行中,我当前环境的占用情况是:OpenClaw 约 393MB, ZeroClaw 约 32MB。
在多实例运行、资源受限环境是不错的选择,当前内存价格高企,资源占用低的优势更加明显 。当然另一方面不足是生态没有OpenClaw完善。
安装方式
官方提供了几种方式:
- 一键脚本
- Homebrew
- 源码编译
- Docker
这不是我第一次安装 ZeroClaw。使用官方的一键脚本,安装简单,但是安装完没有带飞书连接功能。所以我直接选择源码编辑全功能安装。
从源码安装,流程本身不复杂,但在实际环境中会遇到几个问题。安装步骤为克隆源码,运行cargo命令编译安装。遇到主要问题如下:
问题一:Rust 版本与依赖不匹配
运行编译命令时报错:
error: rustc 1.85.1 is not supported by the following packages:
cobs@0.5.1 requires rustc 1.87
matrix-sdk@0.16.0 requires rustc 1.88
这是当前环境下依赖链对 Rust 版本的要求。解决方式:
rustup update
rustup default 1.94.1
验证:
rustc --version
# rustc 1.94.1 (e408947bf 2026-03-25)
问题二:matrix-sdk 编译失败(递归深度)
编译 matrix-sdk 0.16.0 时出现:
error: queries overflow the depth limit!
尝试过以下方式均未解决。
- 设置
RUSTFLAGS="-C recursion-limit=256" - 修改源码增加 recursion_limit
最终处理方式,修改Cargo.toml降级依赖版本,降级后编译通过。
[dependencies]
matrix-sdk = "=0.14.0"
问题三:飞书功能未启用
默认编译命令:
cargo build --release
编译可以通过,但飞书功能不会被包含。
解决方式:显式启用 feature,build与install均需指定。
cargo build --release --all-features
cargo install --path . --all-features
初始化配置
zeroclaw onboard --interactive
时区配置,国内时区,选择 Other (type manually),直接输入:Asia/Shanghai。
内网环境Webl界面可以不使用配对码,直接修改配置文件config.toml:
[gateway]
host = "0.0.0.0"
port = 42617
allow_public_bind = true
require_pairing = true
如果是公网环境,不建议直接放通服务,需要通过额外方式做访问控制,这里不展开。个人一般通过其他方式访问内网,再通过内网访问内部服务。
启动方式
zeroclaw daemon:完整功能,包含聊天通道zeroclaw gateway:仅网关
安装版本信息
- ZeroClaw:0.1.9
- rustc:1.94.1
- cargo:1.94.1
- 分支:main
- commit:326b60d1aa222a93a6a0917a663ba73fe8bc1552
内存占用实测
OpenClaw:
- openclaw (PID 213): 1.5 MB RSS
- openclaw-monitor (PID 214): 2.2 MB RSS
- openclaw-gateway (PID 354): 355.4 MB RSS
ZeroClaw:
- SCREEN -R zeroclaw (PID 299131): 2.2 MB RSS
- zeroclaw daemon (PID 299453): 32.0 MB RSS
总计约 393.3 MB RSS(OpenClaw) vs 32 MB(ZeroClaw)。