OpenClaw中文版快速入门：nanobot Chainlit界面提问与结果可视化操作指南

你是不是也想拥有一个属于自己的AI助手，能帮你查看服务器状态、执行命令，甚至还能接入QQ当个智能聊天机器人？今天要介绍的nanobot，就是一个能让你轻松实现这个想法的超轻量级工具。

想象一下，你只需要在浏览器里打开一个界面，像聊天一样输入“帮我看看显卡状态”，它就能自动执行命令并把结果清晰地展示给你。或者，你还可以把它配置成QQ机器人，在群里随时@它提问。听起来是不是很酷？

nanobot是一个受OpenClaw启发但大幅精简的个人AI助手项目。它的核心代码只有大约4000行，比同类项目的数十万行代码小了99%，但核心的智能代理功能一个不少。它内置了vLLM部署的Qwen3-4B-Instruct-2507模型，通过Chainlit提供友好的Web界面，让你能直观地与AI交互。

这篇文章，我就带你从零开始，一步步学会怎么部署nanobot、怎么通过Chainlit界面提问并可视化查看结果，以及怎么把它配置成QQ机器人。整个过程就像搭积木一样简单，即使你之前没接触过这类工具，也能轻松跟上。

1. 环境准备与快速部署

在开始之前，我们先确认一下你的环境是否已经准备好了。nanobot镜像通常已经预置了所有必要的组件，但我们还是需要检查几个关键服务是否正常运行。

1.1 检查模型服务状态

模型服务是nanobot的大脑，它负责处理你的问题并生成回答。我们可以通过查看日志文件来确认服务是否正常启动。

打开终端，输入以下命令：

cat /root/workspace/llm.log

如果看到类似下面的输出，说明模型服务已经成功部署并正在运行：

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

这个日志告诉你，模型服务已经在8000端口启动成功了。如果看到的是错误信息或者服务没有启动，可能需要检查一下环境配置。不过根据我的经验，预置的镜像通常都是开箱即用的。

1.2 了解项目结构

虽然我们不需要手动安装什么，但了解一下nanobot的基本结构还是有帮助的。整个项目的核心代码都放在/root/.nanobot/目录下，主要包括：

• config.json - 配置文件，后面配置QQ机器人时会用到
• 核心代理代码 - 大约4000行Python代码，实现了所有的智能功能
• Chainlit界面文件 - 提供Web交互界面

你可能会好奇，为什么4000行代码就能实现这么复杂的功能？这是因为nanobot做了很多精简和优化，去掉了不必要的组件，只保留了最核心的代理逻辑。这种设计让它特别适合个人使用和小型项目。

2. 使用Chainlit界面与nanobot交互

Chainlit是一个专门为AI应用设计的Web界面框架，它让与AI的对话变得像聊天一样自然。nanobot集成了Chainlit，所以我们不需要额外配置就能使用。

2.1 启动Chainlit界面

在终端中输入以下命令启动Chainlit服务：

chainlit run app.py

等几秒钟，你会看到服务启动成功的提示，通常会在3000端口。打开浏览器，访问http://localhost:3000（或者你的服务器IP加3000端口），就能看到Chainlit的聊天界面了。

界面很简洁，左边是聊天历史，右边是主要的对话区域。最下面有一个输入框，你可以在这里向nanobot提问。

2.2 第一次提问：查看系统信息

让我们从一个简单的命令开始。在输入框中输入：

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

然后按回车或者点击发送按钮。nanobot会开始处理你的请求，这个过程通常需要几秒钟。

你会看到界面上出现了几个部分：

1. 你的问题 - 显示在右侧
2. 思考过程（如果开启了） - nanobot会展示它准备怎么回答
3. 执行命令 - 显示它实际执行的命令
4. 命令结果 - 显示命令执行后的输出

对于显卡查询，你会看到类似这样的输出：

+-----------------------------------------------------------------------------+
| NVIDIA-SMI 535.161.07   Driver Version: 535.161.07   CUDA Version: 12.2    |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  NVIDIA GeForce RTX 4090  Off  | 00000000:01:00.0  On |                  N/A |
| 30%   48C    P0    70W / 450W |   1024MiB / 24576MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+

这个界面最好的地方在于，它不仅仅是显示文字结果。Chainlit会自动识别代码块、表格等格式，让显示更加美观。如果是比较长的输出，它还会提供滚动条，不会让界面变得混乱。

2.3 更多实用命令示例

掌握了基本用法后，你可以尝试更多有用的命令。下面是一些我经常用的例子：

查看系统负载：

查看一下当前系统的CPU和内存使用情况

nanobot可能会执行top或者htop命令，然后返回类似这样的信息：

top - 14:30:01 up 10 days,  2:15,  1 user,  load average: 0.08, 0.03, 0.01
Tasks: 125 total,   1 running, 124 sleeping,   0 stopped,   0 zombie
%Cpu(s):  0.7 us,  0.3 sy,  0.0 ni, 99.0 id,  0.0 wa,  0.0 hi,  0.0 si,  0.0 st
MiB Mem :  15985.8 total,   1024.2 free,   2048.5 used,  12913.1 buff/cache

检查磁盘空间：

磁盘还剩下多少空间？

查看网络连接：

显示当前的网络连接情况

执行Python代码：

写一个简单的Python函数，计算斐波那契数列的前10个数

nanobot不仅会给出代码，还会执行并显示结果。

2.4 界面功能详解

Chainlit界面有几个很实用的功能，你可能一开始没注意到：

聊天历史 - 左侧会保存你所有的对话记录，点击任何一条都可以重新查看。这对于需要反复调试的命令特别有用。

代码高亮 - 所有的代码块都会自动高亮显示，不同的编程语言会有不同的颜色方案。

可折叠区域 - 如果输出内容很长，nanobot会把详细内容放在可折叠的区域里，点击可以展开或收起。

复制功能 - 每个代码块右上角都有复制按钮，一键复制命令或结果。

清空对话 - 如果你想开始一个新的对话而不受历史影响，可以点击清空按钮。

这些功能让Chainlit不仅仅是一个简单的聊天界面，而是一个完整的AI交互工作台。

3. 配置QQ机器人扩展功能

如果你想让nanobot更贴近日常使用，把它配置成QQ机器人是个不错的选择。这样你就能在QQ群里随时@它提问，或者在私聊中与它对话。

3.1 准备工作：注册QQ开放平台

首先，你需要有一个QQ机器人开发者账号。访问QQ开放平台（https://q.qq.com/#/apps），用你的QQ号登录。

如果是第一次使用，需要完成开发者认证。个人开发者认证比较简单，通常只需要实名信息。企业开发者需要营业执照等材料，但对于个人使用来说，个人开发者就足够了。

认证通过后，点击“创建应用”，选择“机器人”类型。给机器人起个名字，比如“我的AI助手”，然后按照提示完成创建。

3.2 获取关键信息：AppID和AppSecret

创建成功后，在应用的管理页面，找到“开发管理”或类似的标签页。这里有两个关键信息你需要记下来：

• AppID - 应用的唯一标识，一串数字
• AppSecret - 应用的密钥，一串字母数字组合

这两个信息相当于机器人的“账号”和“密码”，nanobot需要它们来连接QQ平台。

为了安全起见，建议你把AppSecret保存在安全的地方，不要在公共场合泄露。如果怀疑密钥泄露，可以在平台上重新生成。

3.3 修改nanobot配置文件

有了AppID和AppSecret后，我们需要告诉nanobot怎么连接QQ。打开配置文件：

vim /root/.nanobot/config.json

如果你不熟悉vim，也可以用其他编辑器，比如nano：

nano /root/.nanobot/config.json

