大家好，我是何三，独立开发者
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+
- 访问 Python 官网
- 下载 Python 3.11 或 3.12 的 Windows 安装包
- 重要：安装时勾选 “Add Python to PATH”
- 点击 “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：
- 获取 API Key：访问 Brave Search API
- 修改配置：
测试：
原因： 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 测试：
错误信息： 或
解决方案：
- 检查模型名称拼写是否正确
- 确认该模型在你的账户中可用
- 查看平台文档确认模型名称格式
常见模型名称： – 通义千问：、、 – Kimi：、 – DeepSeek：、 – GLM：、
错误信息： 或
解决方案：
- 检查网络：确保能正常访问互联网
- 配置代理（如果需要）：
- 使用国内镜像：部分平台提供国内 API 端点
错误信息：
解决方案：
这是 PowerShell 执行策略限制，运行以下命令：
输入 确认，然后重新激活虚拟环境。
错误信息： 各种 或版本冲突
解决方案：
方法 1：升级 pip 和依赖
方法 2：使用干净虚拟环境
错误信息： 或
解决方案：
- 使用 JSON 验证工具检查格式
- 确保使用双引号 而不是单引号
- 确保最后一个元素后面没有逗号
- 检查括号是否匹配
在线工具： JSON 智谱 AI GLM 教程 Validator
问题： 运行大型模型时系统卡顿
解决方案：
- 降低 配置：
- 使用更小的模型变体（如 而不是 ）
- 关闭其他占用内存的程序
方法 1： 修改配置文件后重启
方法 2： 临时指定（如果 CLI 支持）
方法 3： 使用环境变量（部分平台支持）
在配置文件中配置多个提供商，根据需要修改 和 。
nanobot 支持文件操作、Shell 命令、Web 搜索等工具：
nanobot 支持 Model Context Protocol (MCP)，可以连接外部工具和服务：
- 官方文档：GitHub Repository
- 问题反馈：GitHub Issues
- 社区讨论：
- 飞书群：查看 COMMUNICATION.md
- Discord：Discord Community
恭喜你完成 nanobot 的部署！现在你可以：
✅ 使用 CLI 与 AI 助手对话
✅ 连接聊天平台（Telegram、飞书等）
✅ 切换不同的国产大模型
✅ 使用文件操作、Web 搜索等工具
✅ 开发自定义技能
下一步建议： 1. 尝试不同的模型，找到最适合你的 2. 配置聊天平台，随时随地与 AI 对话 3. 探索工具调用功能，让 AI 帮你执行任务 4. 查看技能系统，扩展 AI 能力
祝你使用愉快！🎉
相关推荐：
nanobot 再进化：Qwen、Kimi 全支持，Discord 上线，扩展更容易！
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/270923.html原文链接：https://javaforall.net
