ByteNoteByteNote
NullClaw: Zig 语言打造的极速 AI 助手

字节笔记本

2026年2月22日

NullClaw: Zig 语言打造的极速 AI 助手

API中转
¥120

NullClaw 是一个使用 Zig 语言编写的完全自主 AI 助手基础设施,追求极致轻量化和部署灵活性。它是一个静态二进制文件,仅需 libc 即可运行,能在任何 5 美元的开发板上毫秒级启动。

核心特性

  • 体积极小:678 KB 静态二进制,无运行时/VM/框架开销
  • 内存占用低:~1 MB 峰值 RSS,可在廉价 ARM SBC 上运行
  • 启动极速:<2 ms (Apple Silicon),<8 ms (0.8 GHz 边缘核心)
  • 高度可移植:单文件跨 ARM/x86/RISC-V 架构
  • 功能完整:支持 22+ AI 提供商、13 个通信通道、18+ 工具

架构设计

NullClaw 采用 vtable 接口设计实现高度模块化架构:

  • AI 模型层:Provider 接口,支持 OpenAI、Anthropic、OpenRouter 等 22+ 提供商
  • 通信通道层:Channel 接口,支持 Telegram、Discord、Slack、iMessage、Matrix、WhatsApp 等
  • 内存系统:SQLite + 混合搜索(FTS5 + 向量余弦相似度)
  • 工具集:18 种实现,包括 shell、文件操作、浏览器、硬件控制等
  • 安全沙箱:多层沙箱机制(Landlock、Firejail、Bubblewrap、Docker)

安装与使用

构建

bash
zig build -Doptimize=ReleaseSmall

快速设置

bash
nullclaw onboard --api-key sk-... --provider openrouter

交互模式

bash
nullclaw agent

启动网关

bash
nullclaw gateway

完整自主运行

bash
nullclaw daemon

配置示例

json
{
  "default_provider": "openrouter",
  "models": {
    "providers": {
      "openrouter": { "api_key": "sk-or-..." }
    }
  },
  "memory": {
    "backend": "sqlite",
    "vector_weight": 0.7,
    "keyword_weight": 0.3
  }
}

项目数据

指标数值
⭐ Stars1.8k
🍴 Forks201
主要语言Zig 0.15
代码行数~45,000
测试数量2,843
依赖数量0(除 libc + 可选 SQLite)

适用场景

NullClaw 特别适合以下场景:

  • 边缘计算:在资源受限的边缘设备上部署 AI 助手
  • IoT 设备:在廉价 ARM 单板计算机上运行
  • 嵌入式系统:需要极小体积和快速启动的嵌入式应用
  • 私有化部署:完全自主运行,无需依赖外部服务

项目链接

分享: