Nanobot 项目介绍

🐈 nanobot 是一个开源的、超轻量级的 AI Agent，灵感来自 OpenClaw、Claude Code 和 Codex。它保持了核心 Agent 循环的小巧可读，同时支持聊天频道、记忆、MCP 和实际部署路径。

项目定位

一个以 Agent 循环为核心的轻量级 AI Agent Harness，让你从本地安装到长期运行的个人 Agent，开销最小化。

项目由 Xubin Ren 发起，由香港大学数据系统研究组（HKUDS）维护。

层级	技术
语言	Python 3.11+，全异步（asyncio）
配置	Pydantic + pydantic-settings，camelCase/snakeCase 双向兼容
LLM 客户端	原生 `openai` + `anthropic` SDK
WebUI	Vite + React，通过 WebSocket 与 Gateway 通信
构建	Hatch（pyproject.toml），wheel 打包 WebUI
部署	Docker、systemd、macOS LaunchAgent

# 从源码安装
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

# 初始化配置向导
nanobot onboard

# 启动 Agent
nanobot agent

或通过 WebUI：

# 在配置中启用 WebSocket
{"channels": {"websocket": {"enabled": true}}}

# 启动 Gateway
nanobot gateway
# 浏览器访问 http://127.0.0.1:8765

本教程分为两条线索：

从 Nanobot 源码出发，抽象出 AI Agent 的通用设计模式：

聚焦 Nanobot 的工程实践与架构决策：

📅 2026-05-30 🏷️ v0.2.0 🔀 b2e4395