ZeroClaw安装踩坑总结：Rust编译、Matrix依赖、飞书功能全记录

ZeroClaw是用Rust编写的AI助手框架，内存占用仅32MB（OpenClaw约393MB），适合多实例和资源受限环境。但源码安装有几个坑需要绕开。

ZeroClaw简介

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

对比	ZeroClaw	OpenClaw
语言	Rust	Go
内存占用	~32MB	~393MB
生态	不够完善	成熟健全
适用场景	多实例/资源受限	通用场景

当前内存价格高企，资源占用低的优势更加明显。不足是生态没有OpenClaw完善。

安装方式

官方提供四种方式：

方式	命令	说明
一键脚本	官方脚本	最简单，但不带飞书连接功能
Homebrew	brew install	macOS用户推荐
源码编译	cargo build --release	全功能安装首选
Docker	容器部署	适合服务器

所需全功能安装（特别是飞书集成），直接选择源码编译。

踩坑一：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。

内网环境Web界面配置：修改 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	326b60d1

内存占用实测

进程	内存
zeroclaw	2.3 MB RSS
zeroclaw-daemon	20.1 MB RSS
zeroclaw-gateway	2.3 MB RSS
OpenClaw总计	~393MB
ZeroClaw总计	~32MB

总结

问题	解决方案
Rust版本太旧	rustup default 1.94.1
matrix-sdk编译溢出	降级到 =0.14.0
飞书功能未启用	编译加 --all-features

ZeroClaw以32MB内存运行AI助手，在资源受限场景下是OpenClaw的有力替代方案，但安装时需要绕过这几个坑。

---

关键词：ZeroClaw, ZeroClaw安装, Rust编译, AI助手框架, matrix-sdk, 飞书集成, 源码编译