BAIZE AI RESOURCE

可自托管的开源 AI Agent，支持多聊天渠道、WebUI 与 Python SDK

nanobot

可自托管的开源 AI Agent，支持多聊天渠道、WebUI 与 Python SDK

获取资源
nanobot

资源介绍

nanobot 是一个可自托管运行的开源 AI Agent 项目，由 HKUDS 维护，采用 MIT 协议。它把「模型 + 工具 + 渠道 + 记忆」整合成一套可长期运行的智能体运行时：既可以在本地桌面通过浏览器 WebUI 使用，也可以部署为常驻网关服务，把同一个 Agent 接入 Telegram、Discord、Slack、飞书、微信、QQ、WhatsApp、Mattermost、Email 等聊天渠道。

使用上，nanobot 推荐先安装并打开 `nanobot webui`，在 Settings → Models 中配置模型提供商，发送一条消息确认链路通畅，再逐步添加能力：通过 Settings → Channels 接入聊天应用，通过 Apps 管理 Agent Plugins、CLI Apps 与 MCP 集成，通过 Automations 配置定时任务或本地触发，通过 Memory 管理长期记忆。除 WebUI 外，还提供 CLI 命令、Python SDK，以及兼容 `/v1/chat/completions` 的 OpenAI 风格 HTTP 接口，方便从代码或既有系统调用。

工程侧，nanobot 提供 Dockerfile 与 docker-compose 编排（gateway、api、cli 三个服务），容器内以非 root 用户运行并默认丢弃全部 capability，仅保留启动所需的 CHOWN/SETGID/SETUID。它适合希望把 AI Agent 私有化部署、并统一接入多个沟通渠道的个人开发者与团队。

Agent 能力

多聊天渠道接入

在 WebUI 的 Settings → Channels 中提供引导式配置流程，帮助用户完成各聊天平台所需的账号、Bot Token 与权限设置，并发送测试消息验证接入是否成功。

浏览器 WebUI 工作台

安装后可直接打开 `nanobot webui`，在图形界面中完成模型提供商配置、渠道接入、Apps（Agent Plugins、CLI Apps、MCP 集成）管理与自动化设置，首次运行多数场景无需手写 JSON。

MCP 与工具扩展

提供 MCP 工具加载与 OAuth 支持，并内置文件系统、Shell、搜索、网页、图像生成、定时任务、子 Agent 等工具模块，可按需启用或通过插件扩展。

长期记忆与上下文治理

包含 memory、context、context_governance、autocompact 等模块，支持长期记忆管理与上下文自动压缩，用于支撑长时间运行的持续目标。

代码集成接口

提供 Python SDK（会话、事件、钩子）以及兼容 `/v1/chat/completions` 的 OpenAI 风格 HTTP 接口，便于从 Python 程序或既有 OpenAI 客户端调用 Agent。

容器化部署

仓库提供 Dockerfile 与 docker-compose.yml，编排 gateway（18790/8765 端口）、api（8900 端口）与 cli 三个服务，容器以非 root 用户运行并默认 cap_drop ALL。

资源配置

运行平台

本地运行Docker

Agent框架

自研框架

配置方式

配置文件环境变量Web配置API Key

运行与使用

  1. 安装 nanobot，并在本地桌面环境执行 `nanobot webui` 打开浏览器工作台。

  2. 在 WebUI 的 Settings → Models 中配置模型提供商与模型，然后发送 `Hello!` 确认能收到回复。

  3. 在 Settings → Channels 中按引导接入需要的聊天应用（如 Telegram、Discord、Slack、飞书等），完成账号、Bot Token 与权限配置。

  4. 在 Apps 中管理 Agent Plugins、CLI Apps 与 MCP 集成，按需添加 MCP 工具服务器或启用 Web 搜索、图像生成等能力。

  5. 如需常驻运行，使用仓库提供的 docker-compose 启动 nanobot-gateway 与 nanobot-api 服务；如需从代码调用，使用 Python SDK 或 OpenAI 兼容接口。

使用案例

个人 AI 助手

使用场景个人效率

在本地安装后通过 WebUI 配置模型，构建一个可对话、可调用工具、具备长期记忆的个人 Agent。

聊天应用机器人

使用场景团队协作

把 nanobot 接入 Telegram、Discord、Slack 或飞书等渠道，让团队成员在既有聊天工具中直接与 Agent 交互。

自托管网关部署

使用场景私有化部署

使用 docker-compose 启动 gateway 与 api 服务，将 Agent 作为常驻服务运行并对外提供 OpenAI 兼容接口。

定时自动化任务

使用场景自动化工作

通过 Automations 配置定时任务或本地触发，让 Agent 按计划执行持续性的工作目标。

包含内容

nanobot-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt