nanobot：可自托管的轻量个人 AI 智能体框架

工具定位

nanobot 是 Python 编写的超轻量、开源、可自托管个人 AI 智能体框架。按 README 描述，它可在浏览器 WebUI、终端或聊天应用中使用，能处理文件、记住偏好并安排任务；模型由用户连接的受支持模型服务或本地模型服务器提供，nanobot 本身不提供模型账号。

能力范围

原文列出的功能包括：在 WebUI 或终端运行；连接 Telegram、Discord、Slack、WeChat、Email、Mattermost、Linear 等渠道；用内置文件工具读取 PDF、Word、Excel、PowerPoint 文件；使用 shell、网页搜索/抓取、MCP 集成、定时任务、图像生成与多智能体委派；通过 Dream 保存会话历史与长期记忆；运行长周期目标与定时自动化；暴露 Python SDK 与 OpenAI 兼容 API；作为长期运行的本地或服务器端智能体网关部署。

安装条件与轨道

需要 Python 3.11 或更新版本，以及可访问的受支持模型服务或本地模型服务器；模型费用或本地硬件要求取决于所选服务。

原文区分两条安装轨道：稳定版（安装脚本、uv 或 pip）与当前源码（Git 可编辑安装，需要 Git 和 Bun）。README 说明其描述的是当前源码，已发布文档对应发行版本。安装脚本提供 --dry-run 预演选项；已有 uv 或 pip 环境的用户可自行安装 nanobot-ai 包，但该方式不会自动启动配置流程。

使用入口

• WebUI：nanobot webui 启动，首次运行绑定 localhost，登录链接含 # 片段，需保密；远程服务器可用 --no-open 配合 SSH 端口转发访问。
• 终端：nanobot onboard --wizard 完成配置，nanobot -m "Hello!" 单次检查，nanobot 进入 TUI。
• 后台网关：nanobot gateway --background 保持渠道与自动化运行，配套 status、logs、restart、stop 子命令。原文提示后台模式不负责开机自启或崩溃重启，重启后不会自动重放中断的子任务或错过的定时时间。

部署与其他说明

原文提供 Render 一键部署 Blueprint（需 ANTHROPIC_API_KEY 与私有 NANOBOT_WEB_TOKEN，持久磁盘需付费服务），并指向 Docker、Docker Compose、Linux 服务与 macOS LaunchAgent 的部署文档。WebUI 内置于发布轮子中，无需单独构建前端；原文强调 WebUI 访问等同于该实例的管理权限。

原文在 WebUI 章节的上下文指示器说明处截断，其后的内容无法确认。