大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
大家好，我是何三，独立开发者
 

nanobot 是一个超轻量级的个人 AI 助手框架，核心代码仅约 4000 行，却功能强大。它支持多种聊天平台（微信、飞书、钉钉、Telegram 等）和主流大语言模型，特别适合个人和小型团队快速部署使用。

特点： - 🪶 超轻量：核心代码仅 ~4000 行 - ⚡ 快速部署：5 分钟即可完成配置 - 💬 多平台支持：微信、飞书、钉钉、Telegram、Discord 等 - 🤖 模型丰富：支持 Qwen、Kimi、DeepSeek、GLM 等国产主流模型 - 🔧 易于扩展：支持 MCP 协议、自定义工具、技能系统

---

nanobot 通过 LiteLLM 统一接口，支持以下主流模型提供商：

• vLLM：支持本地部署的开源模型（Llama、Qwen 等）
• 自定义：任何 OpenAI 兼容的 API 接口

---

要求：Python 3.11 或更高版本

检查 Python 版本

打开 PowerShell（按 ，选择"Windows PowerShell"），输入：

如果显示 或更高版本，跳过此步。否则需要安装：

安装 Python 3.11+

1. 访问 Python 官网
2. 下载 Python 3.11 或 3.12 的 Windows 安装包
3. 重要：安装时勾选 "Add Python to PATH"
4. 点击 "Install Now"

验证安装

重新打开 PowerShell，输入：

确保两个命令都能正常输出版本号。

根据你想使用的模型，提前申请对应的 API Key：

• 通义千问：登录 阿里云百炼 → API-KEY 管理 → 创建新密钥
• Kimi：登录 Moonshot 开放平台 → 个人中心 → API Key
• DeepSeek：登录 DeepSeek 平台 → API Keys
• 智谱 AI：登录 智谱 AI 开放平台 → API Key 管理

建议：将 API Key 保存在记事本中，后续配置会用到。

---

步骤 1：创建安装目录（可选）

为了便于管理，建议在用户目录下创建专门文件夹：

步骤 2：安装 nanobot

等待安装完成，看到 表示成功。

步骤 3：验证安装

应输出版本号，如 。

---

如果你想使用最新功能或参与开发：

步骤 1：安装 Git（如果未安装）

从 Git 官网 下载并安装 Git。

步骤 2：克隆项目

步骤 3：创建虚拟环境（推荐）

激活后，命令行前面会出现 标识。

步骤 4：安装依赖

步骤 5：验证安装

---

运行以下命令，nanobot 会自动创建配置文件目录：

这个命令会： - 创建 目录 - 生成默认配置文件 - 创建工作空间目录

配置文件位于：

打开配置文件

方法 1：使用记事本

方法 2：使用 VS Code（推荐）

如果安装了 VS Code：

模板 A：使用通义千问（Qwen）

说明： - 将 替换为你的阿里云百炼 API Key - 可选值：、、、 等

---

模板 B：使用 Kimi

说明： - 将 替换为你的 Moonshot API Key - 国内使用 ，国际使用 - 可选值：、、 等

---

模板 C：使用 DeepSeek

说明： - 将 替换为你的 DeepSeek API Key - 可选值：（对话）、（代码）

---

模板 D：使用智谱 AI（GLM）

说明： - 将 替换为你的智谱 AI API Key - 可选值：、、、 等

---

模板 E：使用火山引擎（Doubao）

说明： - 将 替换为你的火山引擎 API Key - 需要在火山引擎控制台创建 endpoint

---

模板 F：使用 OpenRouter（聚合平台，推荐新手）

OpenRouter 是一个模型聚合平台，一个 API Key 可以使用多家模型：

说明： - 访问 OpenRouter 创建 API Key - 可选值非常多，如 、 等 - 格式：

---

模板 G：使用本地 vLLM 部署

说明： - 需要先部署 vLLM 服务 - 填写你的 vLLM 服务地址

---

这是一个包含多个提供商的完整配置：

---

启动 Agent

启动后会进入交互式对话界面，你可以直接输入问题。

测试示例

退出对话

输入以下任一命令退出： - - - -

---

如果你想让 nanobot 连接到 Telegram、飞书、钉钉等聊天平台：

步骤 1：配置聊天平台

以 Telegram 为例，在 中添加：

获取 Telegram Bot Token： 1. 在 Telegram 中搜索 2. 发送 创建机器人 3. 按提示设置名称，获得 Token 4. 发送 获取你的用户 ID

步骤 2：启动网关

启动后，nanobot 会连接到 Telegram，你可以通过 Telegram 与机器人对话。

---

测试 Qwen

确保配置文件中设置：

运行：

输入测试问题：

测试 Kimi

修改配置：

运行并测试：

（Kimi 擅长长文本处理）

测试 DeepSeek

修改配置：

运行并测试：

（DeepSeek 在代码方面表现优秀）

测试 GLM

修改配置：

运行并测试：

---

会显示当前配置状态、API Key 配置情况等。

---

如果需要联网搜索，配置 Brave Search API：

1. 获取 API Key：访问 Brave Search API
2. 修改配置：

测试：

---

原因： Python 的 Scripts 目录不在 PATH 环境变量中

解决方案：

方法 1（临时）：

方法 2（永久）： 1. 右键"此电脑" → "属性" → "高级系统设置" 2. 点击"环境变量" 3. 在"系统变量"中找到 ，点击"编辑" 4. 添加： 5. 重启 PowerShell

---

错误信息：

解决方案：

方法 1：使用用户模式安装

方法 2：以管理员身份运行 PowerShell 1. 按 2. 选择"Windows PowerShell (管理员)" 3. 重新运行安装命令

方法 3：使用虚拟环境（推荐）

---

错误信息： 或

检查清单： - ✅ API Key 是否复制完整（没有多余空格） - ✅ API Key 是否已激活（部分平台需要手动激活） - ✅ 账户是否有余额或免费额度 - ✅ 配置的 字段是否与 API Key 匹配 - ✅ 是否正确（特别是 Kimi 有国内/国际之分）

调试方法：

在配置文件中临时添加详细日志（如果支持），或尝试用 curl 测试：

---

错误信息： 或

解决方案：

1. 检查模型名称拼写是否正确
2. 确认该模型在你的账户中可用
3. 查看平台文档确认模型名称格式

常见模型名称： - 通义千问：、、 - Kimi：、 - DeepSeek：、 - GLM：、

---

错误信息： 或

解决方案：

1. 检查网络：确保能正常访问互联网
2. 配置代理（如果需要）：

1. 使用国内镜像：部分平台提供国内 API 端点

---

错误信息：

解决方案：

这是 PowerShell 执行策略限制，运行以下命令：

输入 确认，然后重新激活虚拟环境。

---

错误信息： 各种 或版本冲突

解决方案：

方法 1：升级 pip 和依赖

方法 2：使用干净虚拟环境

---

错误信息： 或

解决方案：

1. 使用 JSON 验证工具检查格式
2. 确保使用双引号 而不是单引号
3. 确保最后一个元素后面没有逗号
4. 检查括号是否匹配

在线工具： JSON Validator

---

问题： 运行大型模型时系统卡顿

解决方案：

1. 降低 配置：

1. 使用更小的模型变体（如 而不是 ）
2. 关闭其他占用内存的程序

---

方法 1： 修改配置文件后重启

方法 2： 临时指定（如果 CLI 支持）

方法 3： 使用环境变量（部分平台支持）

---

在配置文件中配置多个提供商，根据需要修改 和 。

nanobot 支持文件操作、Shell 命令、Web 搜索等工具：

nanobot 支持 Model Context Protocol (MCP)，可以连接外部工具和服务：

---

• 官方文档：GitHub Repository
• 问题反馈：GitHub Issues
• 社区讨论：
• 飞书群：查看 COMMUNICATION.md
• Discord：Discord Community

---

恭喜你完成 nanobot 的部署！现在你可以：

下一步建议：

1. 尝试不同的模型，找到最适合你的
2. 配置聊天平台，随时随地与 AI 对话
3. 探索工具调用功能，让 AI 帮你执行任务
4. 查看技能系统，扩展 AI 能力

祝你使用愉快！🎉

相关推荐：

nanobot 再进化：Qwen、Kimi 全支持，Discord 上线，扩展更容易！