nanobot 学习索引
GitHub: https://github.com/HKUDS/nanobot
定位：超轻量、可自托管的个人 AI Agent 框架，香港大学 HKUDS 出品
📊 文档进度（Dataview）
dataview
TABLE status AS "状态", stage AS "阶段", difficulty AS "难度"
FROM "AI大模型/nanobot"
WHERE type = "note"
SORT order ASC🗺️ 文档导航
阶段一：入门
| 文档 | 内容 | 状态 |
|---|---|---|
| 01-项目简介 | 定位、核心特性、与同类项目对比 | ✅ 已填充 |
| 02-安装与配置 | 四种安装方式、Provider 配置 | ✅ 已填充 |
| 03-快速上手-WebUI | WebUI 启动、三步验证对话 | 📝 待填充 |
| 04-基础概念 | Gateway/Channel/Dream/MCP/Goal | ✅ 已填充 |
阶段二：进阶
| 文档 | 内容 | 状态 |
|---|---|---|
| 01-工具系统 | 内置工具、调用机制、自定义工具 | ✅ 已填充 |
| 02-记忆系统-Dream | Dream 原理、双层记忆、触发方式 | ✅ 已填充 |
| 03-MCP集成 | MCP 协议、Server 配置、常用示例 | ✅ 已填充 |
| 04-多Agent协作 | 委托模式、编排模式、实战案例 | 📝 待填充 |
| 05-模型路由与配置 | 多提供商、Fallback、可观测性 | 📝 待填充 |
阶段三：实战
| 文档 | 内容 | 状态 |
|---|---|---|
| 01-接入聊天应用 | Telegram/Discord/Slack/飞书 | 📝 待填充 |
| 02-定时自动化任务 | Cron 工具 + Goal 长时任务 | 📝 待填充 |
| 03-部署到云端 | Render/Docker/systemd 服务化 | 📝 待填充 |
| 04-Python-SDK开发 | OpenAI 兼容 API、扩展开发 | 📝 待填充 |
参考文档
📅 学习计划
阶段一：入门（建议 3-5 天）
目标：理解 nanobot 是什么，能独立安装并跑通 WebUI 对话
| 任务 | 文档 | 预计时长 |
|---|---|---|
| 读项目 README，了解定位 | 01-项目简介 | 1h |
| 按文档安装，记录踩坑 | 02-安装与配置 | 1-2h |
| 跑通 WebUI，完成三步验证 | 03-快速上手-WebUI | 0.5h |
| 阅读架构文档，理解基础概念 | 04-基础概念 | 1-2h |
阶段验收：能打开 WebUI，和 Agent 完成一次对话，理解 Gateway/Channel/Session 的关系。
阶段二：进阶（建议 1-2 周）
目标：掌握 nanobot 五大核心能力
| 任务 | 文档 | 预计时长 |
|---|---|---|
| 逐一测试内置工具（shell/web/files） | 01-工具系统 | 2h |
| 触发 Dream，验证跨会话记忆保留 | 02-记忆系统-Dream | 1.5h |
| 接入一个 MCP Server（如 filesystem） | 03-MCP集成 | 2h |
| 实现简单的主/子 Agent 委托 | 04-多Agent协作 | 2h |
| 配置多模型 + Fallback | 05-模型路由与配置 | 1.5h |
阶段验收：能让 Agent 自动读写本地文件、跨会话记住用户偏好、调用 MCP 工具完成实际任务。
阶段三：实战（建议 1-2 周）
目标：将 nanobot 部署为生产可用的个人 AI Agent 服务
| 任务 | 文档 | 预计时长 |
|---|---|---|
| 接入 Telegram 或 Discord | 01-接入聊天应用 | 2h |
| 创建每日定时汇报任务 | 02-定时自动化任务 | 1.5h |
| 服务化部署（systemd 或 Docker） | 03-部署到云端 | 3h |
| 用 OpenAI 兼容 API 写集成脚本 | 04-Python-SDK开发 | 2h |
阶段验收：nanobot 以服务形式稳定运行，可通过手机聊天 App 随时与 Agent 交互，Agent 能主动推送定时报告。