NullClaw：Zig编写的超轻量开源AI智能体运行工具

一、NullClaw是什么

NullClaw是一个以Zig为核心的自主AI助手运行工具，定位为速度最快、体积最小、功能完整的自治AI基础设施。它由NullClaw团队开发并开源，遵循MIT协议，目标是在资源极其有限的环境中提供不打折扣的AI智能体能力，打破“轻量=功能阉割”的行业惯例。

简单说：NullClaw把传统需要数百MB内存、几秒到几十秒启动的AI助手，压缩到678KB文件、≈1MB内存、毫秒级启动，同时保留完整的工具调用、记忆、多通道、多模型、安全沙箱与硬件控制能力。

它面向四类核心用户：

• 系统程序员：需要完全可控、可理解、可审计的代码底座

• 嵌入式/物联网开发者：在树莓派、STM32、Arduino、老旧安卓、路由器上运行AI

• 隐私极客：本地运行、零依赖、最小攻击面、强安全隔离

• 性能狂热者：无法容忍任何冗余开销，追求极致速度与资源效率

NullClaw不是玩具级Demo，而是经过3230+测试用例、约45000行代码、151个源文件工程化实现的生产可用项目，可稳定处理多轮对话、代码调试、文件操作、邮件处理、外设控制、计划任务等复杂工作流。

二、功能特色

1. 极致轻量化：体积、内存、速度三重突破

• 二进制体积：678KB，单文件自包含

• 内存占用：峰值≈1MB

• 启动速度：Apple Silicon <2ms；0.8GHz低频ARM <8ms

• 依赖：几乎为零，仅需系统libc

• 硬件门槛：最低5美元开发板即可流畅运行

2. 全功能不妥协：能力覆盖主流AI助手

• 支持88+AI服务商（OpenAI、Anthropic、Ollama、DeepSeek、Moonshot、Doubao等）

• 支持17+通信通道（Telegram、Discord、Slack、Matrix、IRC、Webhook等）

• 内置30+工具：Shell、文件读写、浏览器、HTTP请求、计划任务、硬件控制

• 混合记忆系统：SQLite+向量检索+Markdown后端，支持长上下文与语义召回

• 多轮对话：100+轮不卡顿、不丢失上下文

• 任务自动化：日程、邮件、代码、检索、演示、周报等工作流

3. 企业级安全：多层沙箱与最小权限

• 沙箱后端：Landlock、Firejail、Bubblewrap、Docker

• 配对验证、加密密钥、显式允许列表、工作区范围限定

• 无后台上传、无数据收集、完全本地优先

• 细权限控制：工具、文件、网络、通道均可白名单管控

4. 全平台可移植：一次编译到处运行

• 架构：x86_64、ARM、RISC-V全支持

• 系统：Linux、macOS、Android（Termux）、嵌入式Linux

• 交叉编译一键完成：zig build -Dtarget=aarch64-linux-musl

• 无虚拟机、无运行时、无框架绑定

5. 高度可扩展：接口化、模块化、虚表设计

• 服务商、通道、工具、记忆、隧道均基于接口虚表

• 新增一种服务商仅需1行代码

• 支持自定义端点、兼容OpenAI接口

• 提供硬件发现、外设管理、迁移工具

6. 开箱即用：命令行友好、一键部署

• 交互式初始化向导：nullclaw onboard --interactive

• 一键对话：nullclaw agent -m "你好"

• 网关服务：nullclaw gateway（默认127.0.0.1:3000）

• 状态检查：nullclaw status / doctor

三、技术细节

1. 语言与编译体系

• 开发语言：Zig 0.15.2（精确版本，强依赖）

• 构建系统：build.zig + build.zig.zon

• 编译模式：ReleaseSmall（极致体积优化）

• 产物类型：静态链接单二进制

• 内存管理：手动+池化分配，无GC、无运行时开销

2. 核心架构

• 内核层：分配器、并发、日志、配置

• 接口层：虚表驱动（Provider/Channel/Tool/Memory/Tunnel）

• 功能层：AI代理、网关、任务调度、安全沙箱、硬件对接

• 扩展层：自定义技能、MCP、外设驱动、数据迁移

3. 记忆系统（Hybrid Memory）

• 存储：SQLite（结构化）+向量嵌入（语义）+Markdown（可读）

• 能力：语义检索、上下文持久化、多会话隔离、跨设备迁移

• 资源开销：极低，适合边缘环境

4. 安全体系

• 沙箱：强制最小权限，阻止越权文件/网络访问

• 密钥：加密存储，不明文落地

• 配对：设备间可信绑定

• 审计：状态可观测、行为可诊断

5. 硬件支持

• 自动发现：Arduino、STM32/Nucleo、RPi

• 通用外设接口：GPIO、串口、I2C、SPI等

• 无OS适配：面向深度嵌入式环境裁剪

6. 性能基准（同类对比）

四、应用场景

1. 边缘计算与物联网

• 树莓派、香橙派、老旧路由器运行本地AI助手

• 工业工控机、无人设备、智能硬件内置AI大脑

• 农业/环境/安防边缘节点自动决策

