OpenClaw 本地部署指南：nanobot支持多通道（Web/CLI/QQ）统一调度

优质文章学习记录

07 Apr 2026 — 8 min read

OpenClaw 本地部署指南：nanobot支持多通道（Web/CLI/QQ）统一调度

1. 项目简介

nanobot是一款超轻量级的个人人工智能助手，灵感来源于OpenClaw项目。这个工具最大的特点是代码量极小，只需要约4000行代码就能提供核心的代理功能，相比类似功能的Clawdbot项目（需要43万行代码）小了99%。

nanobot内置了vllm部署的Qwen3-4B-Instruct-2507模型，使用chainlit作为推理界面。最吸引人的是，它支持多种使用方式：可以通过网页界面聊天，可以用命令行交互，还能接入QQ机器人，实现统一的消息调度和处理。

无论你是想本地部署一个私人AI助手，还是希望为团队搭建一个智能问答系统，nanobot都是一个非常轻量且实用的选择。

2. 环境准备与快速部署

2.1 系统要求

在开始部署之前，请确保你的系统满足以下基本要求：

操作系统：Linux（推荐Ubuntu 20.04+或CentOS 7+）
Python版本：3.8或更高版本
显卡：至少8GB显存的NVIDIA显卡（用于运行4B参数模型）
内存：建议16GB或以上
存储空间：至少20GB可用空间

2.2 一键部署步骤

nanobot的部署过程相当简单，只需要几个命令就能完成：

# 克隆项目仓库 git clone https://github.com/sonhhxg/nanobot.git cd nanobot # 创建Python虚拟环境 python -m venv venv source venv/bin/activate # 安装依赖包 pip install -r requirements.txt # 启动模型服务 python serve_model.py

部署完成后，模型服务会自动在后台运行。整个过程通常需要10-20分钟，具体时间取决于你的网络速度和硬件性能。

3. 验证部署状态

3.1 检查模型服务

部署完成后，首先需要确认模型服务是否正常运行。打开终端，输入以下命令：

cat /root/workspace/llm.log

如果看到类似下面的输出，说明模型部署成功：

Model loaded successfully vLLM engine initialized Ready for inference

这个日志文件记录了模型加载和初始化的全过程，如果遇到问题，可以在这里找到详细的错误信息。

3.2 测试chainlit界面

nanobot默认使用chainlit提供网页聊天界面。在浏览器中访问 http://localhost:8000，你应该能看到一个简洁的聊天界面。

在输入框中尝试提问，比如："你能做什么？"或者"介绍一下你自己"。如果一切正常，你会看到模型生成的回复。

4. 基本功能使用

4.1 网页聊天界面

chainlit提供的网页界面是最简单的使用方式。界面分为三个主要部分：

左侧边栏：显示聊天历史记录
主聊天区域：显示当前对话内容
底部输入框：用于输入问题

你可以在这里进行各种问答，比如技术问题咨询、代码编写帮助、文档生成等。

4.2 命令行交互

除了网页界面，nanobot也支持命令行方式使用：

# 启动命令行交互模式 python cli_client.py # 或者直接通过curl调用API curl -X POST "http://localhost:8000/api/chat" \ -H "Content-Type: application/json" \ -d '{"message": "使用nvidia-smi看一下显卡配置"}'

命令行方式特别适合集成到脚本中，或者需要批量处理问答的场景。

4.3 实际使用示例

让我们尝试一个实际的技术问题。在聊天界面中输入：

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

nanobot会理解你的意图，并尝试执行相应的命令来获取显卡信息。返回结果可能类似：

根据当前环境，显卡配置如下： GPU 0: NVIDIA GeForce RTX 4090, 显存: 24GB 驱动程序版本: 535.86.05 CUDA版本: 12.2

这表明nanobot不仅能够理解自然语言指令，还能执行相应的系统命令并返回结果。

5. 接入QQ机器人扩展

5.1 注册QQ开放平台

要让nanobot支持QQ聊天机器人，首先需要注册QQ开放平台账号：

访问QQ开放平台官网：https://q.qq.com/#/apps
点击"注册"，选择个人或企业开发者类型
完成实名认证和邮箱验证