在配置文件中，找到channels部分，添加QQ配置。如果原来没有这个部分，就在合适的位置添加：

{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "你的AppID",
      "secret": "你的AppSecret",
      "allowFrom": []
    }
  }
}

注意几个关键点：

• enabled设置为true，表示启用QQ通道
• appId和secret替换成你刚才记下的实际值
• allowFrom是一个数组，可以指定允许哪些QQ号或群使用。如果留空数组[]，表示允许所有（根据你的安全需求决定）

修改完成后保存退出。如果你不确定修改是否正确，可以用这个命令检查JSON格式：

python -m json.tool /root/.nanobot/config.json

如果格式正确，会漂亮地打印出配置文件内容；如果有错误，会提示具体哪里有问题。

3.4 启动网关服务

配置文件修改好后，需要启动nanobot的网关服务。这个服务负责接收QQ的消息，转发给AI处理，再把结果发回QQ。

在终端中运行：

nanobot gateway

如果一切正常，你会看到服务启动成功的提示，类似这样：

INFO:     Started server process [5678]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)
INFO:     QQ channel connected successfully

看到“QQ channel connected successfully”就说明连接成功了。这个服务需要一直运行，所以建议在后台运行，或者用systemd等工具管理。

3.5 在QQ中测试机器人

现在打开QQ，找到你添加了机器人的群，或者直接和机器人私聊。@机器人或者直接发送消息，比如：

@我的AI助手 现在几点了？

稍等片刻，机器人就会回复当前时间。你也可以问一些更复杂的问题：

@我的AI助手 帮我查一下服务器的内存使用情况

nanobot会像在Chainlit界面中一样，执行相应的命令并返回结果。不过需要注意的是，在QQ中，长的输出可能会被分成多条消息发送。

如果机器人没有响应，可以检查几个地方：

1. 网关服务是否还在运行（用ps aux | grep nanobot查看）
2. QQ开放平台的应用是否处于“上线”状态
3. 网络连接是否正常（特别是如果你的服务器在防火墙后面）

3.6 权限管理与安全考虑

当你的机器人开始工作后，可能需要考虑一些安全问题：

限制使用范围：在配置文件的allowFrom中，可以添加特定的QQ号或群号，这样只有指定的用户或群才能使用机器人。

命令白名单：nanobot支持配置允许执行的命令列表，避免执行危险操作。你可以在配置文件中添加类似这样的设置：

{
  "security": {
    "allowedCommands": ["nvidia-smi", "df", "free", "uptime", "python3"]
  }
}

监控日志：定期检查网关服务的日志，了解机器人的使用情况：

tail -f /var/log/nanobot_gateway.log

定期更新：关注nanobot项目的更新，及时获取安全补丁和新功能。

4. 实用技巧与进阶用法

掌握了基本用法后，我来分享一些让nanobot更好用的技巧。

4.1 提高回答准确性的提示词技巧

nanobot背后的模型是Qwen3-4B-Instruct，这是一个指令调优过的模型，对提示词比较敏感。通过优化你的提问方式，可以得到更准确的回答。

明确指令：与其说“看看系统”，不如说“查看当前系统的CPU使用率和内存占用情况”。

提供上下文：如果问题比较复杂，可以先给一些背景信息。比如：“我正在调试一个Python内存泄漏问题，请帮我查看当前Python进程的内存使用情况。”

指定格式：如果你希望结果以特定格式返回，可以在问题中说明。比如：“用表格形式列出当前目录下所有大于100MB的文件，包括文件名、大小和修改时间。”

分步骤提问：对于复杂的任务，可以拆分成多个简单问题。先问“如何备份MySQL数据库？”，根据回答再问具体的命令细节。

4.2 常用命令的快捷方式

如果你经常使用某些命令，可以为它们创建别名或快捷方式。虽然nanobot本身不支持自定义命令，但你可以通过一些变通方法实现类似效果。

比如，你经常需要查看GPU状态，可以这样提问：

