OpenClaw中文版落地：nanobot支持中文system prompt定制化Agent行为

OpenClaw中文版落地：nanobot支持中文system prompt定制化Agent行为

1. 项目简介

nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手，专为中文用户设计。这个项目最大的特点是只需要约4000行代码就能提供核心代理功能，相比Clawdbot的430k多行代码，体积小了99%，真正实现了轻量高效。

目前实时代码行数为3510行，你可以随时运行bash core_agent_lines.sh命令进行验证。nanobot内置了基于vllm部署的Qwen3-4B-Instruct-2507模型，使用chainlit进行推理交互，还支持自行配置QQ聊天机器人，让AI助手真正融入你的日常工作流程。

2. 环境准备与快速部署

2.1 模型服务状态检查

在开始使用nanobot之前，首先需要确认模型服务是否部署成功。通过webshell执行以下命令：

cat /root/workspace/llm.log

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

模型加载完成，服务启动成功 推理引擎初始化完毕 等待用户请求...

2.2 chainlit交互界面使用

nanobot提供了基于chainlit的图形化交互界面，让对话更加直观。启动chainlit服务后，你可以直接在网页界面中与AI助手进行交流。

界面分为三个主要区域：左侧是对话历史列表，中间是当前的对话内容，右侧是系统状态和设置选项。这种设计让交互变得更加简单明了。

3. 基础功能使用指南

3.1 首次对话体验

让我们从一个简单的例子开始。在chainlit界面中输入以下问题：

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

nanobot会理解你的指令，并返回类似这样的响应：

正在执行nvidia-smi命令... 检测到NVIDIA显卡信息： GPU 0: NVIDIA GeForce RTX 4090 显存：24GB 驱动版本：535.86.10 CUDA版本：12.2

这个例子展示了nanobot能够理解自然语言指令并执行相应的系统命令。

3.2 中文system prompt定制

nanobot支持中文system prompt的定制化配置，这是它的核心特色之一。通过修改系统提示词，你可以让AI助手具备不同的个性特点和专业能力。

例如，如果你想要一个专注于编程辅助的AI助手，可以设置这样的system prompt：

你是一个专业的编程助手，擅长Python、Java和Go语言。请用中文回答所有问题，提供实用的代码示例和最佳实践建议。

定制方法很简单，只需要编辑配置文件中的相应字段即可。这种灵活性让nanobot能够适应各种不同的使用场景。

4. QQ机器人集成实战

4.1 QQ开放平台注册

为了让nanobot能够作为QQ机器人运行，首先需要在QQ开放平台注册开发者账号。访问https://q.qq.com/#/apps，选择个人或企业开发者类型完成注册。

注册过程中需要提供基本信息和联系方式，整个过程大约需要10-15分钟。审核通过后，你就获得了创建机器人的权限。

4.2 创建和配置机器人

在QQ开放平台的控制台中，点击"创建应用"按钮，选择"机器人"类型。填写应用名称、描述等基本信息后，系统会为你分配唯一的AppID和AppSecret。

这些凭证非常重要，是nanobot与QQ平台通信的钥匙。请妥善保管，不要泄露给他人。

4.3 nanobot配置修改

接下来需要修改nanobot的配置文件，添加QQ机器人的相关设置。使用以下命令打开配置文件：

vim /root/.nanobot/config.json

找到channels配置段，添加或修改qq配置项：

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

这里的allowFrom数组可以指定允许使用机器人的QQ号码列表，如果为空数组则表示允许所有人使用。

4.4 启动网关服务

配置完成后，需要启动nanobot的gateway服务来建立与QQ平台的连接：

nanobot gateway

服务启动成功后，你会看到类似下面的输出：

QQ网关服务启动成功 监听端口: 8080 等待QQ平台回调...

这表示nanobot已经准备好接收和处理QQ消息了。

4.5 测试QQ机器人功能

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

你好，能帮我查一下当前时间吗？

机器人会立即响应并提供所需信息。这种集成方式让AI助手的使用变得更加便捷，你可以在熟悉的QQ环境中直接获得智能辅助。

5. 高级功能与定制技巧

5.1 多场景prompt模板

nanobot支持创建多个prompt模板来适应不同的使用场景。你可以在配置文件中定义多个模板，然后根据需要快速切换。

例如，可以设置工作模式、学习模式、创意模式等不同的prompt模板，每种模式都有特定的行为特点和知识侧重。

5.2 自定义指令集

通过修改源码，你可以为nanobot添加自定义的指令集。比如添加专门的文件处理指令、网络检测指令或者系统监控指令。

每个指令都是一个独立的Python函数，遵循统一的接口规范，这使得功能扩展变得非常简单。

5.3 性能优化建议

对于资源受限的环境，可以考虑以下优化措施：降低模型推理的并行度、启用量化推理、调整缓存策略等。这些优化可以显著降低内存占用和提高响应速度。

6. 常见问题解答

问题1：模型服务启动失败怎么办？检查日志文件中的错误信息，常见原因包括内存不足、端口冲突或者模型文件损坏。确保系统有足够的GPU内存和磁盘空间。

问题2：QQ机器人无法接收消息怎么办？确认网络配置正确，QQ平台的回调地址能够访问到你的服务器。检查防火墙设置和端口转发配置。

问题3：如何升级nanobot版本？关注项目的GitHub仓库，获取最新的发布版本。升级前建议备份配置文件和对话历史。

问题4：支持其他即时通讯平台吗？目前主要支持QQ平台，但架构设计允许轻松扩展其他平台。欢迎社区贡献其他平台的集成代码。

7. 总结

nanobot作为一个超轻量级的OpenClaw中文版实现，展现了令人印象深刻的工程优化能力。仅用4000行代码就实现了核心的AI助手功能，这为个人和小团队部署私有AI助手提供了极佳的解决方案。

通过支持中文system prompt定制化，nanobot让用户能够根据自己的需求塑造AI助手的性格和能力。而QQ机器人的集成更是让AI助手的使用门槛降到最低，用户可以在最熟悉的聊天环境中享受智能服务。

项目的轻量级特性也意味着它可以在各种硬件环境中运行，从高端的工作站到普通的云服务器都能良好支持。这种灵活性加上开源的特性，使得nanobot成为了AI助手领域一个很有价值的替代选择。

获取更多AI镜像

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