打造个人助手,ZeroClaw安装踩坑总结

ZeroClaw 是用 Rust 编写的 AI 助手框架,主要特点是运行时资源占用更低、依赖更少。

在实际运行中,我当前环境的占用情况是:OpenClaw 约 393MB, ZeroClaw 约 32MB。

在多实例运行、资源受限环境是不错的选择,当前内存价格高企,资源占用低的优势更加明显 。当然另一方面不足是生态没有OpenClaw完善。

安装方式

官方提供了几种方式:

  1. 一键脚本
  2. Homebrew
  3. 源码编译
  4. 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!

尝试过以下方式均未解决。

最终处理方式,修改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

如果是公网环境,不建议直接放通服务,需要通过额外方式做访问控制,这里不展开。个人一般通过其他方式访问内网,再通过内网访问内部服务。


启动方式


安装版本信息


内存占用实测

OpenClaw:

ZeroClaw:

总计约 393.3 MB RSS(OpenClaw) vs 32 MB(ZeroClaw)。