nanobot完整教程从部署到使用打造你的个人AI助手1. 开篇认识你的轻量级AI伙伴想象一下拥有一个随时待命的个人AI助手它体积小巧部署简单却能帮你处理各种问题甚至还能接入你的QQ在社交软件里为你服务。这听起来是不是很酷今天要介绍的nanobot正是这样一个“小而美”的选择。nanobot是一款灵感来源于OpenClaw的超轻量级人工智能助手。它最大的魅力在于“精简”——核心功能仅由大约4000行代码实现。相比之下一些功能相近的大型AI助手项目代码量可能高达数十万行。这意味着nanobot的部署更快资源占用更少对新手也更为友好。这个镜像已经为你准备好了所有环境它内置了通过vllm高效部署的Qwen3-4B-Instruct-2507模型这是一个在中文理解和指令跟随方面表现出色的开源模型。交互界面则采用了直观的Chainlit让你能像聊天一样与AI互动。更棒的是它还预留了扩展接口让你可以轻松地将这个AI助手变成QQ聊天机器人。无论你是想体验AI对话还是希望有一个能集成到日常通讯工具中的智能帮手这篇教程都将手把手带你完成从零到一的整个过程。我们不需要复杂的理论只关注最实际的部署、配置和使用步骤。2. 第一步启动与验证你的nanobot2.1 确认模型服务已就绪当你启动这个镜像后第一件事就是确认核心的模型服务是否已经成功运行。这就像启动一台新电脑我们要先看看系统是否正常加载。打开你的WebShell通常是一个在浏览器中运行的终端界面输入以下命令来查看部署日志cat /root/workspace/llm.log这条命令会显示模型加载和服务的启动过程。如果一切顺利你应该能看到类似“模型加载完成”、“服务启动成功”或“vLLM引擎初始化完毕”这样的关键信息。这表示Qwen3-4B模型已经准备就绪正在等待你的指令。如果日志显示有错误别担心错误信息通常会明确指出问题所在比如显存不足或依赖包缺失方便你进行针对性的排查。2.2 开启Chainlit聊天窗口模型服务在后台运行起来后我们还需要一个“前台”来和它对话。这就是Chainlit的作用——它提供了一个美观的网页聊天界面。启动Chainlit非常简单。在WebShell中通常只需要运行一条命令chainlit run app.py或者如果镜像提供了更便捷的启动方式你也可以尝试nanobot chat执行命令后终端会输出一个本地网络地址通常是http://localhost:7860或http://0.0.0.0:7860。将这个地址复制到你的浏览器地址栏并打开一个清爽的聊天界面就会呈现在你面前。现在你的个人AI助手已经“上线”了。3. 第二步开始与AI助手对话3.1 你的第一次对话面对空白的聊天框你可以从最简单的问候开始。试着输入你好请介绍一下你自己。nanobot会基于其内部的Qwen3-4B模型生成回复向你介绍它作为一个AI助手的基本能力和设计初衷。你可以继续追问比如今天天气如何它会尝试推理或告知你它无法获取实时信息你能帮我做什么讲一个简短的笑话。通过这些基础对话你可以快速感受模型的对话流畅度和中文理解能力。Qwen3-4B模型在同类尺寸的模型中对于中文语境和指令的把握是比较出色的。3.2 尝试一些实用指令nanobot不仅仅能聊天它被设计成具有一定的“代理”能力可以尝试执行一些简单的系统指令来协助你。让我们来试一个文档中提到的例子。在Chainlit的输入框中键入使用nvidia-smi看一下显卡配置发送后nanobot会识别出这是一个查看硬件信息的请求。它会尝试调用相关指令并将执行后返回的信息整理成更易读的格式呈现给你。你可能会看到包括GPU型号、显存使用量、温度等在内的详细信息。这个例子展示了nanobot如何作为你和系统之间的一个智能中介。你可以举一反三尝试其他类似的查询比如查看当前目录下有哪些文件。当前系统的内存使用情况如何帮我计算一下 12345 乘以 6789 的结果。4. 第三步进阶玩法——接入QQ机器人如果你希望这个AI助手能更深入地融入你的数字生活比如在QQ上随时应答那么接下来的配置就是为你准备的。这将把nanobot从一个网页工具变成你社交网络里的一个智能伙伴。4.1 准备工作获取QQ机器人凭证要让nanobot连接QQ你需要先在QQ开放平台创建一个机器人应用以获取合法的接入凭证。访问与注册打开 QQ开放平台官网使用你的QQ账号登录。如果你是新开发者需要先完成个人或企业开发者资质的注册这个过程通常需要手机验证。创建机器人应用在开发者后台找到“创建应用”的按钮选择应用类型为“机器人”。你需要为你的机器人起一个名字并填写简单的描述这些信息会展示给未来的用户。获取关键密钥创建成功后进入该应用的“开发管理”页面。在这里你会找到两个至关重要的信息AppID和AppSecret。请妥善保存它们这相当于你机器人的账号和密码是后续配置的核心。4.2 配置nanobot连接QQ通道拿到凭证后我们需要告诉nanobot如何连接QQ。这通过修改一个配置文件来完成。在WebShell中使用vim编辑器打开nanobot的配置文件vim /root/.nanobot/config.json在这个配置文件中找到与channels通道相关的部分。你需要添加或修改关于qq的配置块使其看起来像下面这样{ channels: { qq: { enabled: true, appId: YOUR_APP_ID_HERE, secret: YOUR_APP_SECRET_HERE, allowFrom: [] } } }请务必将YOUR_APP_ID_HERE和YOUR_APP_SECRET_HERE替换成你从QQ开放平台实际获取的AppID和AppSecret。配置项说明enabled: true表示启用QQ机器人通道。allowFrom: []这是一个QQ号码列表用于指定哪些QQ或群可以触发机器人。如果保持为空数组[]则默认允许所有来源根据QQ平台规则。你也可以填入特定的QQ号如[12345678, 群号123456]来进行限制。4.3 启动网关服务配置保存后nanobot需要一个专门的“网关”服务来维持与QQ服务器的长连接和消息转发。在WebShell中运行nanobot gateway如果启动成功你将看到终端输出“QQ网关服务启动成功”等字样并显示监听的端口号如8080。这个服务会一直在后台运行处理来自QQ的消息。4.4 在QQ上与你助手对话现在激动人心的时刻到了。打开你的手机QQ或电脑QQ找到你刚刚在开放平台创建的机器人账号它是一个特殊的QQ号或者将机器人拉入一个QQ群。在私聊窗口或群聊中你可以通过“机器人”或直接发送消息的方式取决于你的机器人设置来提问。例如我的助手 今天有什么新闻 我的助手 帮我写一份简单的会议纪要模板。你会发现nanobot会像在Chainlit网页里一样在QQ中给你带来智能回复。至此你已经拥有了一个跨平台的个人AI助手。5. 总结你的AI助手已就位回顾一下我们完成了从启动镜像、验证服务、通过网页与AI对话到最终将其配置为QQ机器人的全过程。nanobot以其极简的设计约4000行代码和开箱即用的体验大大降低了个人拥有一个功能型AI助手的门槛。这个基于Qwen3-4B模型的助手在中文对话和任务执行上提供了可靠的体验。Chainlit提供了友好的调试和交互界面而QQ机器人扩展则让它变得无处不在。核心收获极简部署无需复杂环境配置镜像已集成模型和界面。双模交互既可通过Web页面Chainlit深度交互也可通过QQ便捷使用。扩展性强通过修改配置文件即可启用或配置不同功能通道。成本低廉轻量级设计意味着对硬件资源要求更低更适合个人部署。下一步你可以尝试探索config.json中的其他配置项比如调整模型生成回复的“创造力”temperature参数。思考如何将nanobot与其他工具结合比如让它处理特定文件、管理简单任务等。关注项目的更新看看是否有新的功能或模型加入。希望这个教程能帮助你顺利开启与个人AI助手相伴的旅程。如果在配置过程中遇到任何问题可以参考镜像文档或通过社区寻求帮助。技术探索的路上乐趣无穷。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。