摘要：ZeroClaw 是用于搭建个人 AI 助手的开源软件。本文先用"读取笔记，生成选题清单"的例子说明用途，再结合此前在 ESP-Mosaico 上使用 ESP-Claw 的经历，对比两者的运行环境、工具与任务。ESP-Claw 已有个人上手记录；ZeroClaw 尚未本机实测，文中的文件整理和按键灯光任务均为需要配置的用途示意。
1. 先明确装完它是为了做什么
假设你有一个"选题笔记"文件夹，里面存放五份普通文本。你希望有人读完它们，挑出三个适合写给新手的主题，再保存成一份清单。
如果用 ZeroClaw 搭建助手，可以把目标写成一句任务："阅读这五份笔记，列出三个主题，说明每个主题解决什么问题，保存到输出文件夹。"
这里期待交付的是一份新文件，而任务过程可能涉及查找文件、读取内容、归纳比较和写入结果。ZeroClaw 用来组织这个过程：接收任务，让模型判断下一步，按设置调用工具，再将执行结果反馈给模型和用户。
前提是已经给助手连接模型，允许相应文件访问，并提供读写工具。这个例子不是默认自带的一键选题功能，也不代表本机已完成验证。
2. 与 ESP32 上的 ESP-Claw 有什么相似和不同
如果你看过我之前的 ESP-Claw 初体验，理解 ZeroClaw 会容易一些。那次我在 ESP-Mosaico 上完成了固件烧录、配网、模型接入和对话。ESP-Claw 是运行在 ESP32 等乐鑫芯片上的助手框架；它将对话、模型和设备可用能力组织起来。
把场景移到电脑里，可以想到另一类任务：读取项目笔记、查找网页资料、生成文稿并保存。ZeroClaw 可以用于搭建处理这些任务的助手。下面按常见用途对比：
| 对比项 | ESP-Claw | ZeroClaw |
|---|---|---|
| 助手程序的常见运行位置 | ESP32 等乐鑫芯片 | 电脑或服务器 |
| 容易理解的工具对象 | 设备上已适配的按键、灯、传感器等 | 已配置的文件、网页、软件工具等 |
| 用途示例 | 设置"按一下按键，灯闪三次" | 读取五份笔记，保存一份选题清单 |
| 完成示例的条件 | 对应硬件、板级适配、工具和权限 | 可读的笔记、文件工具、目录权限 |
两个例子都需要相应配置，不是此前已经验证完成的演示。它们的共同思路是：接收要求，让模型判断下一步，调用可用工具，再返回结果。区别主要在常见运行环境和任务重心；ZeroClaw 同时提供硬件扩展，具体能力要看实际接入情况。
还要把"助手程序"和"模型计算"分开看。我之前的 ESP-Claw 是由设备联网调用模型；ZeroClaw 也可以连接外部模型服务，或选择自部署模型。程序装在 ESP32 或电脑上，不能据此判断模型也在本地运行。
从这个角度理解，新项目的重点就更清楚了：我想研究的是，能否把之前在设备上接触到的"模型加工具"的工作方式，用于电脑里的资料整理。它们仍是两个独立项目，工具配置、适配和实际效果需要分别验证。
3. 模型、工具和 ZeroClaw 分别负责什么
| 名称 | 用普通话解释 | 在选题任务里负责什么 |
|---|---|---|
| AI 模型 | 理解请求、归纳材料和生成文字的部分 | 比较五份笔记，提出三个主题 |
| 工具 | 实际操作文件或访问网络的能力 | 找到文件、读取内容、写入清单 |
| ZeroClaw | 把接任务、请模型判断和调用工具组织起来的软件 | 让这些步骤按任务和权限设置配合工作 |
这种根据任务调用工具的 AI 助手通常称为 Agent。项目文档把 ZeroClaw 称为 Agent 运行时；初次了解时，可以把这个术语理解为"让这套助手运行和处理任务的软件"。
与其背下术语，不如看结果：助手能否找到正确的文件，清单是否来自这些文件，保存位置是否符合要求。这些都能检查。
4. 按任务输入和结果理解它的能力
4.1 文件资料整理
输入可以是工作记录、项目笔记或几份文本材料，任务可以是提取要点、整理待办或起草说明，输出可以是屏幕上的回答或保存的新文件。
官方工具文档列有文件读取、文件写入和内容搜索工具。实际能处理哪些格式还要看所用工具；不能因此推断任意 PDF、图片和办公文件都能直接读取。第一轮使用纯文本最容易核对。
4.2 网页资料收集
任务可以是"围绕一个主题寻找公开资料，按来源整理要点"。项目提供网页搜索、网页内容获取等工具，需要结合所选服务和网络访问条件配置。
期望结果应包含来源，方便逐条打开核对。助手能找到页面，也不代表材料一定完整、结论一定正确。事实核验仍是内容生产的一部分。
4.3 定时执行重复任务
项目提供定时任务相关工具。可以设计"每周汇总指定文件夹里的文字记录"这类任务，先配置时间、输入位置、输出位置以及允许使用的工具。
这是任务设计方向，不是本文实际运行结果。执行时需要电脑或服务器保持可用，模型服务和相关工具也要可用。
5. 一次文件整理任务可能怎样完成
下面是便于理解的简化过程，具体工具顺序由任务、模型和权限设置决定：
#mermaid-svg-tVWbh9drfRt9LzHc{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tVWbh9drfRt9LzHc .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tVWbh9drfRt9LzHc .error-icon{fill:#552222;}#mermaid-svg-tVWbh9drfRt9LzHc .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tVWbh9drfRt9LzHc .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tVWbh9drfRt9LzHc .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tVWbh9drfRt9LzHc .marker.cross{stroke:#333333;}#mermaid-svg-tVWbh9drfRt9LzHc svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tVWbh9drfRt9LzHc p{margin:0;}#mermaid-svg-tVWbh9drfRt9LzHc .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-tVWbh9drfRt9LzHc .cluster-label text{fill:#333;}#mermaid-svg-tVWbh9drfRt9LzHc .cluster-label span{color:#333;}#mermaid-svg-tVWbh9drfRt9LzHc .cluster-label span p{background-color:transparent;}#mermaid-svg-tVWbh9drfRt9LzHc .label text,#mermaid-svg-tVWbh9drfRt9LzHc span{fill:#333;color:#333;}#mermaid-svg-tVWbh9drfRt9LzHc .node rect,#mermaid-svg-tVWbh9drfRt9LzHc .node circle,#mermaid-svg-tVWbh9drfRt9LzHc .node ellipse,#mermaid-svg-tVWbh9drfRt9LzHc .node polygon,#mermaid-svg-tVWbh9drfRt9LzHc .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tVWbh9drfRt9LzHc .rough-node .label text,#mermaid-svg-tVWbh9drfRt9LzHc .node .label text,#mermaid-svg-tVWbh9drfRt9LzHc .image-shape .label,#mermaid-svg-tVWbh9drfRt9LzHc .icon-shape .label{text-anchor:middle;}#mermaid-svg-tVWbh9drfRt9LzHc .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tVWbh9drfRt9LzHc .rough-node .label,#mermaid-svg-tVWbh9drfRt9LzHc .node .label,#mermaid-svg-tVWbh9drfRt9LzHc .image-shape .label,#mermaid-svg-tVWbh9drfRt9LzHc .icon-shape .label{text-align:center;}#mermaid-svg-tVWbh9drfRt9LzHc .node.clickable{cursor:pointer;}#mermaid-svg-tVWbh9drfRt9LzHc .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tVWbh9drfRt9LzHc .arrowheadPath{fill:#333333;}#mermaid-svg-tVWbh9drfRt9LzHc .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tVWbh9drfRt9LzHc .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tVWbh9drfRt9LzHc .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tVWbh9drfRt9LzHc .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tVWbh9drfRt9LzHc .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tVWbh9drfRt9LzHc .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tVWbh9drfRt9LzHc .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tVWbh9drfRt9LzHc .cluster text{fill:#333;}#mermaid-svg-tVWbh9drfRt9LzHc .cluster span{color:#333;}#mermaid-svg-tVWbh9drfRt9LzHc div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tVWbh9drfRt9LzHc .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tVWbh9drfRt9LzHc rect.text{fill:none;stroke-width:0;}#mermaid-svg-tVWbh9drfRt9LzHc .icon-shape,#mermaid-svg-tVWbh9drfRt9LzHc .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tVWbh9drfRt9LzHc .icon-shape p,#mermaid-svg-tVWbh9drfRt9LzHc .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tVWbh9drfRt9LzHc .icon-shape .label rect,#mermaid-svg-tVWbh9drfRt9LzHc .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tVWbh9drfRt9LzHc .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tVWbh9drfRt9LzHc .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tVWbh9drfRt9LzHc :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 你提出任务：整理五份笔记
模型判断需要哪些信息
检查是否允许读取文件
工具读取指定笔记
模型归纳三个主题
检查写入权限，必要时询问你
工具保存选题清单
返回结果，供你核对
这张图最有用的地方，是把"AI 生成文字"和"电脑实际操作"分开看。模型负责提出内容与操作需求，真正读取和写入由工具完成；工具使用还要经过权限检查。权限检查并不保证内容一定正确，因此输出仍需核对。
6. 第一次使用要准备哪些东西
第一，运行它的设备。ZeroClaw 可以部署在自己的电脑或服务器上。Windows 用户可参考官方安装指南，具体安装方式以当前文档为准。
第二，能调用的 AI 模型。你需要选择模型来源，并完成所需的登录或访问凭证配置。既可以接外部服务，也可以选择自部署模型。外部模型服务可能收费；软件运行在本机也不等于发送给模型的内容始终留在本机。
第三，一小份测试材料。准备两三份普通文本，放入专门的测试文件夹，写明希望得到什么结果。
第四，工具和权限设置。先明确读取哪些目录、是否允许写入、哪些操作需要批准。官方有相应的安全设置，实际限制效果需要按配置验证。
Quickstart 是首次配置向导。初次使用可以先在电脑上发任务，之后再按需接入 Telegram、Discord 等聊天渠道，避免同时排查多个设置环节。
7. 建议用什么标准验收第一次尝试
可以先提出："阅读测试文件夹中的两份文本，各列出三条要点，并标明对应文件名。先不要修改原文件。"
检查的重点是：它有没有读到两份正确文件；要点是否有原文依据；有没有遗漏关键内容；有无访问任务范围以外的文件。
等这个结果可用，再测试保存新文件。之后才考虑网页搜索、定时运行或聊天软件接入。每次增加一项能力，都有一个明确的结果可以核对。
8. 它与内容生产工作流的关系
"发现 GitHub 项目→核对资料→写文章→改编到多平台"包含许多不同工作。ZeroClaw 可以用来搭建其中的 AI 助手，但选题标准、写作要求、来源核对和发布接口仍需另行设计。
最适合先验证的一步，是"给几份已经收集好的资料，生成一份有来源、面向新手的项目介绍"。这个任务的输入可控，结果也容易评估。
ZeroClaw 当前进度是资料研究，还没有安装和执行记录。此前 ESP-Claw 的上手经历用于帮助理解两者的关系。后续 ZeroClaw 实测应记录版本、模型来源、实际可用工具、任务输入、执行过程和输出文件，再讨论使用体验。