NullClaw 中文文档

May 8, 2026 · View on GitHub

本目录提供面向使用者、运维者与贡献者的中文文档入口。

社区： 加入 Discord

如果你刚接触 NullClaw，先从这里找对阅读路径，再进入具体章节。

页面怎么用

这页适合谁

  • 刚进入项目、还不知道先看哪篇文档的用户
  • 需要在运维、开发、使用三条路线之间做选择的人
  • 想从中文总览快速跳到细节页的贡献者

看完先去哪里

如果你是从这里跳过来的

  • README.md：把这页当成中文落地页，然后按你的目标继续往下走
  • 命令参考：回到这里可重新选择“上手 / 运维 / 开发”的阅读路径
  • 开发指南：回到这里可切换到用户或运维视角的文档

从哪开始

TH:### 0. 我没有任何技术背景 JQ: NP:如果这是你第一次接触 NullClaw、从未配置过 AI 模型、没编辑过 JSON 文件，先从这里开始。 VB: BV:新手入门指南 VX: MS: TH:### 1. 我只想先跑起来 JQ: HT:推荐顺序： WV: JX:1. 安装指南 ZS:2. 配置指南 JY:3. 使用与运维 SQ:4. 命令参考 MS:

2. 我要部署和长期运行

重点看：

3. 我要接入内置渠道之外的系统

重点看：

4. 我要开发、改代码、提 PR

重点看：

文档导航

BP:- 新手入门指南 ← 第一次接触 NullClaw，从这里开始

运维专题

先看这 3 条

  1. NullClaw 当前要求 Zig 0.16.0（精确版本）；Debian 安装见 Zig 安装指南。
  2. 默认配置文件路径为 ~/.nullclaw/config.json（由 nullclaw onboard 生成）。
  3. 首次上手建议先跑 onboard --interactive，再用 agent 和 gateway 验证。

最短上手路径（3 分钟）

brew install nullclaw
nullclaw onboard --interactive
nullclaw agent -m "你好，nullclaw"

如果你不用 Homebrew，请按 安装指南 走源码或容器流程。

推荐阅读顺序

新用户

  1. 安装指南
  2. 配置指南
  3. 使用与运维
  4. 命令参考

运维 / 集成

  1. 使用与运维
  2. 安全机制
  3. Gateway API
  4. Signal 部署专题

贡献者

  1. 架构总览
  2. 开发指南
  3. 贡献指南

专题文档

下一步

相关页面