这是我的常用命令：GPU状态查看。当我问“gpu”时，请执行nvidia-smi命令。

虽然每次还是要输入完整的问题，但至少你不需要每次都回忆具体的命令了。

另一种方法是利用Chainlit的聊天历史功能。把你常用的命令和对应的提问方式保存在一个文档里，需要时复制粘贴即可。

4.3 与其他工具集成

nanobot虽然轻量，但可以和其他工具配合使用，发挥更大的作用。

与监控系统结合：你可以让nanobot定期执行监控命令，然后把结果发送到监控系统。比如每小时检查一次磁盘使用率，超过阈值就报警。

与自动化脚本结合：把nanobot作为自动化流程的一部分。比如在部署脚本中，让nanobot检查服务状态，确认部署成功后再进行下一步。

与文档系统结合：让nanobot帮你维护文档。比如“根据今天的系统日志，生成一份简单的运行报告”。

4.4 故障排除指南

在使用过程中，可能会遇到一些问题。这里是一些常见问题的解决方法：

模型服务无响应：

# 检查服务状态
ps aux | grep vllm

# 重启服务
cd /root/workspace
./start_llm.sh

Chainlit界面无法访问：

• 检查3000端口是否开放：netstat -tlnp | grep 3000
• 检查防火墙设置
• 尝试重启Chainlit：pkill -f chainlit然后重新启动

QQ机器人不回复：

• 检查网关服务是否运行：ps aux | grep nanobot
• 检查QQ开放平台的应用状态
• 查看网关日志：tail -f /var/log/nanobot_gateway.log

命令执行权限问题： 有些命令可能需要特定权限才能执行。如果nanobot提示权限不足，可以考虑：

1. 修改命令，使用不需要特权的替代方案
2. 调整nanobot的运行权限（注意安全风险）
3. 通过sudo执行，但需要在配置中特别处理

内存或GPU不足： 如果遇到内存不足或GPU显存不够的问题，可以尝试：

# 查看当前资源使用情况
free -h
nvidia-smi

# 如果资源紧张，可以考虑减少并发请求
# 或者使用更小的模型（如果有的话）

5. 总结

通过这篇文章，你应该已经掌握了nanobot的基本使用方法。我们来简单回顾一下重点：

部署与验证方面，你学会了如何检查模型服务状态，确认nanobot已经准备就绪。关键的命令是查看/root/workspace/llm.log日志文件。

Chainlit界面使用是日常交互的主要方式。你知道了怎么启动界面、怎么提问、怎么查看结果。记住，提问时尽量明确具体，这样nanobot才能给出最准确的回答。

QQ机器人配置让nanobot更加贴近你的工作流。从注册QQ开放平台应用，到修改配置文件，再到启动网关服务，每一步都有详细的操作指引。配置成功后，你就可以在QQ中随时向AI助手提问了。

实用技巧部分提供了一些让nanobot更好用的方法。优化提示词、创建常用命令的快捷方式、与其他工具集成，这些都能提升你的使用体验。

nanobot最大的优势就是轻量化和易用性。4000行代码实现核心功能，意味着它运行高效、部署简单、维护方便。无论是个人学习使用，还是小团队的内部工具，它都是一个不错的选择。

当然，任何工具都有改进的空间。如果你在使用过程中遇到问题，或者有改进建议，可以联系项目维护者。开源项目的生命力就在于社区的参与和贡献。

最后提醒一点，虽然nanobot功能强大，但使用时还是要注意安全。特别是当它能够执行系统命令时，要确保有适当的权限控制和监控机制。不要在不信任的环境中使用，也不要让它执行危险的操作。

现在，你已经有了自己的AI助手。无论是查看服务器状态、执行日常任务，还是作为QQ群里的智能小帮手，nanobot都能为你提供帮助。开始使用吧，你会发现有AI助手的生活和工作，确实会轻松不少。

---

获取更多AI镜像

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