从零开始玩转OpenClaw中文版：nanobot轻量代理+Chainlit交互完整指南

你是不是也想拥有一个属于自己的AI助手，既能理解你的复杂指令，又能帮你执行任务，还能轻松集成到QQ里随时聊天？今天，我们就来手把手教你部署和玩转一个超轻量级的个人AI代理——nanobot。

nanobot是一个灵感来源于OpenClaw的中文项目，但它的代码量只有后者的1%，核心功能却一个不少。它内置了强大的Qwen3-4B-Instruct模型，通过Chainlit提供了一个漂亮的网页交互界面，还能一键接入QQ机器人。整个过程不需要你懂复杂的AI框架，跟着这篇指南，从环境检查到QQ聊天，你都能搞定。

1. 环境准备与快速上手

在开始之前，我们先来快速了解一下你需要准备什么，以及如何验证环境是否就绪。

1.1 你需要准备什么

实际上，你需要准备的东西非常少。如果你使用的是已经预置了nanobot的镜像环境（例如CSDN星图镜像广场提供的相关镜像），那么大部分工作都已经完成了。你只需要：

1. 一个可以运行Linux命令的终端（比如WebShell）。
2. 一个现代浏览器（用于访问Chainlit的Web界面）。
3. 一个QQ号（如果你想体验QQ机器人功能）。

1.2 验证模型服务是否启动

部署完成后，第一件事就是确认核心的AI模型服务是否已经在后台正常运行了。这很简单，只需要一条命令。

打开你的WebShell终端，输入以下命令来查看模型服务的日志：

cat /root/workspace/llm.log

如果看到日志中持续输出模型加载成功、服务启动在某个端口（例如8000）等信息，就说明模型服务部署成功了。一个正常的启动日志末尾可能看起来像这样：

...
INFO 07-28 10:30:15 llm_engine.py:73] Initializing an LLM engine with config: model="/root/models/Qwen2.5-4B-Instruct", ...
INFO 07-28 10:30:20 model_runner.py:155] CUDA capabilities: 8.6
INFO 07-28 10:30:25 llm_engine.py:161] KV cache pool size: 320.00 MB
INFO 07-28 10:30:25 async_llm_engine.py:141] Start HTTP server on http://0.0.0.0:8000

看到类似HTTP server on http://0.0.0.0:8000的字样，就大功告成了。这意味着一个高性能的推理引擎已经准备就绪，等待接收你的指令。

2. 通过Chainlit与你的AI助手对话

模型服务在后台跑起来了，我们怎么和它交互呢？nanobot贴心地集成了Chainlit，这是一个专门为AI应用设计的UI框架，能提供一个类似ChatGPT的网页聊天界面，美观又易用。

2.1 启动并访问Chainlit界面

通常情况下，Chainlit服务会随着镜像一起启动。你只需要知道它的访问地址。常见的配置是，在浏览器中访问你当前环境的特定端口（例如7860或8001）。

假设访问地址是 http://你的服务器IP:7860，打开浏览器输入这个地址。如果一切正常，你会看到一个简洁的聊天界面，可能有一个欢迎语，比如“Hello! I'm your nanobot assistant.”。

这就是你的AI助手的前台了，所有对话都将在这里发生。

2.2 开始你的第一次提问

现在，让我们问点实际的，测试一下它的能力。在Chainlit界面底部的输入框里，尝试输入一个需要它执行系统命令的请求：

使用nvidia-smi看一下显卡配置

点击发送。nanobot收到这个指令后，会理解你的意图是查看GPU状态，然后它在后台安全地执行nvidia-smi这条命令，并将结果获取回来，整理成易读的格式展示给你。

你会看到聊天窗口里，助手先是“思考”了一下，然后返回一个信息块，里面包含了显卡型号、驱动版本、GPU利用率、显存占用等详细信息，就像有一个懂技术的朋友在帮你操作服务器一样。

试试其他问题：

• 当前目录下有哪些文件？ （它会执行 ls -la）
• 系统的内存使用情况怎么样？ （它会执行 free -h）
• 帮我用Python写一个计算斐波那契数列的函数。 （它会直接生成代码）

通过这种方式，你可以用最自然的语言，让nanobot帮你完成许多需要命令行操作的任务，非常适合管理服务器、查询状态或者进行简单的自动化操作。

3. 进阶玩法：将AI助手接入QQ机器人

让AI助手待在网页里还不够酷？把它变成你的QQ好友，随时随地在手机QQ里和它聊天！nanobot内置了QQ机器人通道的支持，配置过程比想象中简单。

3.1 准备工作：获取QQ机器人的“身份证”

首先，你需要去QQ开放平台为你的AI助手申请一个合法的“机器人身份”。

1. 访问平台：打开 QQ开放平台官网，点击“应用开发”，登录你的QQ号。
2. 创建机器人：在控制台找到“创建应用”或“创建机器人”的按钮。应用类型选择“机器人”。
3. 获取关键信息：创建成功后，在应用的基本信息或开发设置页面，你会找到两个最重要的信息：
   • AppID：机器人的唯一标识，相当于账号。
   • AppSecret：机器人的密钥，相当于密码，务必保密。

请把这两个字符串复制并妥善保存，下一步配置需要用到。

3.2 配置nanobot，告诉它你的QQ机器人信息

现在，我们需要修改nanobot的配置文件，把上面获取到的“身份证”信息填进去。

1. 回到WebShell，使用vim或你喜欢的文本编辑器打开nanobot的配置文件：

   vim /root/.nanobot/config.json
   

2. 在配置文件中，找到 channels 配置部分。你需要添加或修改 qq 这个通道的配置。将 YOUR_APP_ID 和 YOUR_APP_SECRET 替换成你刚才记下的真实信息。

   {
     "channels": {
       "qq": {
         "enabled": true, // 确保这里是 true，启用QQ通道
         "appId": "你的真实AppID",
         "secret": "你的真实AppSecret",
         "allowFrom": [] // 这里可以空着，表示允许所有QQ好友；也可以填入特定QQ号进行限制
       }
     }
   }
   

3. 保存并退出编辑器。

3.3 启动网关服务，连接QQ平台

配置好后，nanobot需要一个“网关”服务来专门处理与QQ平台的通信。

在WebShell中执行以下命令启动网关：

nanobot gateway

如果启动成功，终端会显示服务正在监听某个端口（例如8080），并打印出类似“QQ channel gateway started”的日志。这表示网关已经就绪，正在等待QQ平台的消息。

3.4 在QQ上添加并测试你的机器人

1. 添加机器人：在QQ开放平台的应用设置里，通常有“生成体验链接”或“邀请测试”的选项。用你的手机QQ扫描这个二维码，就可以将机器人添加为好友或拉入群聊。
2. 开始聊天：添加成功后，像和普通好友一样，向这个机器人QQ发送消息，比如再次问它：“现在几点了？”
3. 查看结果：稍等片刻，你的AI助手就会通过QQ机器人回复你当前服务器的时间。至此，一个可以随时在QQ里聊天的私人AI助手就配置完成了！

4. 总结

通过以上步骤，你已经完成了从零部署、基础交互到高级集成的全过程。我们来简单回顾一下：

1. 开箱即用：基于预置镜像，nanobot和其背后的Qwen大模型已经就绪，你只需验证服务是否启动。
2. 自然交互：通过Chainlit提供的Web界面，你可以用自然语言指挥AI助手执行命令、编写代码或回答问题。
3. 扩展无限：通过简单的配置，就能将强大的AI能力接入QQ，打造一个24小时在线的智能聊天伙伴。

nanobot这个项目的魅力在于，它用极简的代码（约4000行）实现了核心的AI代理功能，让个人开发者也能轻松拥有一个可定制、可扩展的智能助手。无论是用于学习、工作效率提升，还是开发更复杂的自动化流程，它都是一个非常好的起点。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。