自建ZeroClaw折腾指南

前言

Zeroclaw仍在高速迭代中，因此本教程中的指南可能已经过时。请善用AGI工具，这应该比任何博客类文章具备更好的时效性和灵活性。

架构

Zeroclaw支持非常多的Channel，国内的话支持Feshu/QQ bot/DingTalk，但是我不是很喜欢做这种比较容易被封号的Channel。所以一番折腾下来选择了 Matrix 作为主要的通讯桥梁。

之所以选 Matrix，是因为它不仅开源去中心化，而且对 Bot 非常友好，配合 Rust 编写的 Zeroclaw，简直是性能与隐私的完美结合。

相关配置方案：

• 服务端搭建：[[自建Matrix服务器]]
• 图形化管理：[[配置 Synapse-Admin 管理面板]]

关于Zeroclaw：Rust is all you need

经常看到微信文章《放弃Openclaw，拥抱PicoClaw》（只是举个例子），如果你认为在低性能的设备上运行openclaw是非常有必要的，那你的选择一定会导向Zeroclaw——Rust神力保证了非常低的性能开销。下面我直接引用官方仓库的表格：

Local machine quick benchmark (macOS arm64, Feb 2026) normalized for 0.8GHz edge hardware.

开始准备

服务器选择

这里我购买了阿里云的学生优惠服务器，羊毛薅爽x。
当然事后证明zeroclaw对性能的要求实在低，这台服务器性能过剩了被我拿来干了很多别的x

预编译

据说安装"龙虾"至少要花费三个小时再折腾上2333.一键安装时，在低性能的服务器上跑编译简直是灾难——所以我是走的先本机编译再推送到云端的方法。

本机WSL配置与D盘安装

首先在Windows上安装WSL2：

wsl --install

如果你不想走 Microsoft Store，也可以直接从 Ubuntu 官网下 .wsl 镜像再安装。这条路我更喜欢，文件来源清楚，版本也能自己控。

从 Ubuntu 官网下载 WSL 镜像（手动安装）

Ubuntu 官方下载入口：

• https://ubuntu.com/desktop/wsl
• https://ubuntu.com/download/wsl

截至 2026-04-01，下载页给出的 LTS 镜像是 Ubuntu 24.04.4（amd64 / arm64 两个架构）。
Windows 大多数机器都是 amd64，ARM 设备（比如骁龙 X Elite）选 arm64。

用 PowerShell 下载（示例是 amd64）：

mkdir D:\wsl-image -Force
cd D:\wsl-image
curl.exe -L -o ubuntu-24.04.4-wsl-amd64.wsl https://releases.ubuntu.com/noble/ubuntu-24.04.4-wsl-amd64.wsl

下载后有两种安装方式，任选一种：

1) 双击 .wsl 文件，按提示安装。
2) 命令行安装（我自己更常用这个）：

wsl --install --from-file .\ubuntu-24.04.4-wsl-amd64.wsl

安装完成后先确认发行版名称：

wsl -l -v

后面你要迁移到 D 盘时，wsl --export 和 wsl --unregister 里的发行版名字，按这里查到的实际名称写，别盲填 Ubuntu。

安装完成后，为避免占用C盘空间，将WSL发行版迁移到D盘。导出当前发行版(参考这篇文章)[https://zhuanlan.zhihu.com/p/509079404]：

wsl --export Ubuntu D:\wsl-backup\ubuntu.tar
wsl --unregister Ubuntu

从备份恢复到D盘：

wsl --import Ubuntu D:\wsl D:\wsl-backup\ubuntu.tar

启动WSL并验证路径：

wsl
df -h

在WSL中安装Rust工具链：

curl https://sh.rustup.rs | sh
source $HOME/.cargo/env

克隆ZeroClaw仓库并编译：

git clone https://github.com/zeroclaw-labs/zeroclaw/
cd zeroclaw
cargo build --release

编译完成后的二进制文件位于 target/release/ 目录，使用scp或其他工具传输到服务器即可。