前言
AI Agent 领域近期涌现了不少框架,其中 OpenClaw 功能强大但代码量高达 43 万行,对于个人开发者或二次开发来说过于沉重。相比之下,来自香港大学数据科学实验室(HKUDS)的 nanobot 则是一个极佳的轻量级选择。
nanobot 的设计理念是'用最少的代码实现核心能力',代码量仅约 4000 行,却保留了多轮对话、上下文记忆、网页搜索、代码执行及多平台接入等关键功能。对于 90% 的个人使用场景,这已经足够。
环境准备与安装
搭建过程非常简洁,主要依赖 Python 3.11+。如果系统版本较低,建议先升级。
# CentOS/RHEL
dnf install python3.11 python3.11-pip
# Ubuntu/Debian
apt install python3.11 python3.11-pip
克隆仓库并安装:
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip3.11 install -e .
初始化配置后,会在 ~/.nanobot/ 目录下生成配置文件。
配置 LLM 与频道
编辑 ~/.nanobot/config.json,推荐使用 Gemini 作为后端,免费额度通常够用:
{
"agents": {
"defaults": {
"model": "gemini/gemini-2.5-flash"
}
},
"providers": {
"gemini": {
"apiKey": "你的 Gemini API Key"
}
}
}
获取 API Key 后可直接填入。接着配置 QQ 机器人,需先在 QQ 开放平台注册开发者账号并创建应用,获取 AppID 和 Secret:
{
"channels": {
"qq"

