ARM 架构盒子零依赖部署 Nullclaw 实践指南

ARM 架构盒子零依赖部署 Nullclaw 实践

硬件环境

采用 ARM 架构迷你主机，典型配置为 4G RAM + 128G ROM，预装 Ubuntu 22.04 LTS。

• 核心架构：ARM 芯片，适合低功耗运行。
• 网络连接：千兆网口，保障实时响应。
• 系统环境：Ubuntu 22.04 LTS。

软件介绍

Nullclaw 是一个基于 Zig 语言编写的轻量级 AI 助手基础设施。其核心特点包括：

• 极致轻量：编译后仅为一个静态二进制文件。
• 超低资源占用：峰值内存占用极低，启动迅速。
• 零依赖部署：无需 Python 环境、无需 Docker 容器，下载即可运行。
• 功能完备：支持多种 AI 模型提供商及通讯渠道。

实战部署

在 Ubuntu 22.04 上部署 Nullclaw 的过程如下。

第一步：获取二进制文件

直接下载对应 ARM 架构的二进制文件。

mkdir -p ~/nullclaw && cd ~/nullclaw
wget https://github.com/nullclaw/nullclaw/releases/latest/download/nullclaw-linux-arm64
chmod +x nullclaw-linux-arm64
./nullclaw-linux-arm64 --version

第二步：初始化配置

使用内置向导进行快速配置，需准备 AI 模型的 API Key。

./nullclaw-linux-arm64 onboard --interactive

按提示输入 API Key，选择模型提供商并设置首选模型。配置文件将生成于 ~/.nullclaw/config.json。

第三步：启动服务

可前台测试或注册为系统服务实现开机自启。

测试运行：

./nullclaw-linux-arm64 agent -m"你好，我是 Nullclaw，请介绍下你自己。"

后台常驻：

./nullclaw-linux-arm64 serviceinstall
sudo systemctl start nullclaw
sudo systemctl status nullclaw

应用场景

1. 家庭私有大脑：接入智能家居系统，通过自然语言控制设备。
2. 个人知识助理：利用混合记忆系统随时问答文档内容。
3. 开发运维助手：监控日志，异常时自动分析并推送通知。
4. 低成本集群节点：组建分布式 AI 集群，分担不同任务。

项目地址

https://github.com/nullclaw/nullclaw