I
用户问题
定位与适用任务nanobot 将文件工具、模型调用、记忆和消息渠道组织成可自托管的 Python Agent。当前文档已经包含 WebUI、终端、长期目标和自动化，因此不能只用早期“很少代码”的印象理解它。更有用的阅读方式是区分共享运行时、会话、项目目录和实例记忆，它们分别决定任务在哪里运行、信息如何保存。
- 在浏览器和终端继续同一份工作
- 把文件摘要、整理与计划任务接到个人工具链
- 阅读 Python Agent 的消息与工具循环
* * *
II
产品机制
能力与工作方式- 共享 GatewayPython gateway 负责执行、会话、工具、记忆与安全策略，WebUI、TUI 和聊天渠道连接同一运行时。关闭一个界面与停止整个服务是不同操作。 原文
- 渠道循环与模型循环分工架构把 AgentLoop 的会话、工作区与消息职责，以及 AgentRunner 的模型和工具循环分开。遇到结果送错渠道和工具调用失败时，可以沿不同源码入口排查。 原文
- Dream 整理长期记忆偏好可以经过整理进入 USER.md 或记忆文件，文档要求检查实际变更。主题隔离聊天历史，但同一实例共享记忆与技能，多个项目并不自动形成客户数据隔离。 原文
- 目标与定时任务长期目标让工作跨模型轮次继续，自动化按指定时间启动工作。两者都依赖运行中的 gateway；后台模式与操作系统开机服务也不是同一个概念。 原文
* * *
III
使用流程
从最小任务开始- 选择稳定版或源码版README 区分稳定发布与当前源码，先按实际用途选择，避免拿源码截图推断已安装版本。准备兼容 Python 与模型访问。
- 打开 WebUI 配置模型运行 nanobot webui，使用终端输出的完整登录链接，在 Settings 中保存模型。登录链接带有凭据，不应公开分享。
- 做一次文件任务在练习目录放一份 notes.txt，选择工作区权限，让助手生成 summary.md。打开真实文件检查，区分附件上传与工作目录选择。
- 验证持续运行新会话检查记忆，再查看 gateway 状态。需要无人值守时按部署文档设置服务，单独测试重启与遗漏计划的处理。
以下试用顺序与检查方法是编辑建议；命令入口依据官方文档，本文未运行项目。 原文
官方入口示例
nanobot webui
nanobot gateway status请先完成上文前置配置；示例不包含真实凭据。
* * *
IV
边界与限制
约束与选用判断| 边界 | 具体含义 | 使用建议 |
|---|---|---|
| 跨项目记忆 | 同一实例的主题和项目不会自动隔离长期记忆。 原文 | 客户或偏好需要隔离时使用独立实例。 |
| 遗漏计划不补跑 | 文档说明 gateway 重启后不会补跑错过的计划时间。 原文 | 重要任务需要检查最近成功记录，另行决定补执行。 |
左右滑动查看完整表格
适合希望自托管并理解内部机制的用户，也适合 Python 开发者研究渠道与工具循环。长期运行仍需要备份、更新与运行状态检查。
* * *
V
怎样判断是否值得采用
试用场景与验收一个有代表性的试用是本地文档整理加后续记忆：先把目录内的一份笔记生成摘要，再要求今后摘要保留“待确认项”。执行记忆整理后检查文件，随后开新主题处理另一份笔记。最后关闭客户端，确认配置的 gateway 是否仍在运行。这样分别验证工具、记忆和服务生命周期。
正常聊天只证明模型链路正常；文件任务证明权限与工具可用；新主题复用偏好才证明持久记忆。不要用一个 Hello 回复替代整套验收。
资料依据：固定版本 README · 补充官方文档 · 当前仓库。
资料获取时间（UTC）：2026-11-02T07:26:43.677Z；仓库快照提交：8b37976d36c2。来源日期表示该仓库快照提交时间，并非项目首次发布日期。
* * *
编者评论
这篇文章，如何判断
阅读价值
当前文档对工作区、实例记忆、后台模式和重启恢复的区别说明具体，能帮助读者建立可测试的使用路径。
保留意见
未安装或执行长期任务；本文依据当前源码文档，稳定版本可能存在差异。轻量架构不等于所有部署都无需维护。 试用案例和验收方法是编辑建议。评级衡量资料参考价值，不是产品性能评分。
可迁移启发
自托管助手的验收应拆成模型、工具、记忆和运行生命周期。把这几项分别测试，出问题时才知道该改配置、流程还是部署方式。
原文摘录