注册过程完全免费，个人开发者也能正常使用。

5.2 创建机器人应用

注册成功后，按照以下步骤创建机器人：

在控制台点击"创建应用"
选择"机器人"应用类型
填写应用基本信息：名称、描述、图标等
提交审核（通常几分钟就能通过）

创建完成后，记下分配给你的AppID和AppSecret，后面配置时需要用到。

5.3 配置nanobot支持QQ通道

现在需要修改nanobot的配置文件来启用QQ支持：

# 打开配置文件 vim /root/.nanobot/config.json

在配置文件中找到或添加QQ通道配置：

{ "channels": { "qq": { "enabled": true, "appId": "你的AppID", "secret": "你的AppSecret", "allowFrom": ["允许的QQ号或群号"] } } }

保存文件后，需要重启服务使配置生效。

5.4 启动网关服务

QQ机器人的消息需要通过网关服务转发给nanobot。启动网关服务：

nanobot gateway

如果启动成功，你会看到类似下面的输出：

Gateway service started on port 8080 QQ channel enabled Ready to receive messages

这个网关服务负责接收QQ平台的消息，转发给nanobot处理，然后再把回复发送回QQ。

5.5 测试QQ机器人

现在你可以打开QQ，向配置好的机器人发送消息了。尝试问一些技术问题：

帮我写一个Python爬虫代码

或者执行系统命令：

查看当前服务器状态

机器人会像在网页界面中一样智能地回答你的问题。

6. 多通道统一调度

nanobot最强大的功能之一是支持多通道统一调度。这意味着无论用户从哪个渠道发送消息（网页、命令行、QQ），nanobot都能统一处理并保持对话上下文。

6.1 消息路由机制

nanobot内部有一个智能的消息路由系统：

# 简化的消息处理流程 def handle_message(message, channel_type): # 统一预处理所有消息 processed_msg = preprocess_message(message) # 根据消息内容选择处理方式 if is_system_command(processed_msg): response = execute_system_command(processed_msg) else: # 调用AI模型生成回复 response = generate_response(processed_msg) # 根据渠道类型格式化回复 formatted_response = format_for_channel(response, channel_type) return formatted_response

这种设计确保了不同渠道的用户体验一致性。

6.2 会话状态管理

nanobot会为每个用户会话维护独立的状态：

网页会话：基于浏览器cookie
CLI会话：基于终端进程ID
QQ会话：基于QQ用户/群ID

这样就能实现连续的对话，模型能够记住之前的对话上下文，提供更连贯的体验。

7. 常见问题与解决方法

7.1 模型加载失败

如果模型服务启动失败，首先检查：

# 检查显存是否足够 nvidia-smi # 检查依赖包是否完整 pip list | grep vllm

确保显存至少8GB，并且所有依赖包都已正确安装。

7.2 QQ机器人无法连接

如果QQ机器人无法正常工作：

检查AppID和AppSecret是否正确
确认网络防火墙允许出站连接
查看网关服务日志：tail -f gateway.log

7.3 响应速度慢

如果感觉响应速度较慢，可以尝试：

# 调整模型参数优化速度 python serve_model.py --max_num_seqs 4 --tensor_parallel_size 1

或者考虑使用量化版本的模型来减少显存占用和提高速度。

8. 总结

通过本指南，你应该已经成功部署了nanobot，并配置好了多通道支持。这个超轻量级的AI助手虽然代码量很小，但功能相当强大：

主要优势：

部署简单，几行命令就能完成
支持多种使用方式：网页、命令行、QQ
统一的消息调度和处理机制
极低的资源占用，适合个人使用

适用场景：

个人技术助手：帮助解决编程问题
团队协作工具：通过QQ群提供技术支持
自动化脚本：集成到CI/CD流程中
学习研究：了解AI助手的工作原理

无论你是开发者、技术爱好者还是团队负责人，nanobot都能提供一个简单而强大的AI助手解决方案。它的轻量级设计使得部署和维护都非常简单，而多通道支持则让使用更加灵活方便。

获取更多AI镜像

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

OpenClaw 本地部署指南：nanobot支持多通道（Web/CLI/QQ）统一调度

优质文章学习记录