nanobot

nanobot 是一个用 Python 编写的超轻量级、开源、可自托管的个人 AI Agent 框架。它可以在浏览器 WebUI、终端或常驻 gateway 服务中运行，并把工具调用、长期记忆、MCP 集成、模型路由、多智能体协作与定时自动化浓缩在一个小巧、可读的核心里。项目在 GitHub 拥有超过 4.7 万 star，采用 MIT 协议，是当前最受欢迎的自托管 Agent 框架之一，适合想要"真正拥有"自己智能体的用户。

核心功能

• 极简智能体循环：消息从聊天应用进来，由 LLM 决定何时调用工具，记忆与技能按需作为上下文加载，而不是变成笨重的编排层。
• 多渠道接入：WebUI（默认端口 8765）、终端 CLI，以及 Telegram、Discord、Slack、微信、飞书、邮件、Mattermost 等聊天应用。
• 内置工具集：文件读写与补丁、可配置沙箱的 shell 执行、带 SSRF 检查的网页搜索与抓取、MCP 服务器、cron 定时提醒、图像生成与子智能体。
• 长期记忆：会话历史加上 Dream 持久记忆系统，目标、记忆、工具与对话上下文在长时间运行中持续保留。
• 模型自由：兼容任意 OpenAI 风格接口（OpenRouter、Anthropic、OpenAI、Bedrock、Ollama、vLLM）及本地模型，支持模型降级链。
• 集成接口：Python SDK、nanobot serve 提供的 OpenAI 兼容 API（/v1/chat/completions），以及用于调用追踪的 Langfuse 可观测性。

适用场景

• 个人 AI 助理：一个住在你聊天应用里的私有智能体，处理邮件、文件与网页调研，并保留自己的记忆。
• 自动化中心：cron 定时任务、心跳任务与本地触发器，让 nanobot 执行长周期任务与定时自动化。
• 本地优先部署：WebUI 默认只绑定 localhost，数据留在本机；也可部署为 gateway 实现 7x24 可用。
• 多智能体工作流：子智能体委派与按项目隔离的 workspace 会话，适合仓库级任务。

优势

1. 真正轻量：可读的 Python 核心，而不是平台级的编排栈；uv tool install nanobot-ai 一条命令即可安装。
2. 拥有自己的栈：MIT 协议、可自托管、从工具到渠道都容易查看与扩展。
3. MCP 与记忆开箱即用：Model Context Protocol 服务器、长期记忆与多渠道聊天是内置能力，而不是付费增值。

快速开始

1. 安装：uv tool install nanobot-ai（或 python -m pip install nanobot-ai），然后运行 nanobot webui。
2. 配置：在 WebUI 的 Settings 中添加模型提供方与模型预设，再按需启用聊天渠道。
3. 使用：在浏览器聊天，接入 Telegram 或 Discord，或通过 Python SDK 与 OpenAI 兼容 API 编写脚本。
4. 安全：WebUI 默认仅本机可访问；暴露 gateway 前请检查 shell、workspace 与 SSRF 相关设置。

使用技巧

1. 先走向导：nanobot onboard --wizard 会在你手改 JSON 之前初始化好配置与工作区。
2. 用 MCP 接外部工具：在 tools.mcpServers 中配置 stdio 或 HTTP 的 MCP 服务器，即可接入 GitHub、数据库等。
3. 注意安全面：项目处于 Alpha 阶段；长期部署前请给 shell 执行加沙箱，并检查 SSRF 白名单。

总结

nanobot 提供了一个真正轻量、可自托管的个人智能体方案，记忆、MCP、多渠道聊天与自动化都在一个你可以读懂并扩展的包里。如果你想要一个属于自己的智能体而不是租用一个平台，nanobot 是目前最强的开源选择之一。

替代方案

• FastClaw：Go 编写的智能体运行时与多智能体框架，是 OpenClaw 的更轻量替代。
• OpenClaw：开源智能体运行时鼻祖，插件生态更庞大。
• CrewAI：Python 的角色化多智能体编排框架。