2. 隐私敏感场景

• 本地代码助手、文档处理、邮件总结，不上传数据

• 企业内网、涉密环境、无网区域可用

• 个人隐私数据完全自持，不依赖第三方云

3. 嵌入式与单片机生态

• Arduino/STM32/ESP32搭载轻量化AI逻辑

• 可穿戴设备、智能传感器本地推理

• 超低功耗设备7×24小时运行

4. 开发与运维效率

• 命令行AI助手：查问题、写脚本、查日志、做诊断

• 自动化工作流：周报、邮件、监控、部署

• 多渠道统一入口：Telegram/Discord/Webhook集中控制

5. 教学与研究

• 学习Zig系统编程、内存安全、接口抽象

• 研究AI智能体架构、沙箱安全、边缘部署

• 轻量可复现的实验平台

五、使用方法

1. 环境准备

必须安装：Zig 0.15.2

zig version # 必须输出 0.15.2

2. 克隆与编译

git clone https://github.com/nullclaw/nullclaw.git
cd nullclaw
zig build -Doptimize=ReleaseSmall

编译产物：zig-out/bin/nullclaw

3. 快速初始化

# 交互式向导
nullclaw onboard --interactive

# 快速配置
nullclaw onboard --api-key sk-xxx --provider openrouter

4. 常用命令

• 单次对话

nullclaw agent -m "帮我写一个备份脚本"

• 交互式对话

nullclaw agent

• 启动网关服务

nullclaw gateway
nullclaw gateway --port 8080

• 状态检查

nullclaw status
nullclaw doctor
nullclaw channel status

5. 配置与扩展

• 配置文件：~/.nullclaw/config.json

• 示例配置：config.example.json

• 扩展接口：遵循AGENTS.md协议，新增Provider/Channel/Tool只需实现虚表

六、常见问题解答（FAQ）

NullClaw和OpenClaw是什么关系？

同愿景、不同路线。OpenClaw是功能全面的“瑞士军刀”，NullClaw是极致轻量的“手术刀”，NullClaw在体积、内存、速度上全面突破，适合资源受限环境。

NullClaw真的只有678KB吗？会不会功能很少？

确实只有678KB静态二进制。功能完整度极高：支持88+模型、17+通道、30+工具、混合记忆、沙箱、硬件外设，日常与生产场景完全够用。

运行NullClaw需要什么配置？

最低配置：0.8GHz单核、1MB内存、5美元开发板。主流PC、服务器、树莓派、安卓手机都能流畅运行。

必须会Zig才能用吗？

不需要。普通用户下载二进制、一键初始化即可使用。只有二次开发、扩展接口才需要Zig。

支持国内大模型吗？比如字节、阿里、腾讯、DeepSeek、Moonshot、Doubao？

支持。项目已兼容大量国内与国际服务商，可直接配置使用。

数据会上传到第三方吗？

默认本地优先。你可以完全使用本地模型（Ollama等），所有密钥与数据存在本地，无强制上传、无数据收集。

可以在无网络环境使用吗？

可以。只要搭配本地大模型（如Ollama运行Llama3/Qwen），即可完全离线运行。

Windows系统可以运行吗？

核心支持Linux/macOS/ARM Linux。Windows可通过WSL、Docker运行，原生版本在规划中。

如何添加自定义AI服务商？

非常简单。项目采用单表架构，新增服务商通常只需要在对应列表添加1行配置，编译即可生效。

NullClaw可以用来做商业产品吗？

可以。协议为MIT，非常宽松，允许商用、修改、分发，只需保留版权声明。

启动报错“版本不匹配”怎么办？

请严格使用Zig 0.15.2。高版本（如0.16-dev）可能存在语法不兼容。

如何把NullClaw部署到树莓派？

在PC交叉编译：zig build -Dtarget=aarch64-linux-musl -Doptimize=ReleaseSmall，然后把二进制传到树莓派直接运行。

NullClaw支持多轮对话和长上下文吗？

支持。内置混合记忆系统，可稳定保持100+轮对话不丢失上下文。

工具调用安全吗？会不会误删文件？

安全。内置多层沙箱与白名单机制，默认最小权限，可精确控制文件、目录、网络、命令访问范围。

七、相关链接

• GitHub仓库：https://github.com/nullclaw/nullclaw

• 官方文档站：https://nullclaw.github.io

八、总结

NullClaw是一款以Zig语言打造、面向极致资源受限环境设计的全功能自主AI助手运行时，凭借678KB超小体积、≈1MB内存占用、毫秒级启动速度、全平台静态二进制、企业级沙箱安全、88+AI服务商兼容、30+工具链与多通道接入能力，重新定义轻量AI智能体的上限，它不做功能妥协、不依赖重型运行时、不牺牲安全与扩展，既可运行于5美元边缘硬件，也能部署在服务器与嵌入式设备，为隐私极客、嵌入式开发者、物联网玩家、性能狂热者提供真正零负担、全可控、生产可用的轻量化AI基础设施，是当前开源界体积最小、速度最快、资源占用最低的完整AI智能体方案之一。