人工智能AI Agent大模型自主智能体工具调用RAGAgent 记忆MCP Clients【免费下载链接】nullclawFastest, smallest, and fully autonomous AI assistant infrastructure written in Zig项目地址https://gitcode.com/gh_mirrors/nu/nullclaw点击查看免费下载本文以 NullClaw 官方中文安装文档docs/zh/installation.md为骨架系统覆盖 Homebrew 二进制、官方 OCI 容器镜像、Zig 源码构建与 Android/Termux 四种主流安装路径并结合仓库内的 Dockerfile、docker-compose.yml、build.zig 等源码级实现展开说明。读完本文你将能根据自身平台选对安装方式、完成安装验证并掌握升级、卸载与 PATH 配置的完整闭环。前置要求精确锁定 Zig 0.16.0 与 Git安装前只需确认两样东西Zig 0.16.0精确版本仅源码构建需要NullClaw 的构建脚本固定在 Zig 0.16.0 上。版本不一致会直接导致构建失败典型报错是build.zig.zon中出现expected string literal这通常不是源码问题而是 Zig 版本不匹配。Debian 系统的手动安装步骤见 Zig 安装指南。Git源码安装需要克隆仓库。检查 Zig 版本zig version输出必须是0.16.0。从构建脚本 build.zig 可以印证这一点CI 与容器构建通过.github/scripts/install-zig.sh下载并校验指定版本的 Zig并在构建前执行test $(zig version) 0.16.0硬校验见 Dockerfile。同时build.zig还会在启用 SQLite 时对vendor/sqlite3/下的文件做 SHA-256 完整性校验build.zig版本不对时解析build.zig.zon会直接报错。如果你是在全新的 Debian 上准备源码构建可参考 Zig 安装指南 的手动安装路径apt update后安装ca-certificates wget xz-utils从 Zig 官方发布页下载zig-x86_64-linux-0.16.0.tar.xz用官方校验和验证压缩包解压后将其加入PATH最后用zig version确认输出为0.16.0。方式一使用预编译二进制适合不想接触 Zig toolchain、只想尽快跑起来的用户。HomebrewmacOS / Linux 推荐brew install nullclaw nullclaw --help如果nullclaw命令可用说明安装成功。Homebrew 直接安装预构建包本机完全不需要 Zig toolchain。Windows从发布页下载 zip从发布页下载 Windows.zip压缩包并解压后即可直接在命令行中运行其中的nullclaw.exe。检查版本号x:\path\nullclaw.exe --version方式二官方容器镜像Docker / Podman镜像与持久化目录约定NullClaw 提供官方 OCI 镜像ghcr.io/nullclaw/nullclaw。容器内持久化目录统一放在/nullclaw-data配置文件/nullclaw-data/config.json工作区/nullclaw-data/workspace镜像自带的初始配置已使用当前配置结构agents.defaults.model.primary与models.providers因此在你填入 provider 凭证之前latest标签也应能正常启动。从 Dockerfile 可以看到镜像内置的初始config.json内容{ agents: { defaults: { model: { primary: openrouter/anthropic/claude-sonnet-4 } } }, models: { providers: { openrouter: {} } }, gateway: { port: 3000, host: ::, allow_public_bind: true } }也就是说镜像在首次启动时即可解析出默认模型路由只差一个 provider 凭证。运行时默认以非 root 用户uid/gid 65534执行Dockerfile镜像声明EXPOSE 3000、ENTRYPOINT [nullclaw]默认命令为gateway --port 3000 --host ::Dockerfile容器内的NULLCLAW_HOME/nullclaw-data、NULLCLAW_WORKSPACE/nullclaw-data/workspace环境变量保证了配置与工作区始终落在持久化卷上。单次命令docker run查看状态docker run --rm -it \ -v nullclaw-data:/nullclaw-data \ ghcr.io/nullclaw/nullclaw:latest status交互式初始化配置docker run --rm -it \ -v nullclaw-data:/nullclaw-data \ ghcr.io/nullclaw/nullclaw:latest onboard --interactive运行交互式 agentdocker run --rm -it \ -v nullclaw-data:/nullclaw-data \ ghcr.io/nullclaw/nullclaw:latest agent运行 HTTP gateway将容器 3000 端口发布到宿主机回环地址docker run --rm -it \ -p 127.0.0.1:3000:3000 \ -v nullclaw-data:/nullclaw-data \ ghcr.io/nullclaw/nullclaw:latest注意-it与--rm组合适合单次交互长期运行场景建议用下面的 Compose 方式以便获得服务化重启与健康检查。Docker Compose仓库根目录自带 docker-compose.yml默认直接使用官方镜像可通过NULLCLAW_IMAGE覆盖。交互式初始化docker compose --profile agent run --rm agent onboard --interactive在官方容器流程里workspace 提示直接回车即可保留挂载卷里的默认路径工作区/nullclaw-data/workspace。交互式 agent 会话docker compose --profile agent run --rm agent长期运行 gatewaydocker compose --profile gateway up -d gatewayProfile 含义agent一次性的交互式 CLI 容器gateway长期运行的 HTTP gateway默认发布到宿主机回环地址3000从 docker-compose.yml 的源码可以看到几个对部署很有用的细节init-data服务会在 agent / gateway 启动前初始化/nullclaw-data/workspace目录并修正属主docker-compose.ymluid/gid 可通过NULLCLAW_UID/NULLCLAW_GID覆盖默认 65534即镜像内非 root 用户。gateway 服务默认监听0.0.0.0:3210同时通过${NULLCLAW_BIND:-127.0.0.1}:${NULLCLAW_PORT:-3210}控制发布地址——即默认只发布到宿主机回环地址端口可通过NULLCLAW_PORT覆盖docker-compose.yml。gateway 服务带 healthcheck通过wget http://127.0.0.1:${NULLCLAW_PORT:-3210}/health每 30 秒探测一次docker-compose.yml。挂载卷包括命名卷nullclaw-data与宿主机./workspace目录方便直接查看工作区产出docker-compose.yml。如果你需要局域网或公网访问请显式修改发布地址并先阅读 安全指南官方默认绑定回环地址是有意为之的安全默认值。如果你要固定版本标签或者以后切换到其他镜像仓库可以覆盖NULLCLAW_IMAGENULLCLAW_IMAGEghcr.io/nullclaw/nullclaw:v2026.3.11 docker compose --profile gateway up -d gateway仓库 Makefile 还提供了一组与 Compose 对应的快捷目标make build、make config等价于onboard --interactive、make up、make down、make run、make agent、make status、make shell、make logs。其中镜像构建目标默认使用releaseDocker target若想以 root 身份运行明确的自主模式 opt-in可执行make build DOCKER_TARGETrelease-root IMAGEnullclaw:root对应 Dockerfile 中的release-root阶段。方式三源码构建通用git clone https://gitcode.com/gh_mirrors/nu/nullclaw cd nullclaw zig build -DoptimizeReleaseSmall zig build test --summary all构建产物zig-out/bin/nullclawzig build test --summary all会运行整套测试compat 测试、库测试与可执行文件测试见 build.zig建议提交前或升级后跑一遍确认环境正常。几个值得了解的源码级事实-DoptimizeReleaseSmall是官方文档推荐的优化模式。非 Debug 优化下构建脚本会自动开启strip、关闭 unwind tables 与 frame pointer以进一步缩小二进制build.zig。构建选项-Dchannels用于裁剪渠道token 为all|none|cli|telegram|discord|slack|whatsapp|matrix|mattermost|irc|imessage|email|lark|dingtalk|wechat|weixin|wecom|line|onebot|qq|maixcam|signal|nostr|web|max默认allbuild.zig。构建选项-Dengines用于选择 memory 引擎token 为base|minimal|all|none|markdown|memory|api|sqlite|lucid|redis|lancedb|postgres|clickhouse|kg默认base,sqlitebuild.zig。选择sqlite/lucid/lancedb/kg会自动拉起 vendored SQLite 及其校验。如需静态链接可加-Dstatic-Dembedded_wasm3默认开启可传-Dembedded_wasm3false关闭内嵌 wasm3 运行时-Dversionv可把自定义版本串嵌入二进制build.zig版本字符串最终通过 src/version.zig 暴露给--version输出。方式四Android / Termux在移动端有三种常见路径直接下载官方发布的 Android / Termux 预构建二进制在手机上的 Termux 里原生构建在另一台机器上交叉编译 Android 二进制官方 release 提供aarch64、armv7、x86_64的 Android / Termux 预构建二进制。更完整的说明和排错见 Termux 指南。Termux 原生构建pkg update pkg install git zig git clone https://gitcode.com/gh_mirrors/nu/nullclaw cd nullclaw zig version zig build -DoptimizeReleaseSmall ./zig-out/bin/nullclaw --help说明必须使用Zig 0.16.0如果zig build一开始就失败先确认 Zig 版本。Termux 原生构建使用当前环境的 native target通常不需要手动传-Dtarget。在 Android / Termux 上建议先跑前台命令如agent、gateway确认没问题后再考虑后台托管前台验证可用./zig-out/bin/nullclaw agent与./zig-out/bin/nullclaw gateway --host 127.0.0.1 --port 3001。低依赖构建路径如果 SQLite 的拉取或构建在 Termux 里失败先走轻量引擎集zig build -DoptimizeReleaseSmall -Denginesbase-Denginesbase包含markdown,memory,api,none不依赖 SQLite对应 build.zig 中的enableBase()。对内存和依赖都更紧的 Android 设备这通常是更稳妥的第一步也可以显式指定-Denginesmarkdown,memory。常见错误build.zig.zon提示expected string literal。这类报错最常见原因是 Zig 版本不对而不是 NullClaw 源码本身有问题。排查顺序运行zig version→ 确认输出是0.16.0→ 不是就先替换 Zig 再重新构建。不要为了兼容旧 Zig 去本地修改build.zig.zon——项目当前就固定在 Zig 0.16.0。为 Android 交叉编译如果你在另一台机器上给 Android / Termux 设备构建需要显式传入 Zig target并提供 Android 的 libc/sysroot 文件只传-Dtarget还不够zig build -Dtargetaarch64-linux-android.24 -DoptimizeReleaseSmall --libc /path/to/android-libc-aarch64.txt常见 Android targetsaarch64-linux-android.24arm-linux-androideabi.24配合-Dcpubaselinev7ax86_64-linux-android.24选择与目标手机或模拟器架构匹配的 target。从 build.zig 可以确认构建脚本对 Android ABI 有强制环境检查除非设置了TERMUX_VERSION或通过--libc或ZIG_LIBC传入 libc/sysroot 文件否则会在配置阶段直接报错退出。完整的--libc文件生成示例可参考 .github/workflows/release.yml。官方 release 也附带基于 Android API 24 构建的对应二进制。将二进制加入 PATH使用编译后的二进制文件macOS / Linuxzsh / bashzig build -DoptimizeReleaseSmall -p $HOME/.local echo export PATH$HOME/.local/bin:$PATH ~/.zshrc # bash 用户改为 ~/.bashrc source ~/.zshrc-p $HOME/.local会把zig-out/bin/nullclaw安装到~/.local/bin与 Homebrew 的~/.local约定保持一致。WindowsPowerShellzig build -DoptimizeReleaseSmall -p $HOME\.local $bin $HOME\.local\bin $user_path [Environment]::GetEnvironmentVariable(Path, User) if (-not ($user_path -split ; | Where-Object { $_ -eq $bin })) { [Environment]::SetEnvironmentVariable(Path, $user_path;$bin, User) } $env:Path $env:Path;$bin直接使用下载的二进制文件Windows从发布页下载 Windows.zip压缩包并解压后可在管理员权限的 PowerShell 中执行如下命令将nullclaw.exe所在目录加入 Windows 的PATH环境变量机器级$old [Environment]::GetEnvironmentVariable(Path, Machine) $new $old;x:\path\to\nullclaw [Environment]::SetEnvironmentVariable(Path, $new, Machine)安装验证无论采用哪种方式安装完成后都建议按顺序执行三连nullclaw --help nullclaw --version nullclaw status若status能正常输出组件状态说明安装与运行环境基本可用。更完整的首次启动验证流程onboard --interactive→agent -m 你好nullclaw→gateway见 使用与运维想要按子命令逐一核对见 命令参考。升级与卸载使用二进制文件HomebrewmacOS / Linux 推荐brew update brew upgrade nullclaw brew uninstall nullclawWindowsCMD升级nullclaw update该命令还支持--check仅检查、--yes自动确认见 命令参考卸载直接删除nullclaw二进制文件检查系统变量 PATH若存在就将 nullclaw 二进制文件的所在目录从中删除。源码安装升级git pull后重新执行zig build -DoptimizeReleaseSmall再按需重跑zig build test --summary all做回归验证。卸载删除安装位置中的nullclaw二进制并移除 PATH 配置行。下一步安装完成只是起点建议按官方文档路径继续要开始初始化配置继续看 配置指南先生成可运行的config.json。要快速跑通一遍继续看 使用与运维按首次启动流程验证安装结果。要核对 CLI 命令继续看 命令参考确认onboard、agent、gateway等入口。相关页面 中文文档入口 · Termux 指南 · 配置指南 · 使用与运维 · 命令参考赞分享人工智能AI Agent大模型自主智能体工具调用RAGAgent 记忆MCP Clients【免费下载链接】nullclawFastest, smallest, and fully autonomous AI assistant infrastructure written in Zig项目地址https://gitcode.com/gh_mirrors/nu/nullclaw点击查看免费下载相关推荐NullClaw 安装完全指南macOS、Linux、Windows 与 Android/Termux 四路径实战NullClaw 安装完全指南macOS、Linux、Windows 与 Android/Termux 四路径实战 本篇指南完整覆盖 NullClaw 在主流人工智能AI Agent大模型自主智能体工具调用RAGAgent 记忆MCP ClientsAgent 沙箱多智能体语音TDgpt 安装部署完全指南Docker、云服务与 Linux/Windows 安装包实战TDgpt 安装部署完全指南Docker、云服务与 Linux/Windows 安装包实战 TDgpt 是 TDengine 内置的时序数据分析智能体通过外数据库时序数据库大数据物联网云原生NNI 安装完全指南Linux/macOS/Windows 与 Docker 多方式部署及验证NNI 安装完全指南Linux/macOS/Windows 与 Docker 多方式部署及验证 本文是面向 NNINeural Network Intell人工智能AutoML机器学习深度学习模型压缩特征工程上一篇RuoYi-Vue Pro 架构指南单体还是微服务如何按需裁剪模块下一篇ffmpeg-python视频技术前瞻下一代处理平台创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
