nanobot实战教程：Qwen3-4B-Instruct在WebShell中执行shell脚本并返回结果
nanobot实战教程：Qwen3-4B-Instruct在WebShell中执行shell脚本并返回结果
1. nanobot简介：超轻量级AI助手
nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手，仅需约4000行代码就能提供核心代理功能。相比传统AI助手动辄数十万行的代码量，nanobot的代码量减少了99%，但功能却毫不逊色。
这个轻量级设计带来了几个明显优势：部署速度快、资源占用少、响应迅速。当前实时代码行数为3510行，你可以随时运行bash core_agent_lines.sh命令进行验证。
nanobot内置了基于vllm部署的Qwen3-4B-Instruct-2507模型，使用chainlit框架进行推理交互。这意味着你不仅能获得强大的语言理解能力，还能通过简单的配置将其接入各种聊天平台，包括QQ机器人。
2. 环境准备与快速部署
2.1 检查模型服务状态
在开始使用nanobot之前，首先需要确认模型服务已经成功部署。通过WebShell执行以下命令：
cat /root/workspace/llm.log如果看到类似下面的输出，说明模型服务部署成功：
模型加载完成，服务已启动 推理引擎初始化成功 服务监听端口：80002.2 启动chainlit交互界面
nanobot使用chainlit作为前端交互界面，启动命令非常简单：
chainlit run app.py启动成功后，你会在终端看到服务监听的端口号（通常是7860或8000），在浏览器中访问对应的地址就能看到聊天界面。
3. 执行Shell脚本实战演示
3.1 基础提问与执行
让我们通过一个实际例子来演示nanobot如何执行Shell命令。在chainlit界面中输入：
使用nvidia-smi看一下显卡配置nanobot会理解你的指令，自动执行相应的Shell命令，并返回格式化的结果。返回的信息通常包括：
- GPU型号和数量
- 显存使用情况
- 温度和功耗信息
- 运行中的进程列表
3.2 复杂脚本执行示例
除了简单的命令，nanobot还能处理更复杂的脚本执行需求。比如：
请检查系统磁盘使用情况，找出占用空间最大的前5个目录nanobot会组合使用df -h和du命令，给出详细的磁盘使用分析报告。
3.3 安全执行机制
需要注意的是，nanobot内置了安全机制，不会执行危险命令（如rm -rf /等破坏性操作）。所有命令执行都在沙箱环境中进行，确保系统安全。
4. 接入QQ机器人扩展功能
4.1 注册QQ开放平台
要使用QQ机器人功能，首先需要访问QQ开放平台（https://q.qq.com/#/apps）注册开发者账号。选择个人或企业开发者类型，完成实名认证。
4.2 创建机器人应用
在平台内创建新的机器人应用，获取必要的认证信息：
- AppID：应用唯一标识
- AppSecret：应用密钥，用于API调用认证
4.3 配置nanobot连接QQ
修改nanobot的配置文件，添加QQ机器人相关设置：
vim /root/.nanobot/config.json在配置文件中添加以下内容：
{ "channels": { "qq": { "enabled": true, "appId": "你的AppID", "secret": "你的AppSecret", "allowFrom": [] } } }allowFrom字段可以设置允许使用机器人的QQ号列表，如果为空则表示允许所有人使用。
4.4 启动网关服务
配置完成后，启动nanobot的网关服务：
nanobot gateway服务启动成功后，你会看到类似下面的输出：
QQ网关服务已启动 监听消息中... 机器人已上线4.5 测试QQ机器人功能
现在你可以直接在QQ中向机器人提问了。尝试发送：
查看当前服务器时间机器人会执行date命令并返回当前系统时间，证明QQ机器人功能正常工作。
5. 高级功能与使用技巧
5.1 自定义命令别名
你可以在配置文件中设置命令别名，让常用操作更便捷：
{ "commands": { "查看状态": "nvidia-smi && df -h", "清理缓存": "sudo sync && echo 3 > /proc/sys/vm/drop_caches" } }5.2 多步骤任务执行
nanobot支持执行多步骤的复杂任务：
帮我完成以下操作：先备份当前目录到/backup，然后检查系统更新，最后重启nginx服务5.3 执行结果格式化
nanobot会自动对命令输出进行格式化处理，比如将JSON数据美化显示，将日志信息按时间排序等，使结果更易读。
6. 常见问题解决
6.1 权限问题处理
如果遇到权限不足的错误，可以尝试以下解决方案：
- 确保nanobot运行用户有执行相应命令的权限
- 对于需要sudo权限的命令，提前配置好sudo免密码设置
- 或者在配置中设置允许执行的命令白名单
6.2 网络连接问题
QQ机器人无法连接时，检查：
- 网络防火墙设置
- QQ开放平台的应用配置是否正确
- AppID和AppSecret是否填写正确
6.3 性能优化建议
如果响应速度较慢，可以考虑：
- 调整vllm推理参数
- 增加系统内存
- 使用GPU加速推理
7. 总结
通过本教程，你已经学会了如何使用nanobot在WebShell中执行Shell脚本并返回结果。这个超轻量级的AI助手不仅提供了强大的命令执行能力，还能通过简单的配置接入QQ等聊天平台。
关键要点回顾：
- nanobot仅需4000行代码，体积小但功能完整
- 支持通过自然语言执行Shell命令和脚本
- 可以轻松接入QQ机器人，扩展使用场景
- 内置安全机制，确保系统安全
实际使用中，你可以根据需求灵活配置nanobot，让它成为你的个人AI助手，帮助完成各种系统管理任务。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。