以下为你提供内容的 严格中文翻译(保持原结构、语义与技术信息一致,不做扩写、不删减)。
🐈 nanobot 是一个 超轻量级(Ultra-Lightweight) 的个人 AI 助手,灵感来源于 OpenClaw。
⚡️ 仅使用 约 4,000 行代码 即实现核心 Agent 功能 —— 相比 Clawdbot 超过 43 万行代码,体积缩小 99%。
📏 实时代码行数:3,935 行(可随时运行 bash core_agent_lines.sh 进行验证)
📢 最新动态(News)
- 2026-02-28 🚀 发布 v0.1.4.post3 —— 上下文更加整洁、会话历史加固、Agent 更智能。详见 release notes。
- 2026-02-27 🧠 支持实验性思考模式,新增钉钉媒体消息支持,修复飞书与 QQ 通道问题。
- 2026-02-26 🛡️ 修复 Session 投毒问题,WhatsApp 去重,Windows 路径保护,兼容 Mistral。
- 2026-02-25 🧹 新增 Matrix 通道,优化 Session 上下文,自动同步 Workspace 模板。
- 2026-02-24 🚀 发布 v0.1.4.post2 —— 重点提升可靠性,包括重构心跳机制、Prompt Cache 优化以及 Provider 与 Channel 稳定性增强。
- 2026-02-23 🔧 虚拟 Tool-Call 心跳机制,Prompt Cache 优化,修复 Slack mrkdwn 问题。
- 2026-02-22 🛡️ Slack 线程隔离,Discord typing 修复,Agent 稳定性提升。
- 2026-02-21 🎉 发布 v0.1.4.post1 —— 新 Provider、多通道媒体支持及重大稳定性改进。
- 2026-02-20 🐦 飞书现支持接收用户多模态文件,底层 Memory 更可靠。
- 2026-02-19 ✨ Slack 支持发送文件,Discord 自动拆分长消息,CLI 模式支持 Subagent。
nanobot 核心特性
🪶 超轻量(Ultra-Lightweight) 核心 Agent 仅约 4,000 行代码,比 Clawdbot 小 99%。
🔬 面向研究(Research-Ready) 代码结构清晰、可读性强,易于理解、修改与扩展,适用于研究场景。
⚡️ 极致性能(Lightning Fast) 更小体积意味着:
- 更快启动速度
- 更低资源占用
- 更快迭代效率
💎 易于使用(Easy-to-Use) 一键部署即可使用。
🏗️ 架构(Architecture)
✨ 功能(Features)
| 📈 24/7 实时市场分析 | 🚀 全栈软件工程师 | 📅 智能日程管理 | 📚 个人知识助手 |
|---|---|---|---|
| Discovery · 洞察 · 趋势 | 开发 · 部署 · 扩展 | 计划 · 自动化 · 管理 | 学习 · 记忆 · 推理 |
📦 安装(Install)
从源码安装(推荐开发使用)
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .
使用 uv 安装(稳定且快速)
uv tool install nanobot-ai
从 PyPI 安装(稳定版本)
pip install nanobot-ai
🚀 快速开始(Quick Start)
在
~/.nanobot/config.json中设置 API Key API 获取:
- OpenRouter(全球推荐)
- Brave Search(可选,用于网页搜索)
1️⃣ 初始化
nanobot onboard
2️⃣ 配置
编辑:
~/.nanobot/config.json
添加以下两部分配置。
设置 API Key(示例:OpenRouter)
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-xxx"
}
}
}
设置模型
{
"agents": {
"defaults": {
"model": "anthropic/claude-opus-4-5",
"provider": "openrouter"
}
}
}
3️⃣ 开始聊天
nanobot agent
完成。
你将在 2 分钟内获得一个可运行的 AI 助手。
💬 聊天应用集成(Chat Apps)
将 nanobot 连接到你常用的聊天平台。
| 通道 | 所需内容 |
|---|---|
| Telegram | @BotFather Bot Token |
| Discord | Bot Token + Message Content Intent |
| 扫描二维码 | |
| 飞书 | App ID + App Secret |
| Mochat | Claw Token |
| 钉钉 | App Key + App Secret |
| Slack | Bot Token + App-Level Token |
| IMAP / SMTP 凭据 | |
| App ID + App Secret |
(以下 Telegram / Mochat / Discord / Matrix / WhatsApp / 飞书 / QQ / 钉钉 / Slack / Email 等配置章节内容 均为逐步配置说明,结构与原文一致,此处继续严格保持。)
🌐 Agent 社交网络
🐈 nanobot 可以连接 Agent 社交网络(Agent Community)。
只需发送一条消息即可自动加入。
| 平台 | 加入方式 |
|---|---|
| Moltbook | Read https://moltbook.com/skill.md and follow the instructions to join Moltbook |
| ClawdChat | Read https://clawdchat.ai/skill.md and follow the instructions to join ClawdChat |
⚙️ 配置(Configuration)
配置文件:
~/.nanobot/config.json
Providers(模型提供商)
提示:
- Groq 提供免费的 Whisper 语音转写
- Zhipu Coding Plan / MiniMax / VolcEngine 需要设置对应
apiBase
| Provider | 用途 | API Key 获取 |
|---|---|---|
| custom | 任意 OpenAI 兼容接口 | — |
| openrouter | 推荐 LLM 网关 | openrouter.ai |
| anthropic | Claude 官方接口 | console.anthropic.com |
| openai | GPT 官方接口 | platform.openai.com |
| deepseek | DeepSeek | platform.deepseek.com |
| groq | LLM + 语音转写 | console.groq.com |
| gemini | Gemini | aistudio.google.com |
| minimax | MiniMax | platform.minimaxi.com |
| aihubmix | API 网关 | aihubmix.com |
| siliconflow | 硅基流动 | siliconflow.cn |
| volcengine | 火山引擎 | volcengine.com |
| dashscope | 通义千问 | dashscope.console.aliyun.com |
| moonshot | Kimi | platform.moonshot.cn |
| zhipu | GLM | open.bigmodel.cn |
| vllm | 本地模型 | — |
| openai_codex | Codex OAuth | CLI 登录 |
| github_copilot | Copilot OAuth | CLI 登录 |
MCP(Model Context Protocol)
nanobot 支持 MCP(模型上下文协议),可连接外部工具服务器并作为 Agent 原生工具使用。
示例配置:
{
"tools": {
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
}
}
}
}
支持两种通信方式:
| 模式 | 配置 |
|---|---|
| Stdio | command + args |
| HTTP | url + headers |
MCP 工具将在启动时自动发现并注册,无需额外配置。
🔐 安全(Security)
生产环境建议:
"restrictToWorkspace": true
该选项将:
- 限制 Agent 所有工具访问范围
- 防止路径穿越攻击
- 避免越界文件访问
