🐈 Nanobot：42k Stars 的超轻量 AI Agent，pip install 就有一个能干活的个人助手
项目地址：HKUDS/nanobot | ⭐ 42,465 Stars | 🐍 Python | 作者：Xubin Ren
老实说，OpenClaw、Claude Code 这些东西是好用，但有时候我就想找个更轻量的——别整那么多花里胡哨的，装完就能跑，跑起来就能干活，最好连 Docker 都别让我装。
nanobot 就是干这个的。HKUDS 出的开源 AI Agent，核心代码小到可以一次读完，但 Telegram、Discord、飞书、Slack、MCP、记忆、定时任务、WebUI 全都有。42k Stars 不是白涨的。
一、⚡ 安装：三选一，都简单
从 PyPI 装：
pip install nanobot-ai
用 uv（推荐，更快）：
uv tool install nanobot-ai
或者从源码装：
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .
装完了跑 nanobot onboard，交互式向导帮你配好 provider 和 model，全程不用碰配置文件。最骚的是这一步。
二、🚀 上手：两行配置，一行开聊
初始化：
nanobot onboard
配 API Key： 编辑 ~/.nanobot/config.json，加这两块：
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-xxx"
}
},
"agents": {
"defaults": {
"provider": "openrouter",
"model": "anthropic/claude-opus-4-6"
}
}
}
开聊：
nanobot agent
然后就进入终端对话了，跟 ChatGPT 一样直接聊。别问我怎么知道的，踩过的坑都是泪——一开始我试了 OpenRouter 免费模型，结果代理循环直接炸了。老老实实配个好模型就稳了。
三、🔌 接入聊天软件
nanobot 支持 Telegram、Discord、飞书、Slack、微信、QQ、Matrix、DingTalk。以 Telegram 为例：
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的BotToken"
}
}
}
启动 gateway：
nanobot gateway
nanobot 就变成你自己 Telegram 里的 AI 助手了，24 小时在线，群里 @ 它就行。之前用 OpenAI 的 GPTs 做群聊机器人，动不动就限流，换 nanobot 本地跑直接解决了。
四、🧠 MCP + 记忆 + 定时任务
MCP 配置：
{
"mcp": {
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
}
}
}
}
记忆系统默认自带，不用额外配。nanobot 会记住之前的对话上下文，不会你问一句它就"失忆"。
定时任务（Cron 风格）：
# 在 nanobot agent 里直接说：
"每天早上9点提醒我看 GitHub Trending"
nanobot 会把自然语言转成 cron 表达式，到点自动执行。
五、🎯 WebUI（开发版）
如果想有个浏览器界面：
{ "channels": { "websocket": { "enabled": true } } }
开 gateway，然后跑 WebUI：
cd webui
bun install
bun run dev
本地浏览器访问就能看到聊天界面，像 ChatGPT 一样操作。
六、总结
想给你的个人 AI 助手一个轻量化方案？pip install nanobot-ai 然后 nanobot onboard，5 分钟就有个能干活的 Agent 了。
标签：#AI #Agent #OpenSource #Python #PersonalAssistant