Nanobot

⚠️ 此模板需要在 Zeabur 上使用专用服务器，无法在共享集群上运行。

建议资源： 1 vCPU / 2 GB RAM（最低：0.5 vCPU / 256 MB RAM）

Nanobot 是来自 HKUDS 的超轻量级个人 AI 助手框架（约 4K 行核心代理代码）。支持多种 LLM 供应商，并通过统一的 Gateway 架构连接各种消息平台。

官方文档： github.com/HKUDS/nanobot

支持的聊天平台

Telegram、Discord、WhatsApp、Slack、钉钉、飞书、QQ 和电子邮件。

快速开始

1. 部署后，Nanobot 网关将自动启动
2. 如果您在部署时输入了 API 密钥（Zeabur AI Hub 或 OpenRouter），聊天模型已自动配置
3. 如果您输入了 Telegram bot token，机器人已就绪 — 直接发消息即可开始对话
4. 如需添加更多平台或修改设置，通过文件标签编辑 /root/.nanobot/config.json

部署时跳过了某个字段？ 可以事后通过文件标签编辑 /root/.nanobot/config.json，或在 Zeabur 控制台添加对应的环境变量并重启服务。

默认模型： 使用 Zeabur AI Hub 时默认为 openai/claude-sonnet-4-5，使用 OpenRouter 时默认为 openrouter/anthropic/claude-sonnet-4。可随时在配置文件中修改。

LLM 供应商

Nanobot 支持多种供应商，您可以随时通过文件标签编辑 /root/.nanobot/config.json 并重启服务来切换。

供应商	获取 API 密钥	providers 配置	模型 ID 示例
Zeabur AI Hub	zeabur.com/ai-hub	"openai": {"api_key":"...","api_base":"https://hnd1.aihub.zeabur.ai/v1"}	openai/claude-sonnet-4-5
OpenRouter	openrouter.ai/keys	"openrouter": {"api_key":"sk-or-..."}	openrouter/anthropic/claude-sonnet-4
Anthropic	console.anthropic.com	"anthropic": {"api_key":"sk-ant-..."}	anthropic/claude-sonnet-4-5
OpenAI	platform.openai.com	"openai": {"api_key":"sk-..."}	openai/gpt-4o
DeepSeek	platform.deepseek.com	"deepseek": {"api_key":"..."}	deepseek/deepseek-chat

切换供应商步骤：

1. 在文件标签打开 /root/.nanobot/config.json
2. 在 "providers" 中添加或修改供应商配置
3. 将 "agents" > "defaults" > "model" 改为新的模型 ID
4. 重启服务使更改生效

聊天平台

支持：Telegram、Discord、WhatsApp、Slack、钉钉、飞书、QQ 和电子邮件。完整的配置方式请参考官方文档。

Telegram 设置步骤：

1. 在 Telegram 搜索 @BotFather 并发送 /newbot
2. 按照提示设置 bot 名称和 username
3. 复制获得的 bot token
4. 在部署时填入，或之后添加到配置文件

如果您在部署时输入了 bot token，已自动启用。否则在配置文件中添加：

"channels": {
  "telegram": { "enabled": true, "token": "BOT_TOKEN", "allow_from": [] }
}

其他平台 — 在配置文件中添加对应的频道并重启：

"channels": {
  "discord": { "enabled": true, "token": "BOT_TOKEN", "allow_from": [] }
}

allow_from — 控制谁可以与机器人对话。空列表 [] = 任何人都可使用。如需限制访问，添加用户 ID（Telegram 用户可向 @userinfobot 发消息查询自己的 ID）：

"allow_from": ["123456789", "987654321"]

修改配置后需重启服务。

数据持久化

所有数据存储在 /root/.nanobot（挂载为持久卷）。

建议使用 Zeabur 的备份功能定期备份您的数据。

更多说明： 请参考官方文档。