OpenClaw中文版教程：nanobot支持RAG插件接入本地PDF/MD文档知识库

1. nanobot简介：你的超轻量级AI助手

nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手，它让AI技术变得触手可及。想象一下，你只需要一个轻巧的工具，就能获得强大的AI能力，这就是nanobot的魅力所在。

为什么选择nanobot？

• 极致轻量：仅需约4000行代码即可提供核心代理功能，比同类产品的430k多行代码小了99%
• 实时验证：当前代码行数为3510行，你可以随时运行bash core_agent_lines.sh进行验证
• 内置强大模型：预置了基于vllm部署的Qwen3-4B-Instruct-2507模型，性能出色
• 友好界面：使用chainlit进行推理交互，体验流畅自然

无论你是开发者还是技术爱好者，nanobot都能为你提供一个简单易用的AI助手解决方案。

2. 环境准备与快速部署

在开始使用nanobot之前，让我们先确保环境已经正确部署。这个过程非常简单，即使是新手也能轻松完成。

2.1 检查模型服务状态

首先，我们需要确认模型服务是否已经成功部署。打开webshell，执行以下命令：

cat /root/workspace/llm.log

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

模型服务启动成功，监听端口：8000
vllm引擎初始化完成
Qwen3-4B-Instruct-2507模型加载完毕

2.2 启动chainlit交互界面

nanobot使用chainlit作为交互界面，启动命令非常简单：

chainlit run app.py

启动成功后，你会在终端看到服务运行信息，然后在浏览器中打开显示的地址即可开始使用。

3. 基础使用：与nanobot对话

现在让我们来体验nanobot的基本功能。通过chainlit界面，你可以像和朋友聊天一样与AI助手交流。

3.1 提问示例

尝试问一些技术相关问题，比如：

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

nanobot会理解你的指令并给出相应的响应。它会分析你的问题，调用适当的工具或提供相关信息。

3.2 对话技巧

为了获得更好的对话效果，这里有一些实用建议：

• 问题要具体：明确描述你想要什么信息或操作
• 使用自然语言：就像和真人交流一样表达
• 可以连续对话：基于之前的对话内容继续提问
• 尝试不同问题：从简单指令到复杂问题都可以尝试

4. 扩展功能：接入QQ机器人

nanobot不仅可以通过网页界面使用，还支持接入QQ机器人，让你的AI助手随时陪伴在身边。

4.1 注册QQ开放平台

首先需要访问QQ开放平台（https://q.qq.com/#/apps）注册开发者账号。选择个人或企业开发者类型，按照指引完成注册流程。

4.2 创建机器人应用

在平台中创建新的机器人应用，填写基本信息和配置。创建成功后，记下AppID和AppSecret，这些在后面配置中会用到。

4.3 配置nanobot支持QQ机器人

打开nanobot的配置文件进行修改：

vim /root/.nanobot/config.json

找到channels配置部分，添加QQ机器人的配置：

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

将"你的AppID"和"你的AppSecret"替换为实际获取的值。

4.4 启动网关服务

配置完成后，启动nanobot的gateway服务：

nanobot gateway

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

QQ机器人网关启动成功
监听消息中...
准备接收用户消息

4.5 测试QQ机器人功能

现在你可以向配置好的QQ机器人发送消息了。尝试问一些问题，比如"你好"或者技术相关问题，机器人会及时回复。

5. RAG插件：接入本地知识库

nanobot最强大的功能之一是支持RAG（检索增强生成）插件，可以接入本地的PDF、MD等文档，构建专属知识库。

5.1 准备文档材料

将你的PDF、Markdown或其他文本文档放在指定目录中。nanobot支持多种格式：

• PDF文档（技术手册、论文等）
• Markdown文件（项目文档、笔记等）
• Text文本（日志文件、配置说明等）
• Word文档（报告、文档等）

5.2 配置RAG插件

在nanobot配置文件中启用和配置RAG插件：

{
  "plugins": {
    "rag": {
      "enabled": true,
      "document_path": "/path/to/your/documents",
      "index_type": "faiss",
      "embedding_model": "text2vec"
    }
  }
}

5.3 构建知识库索引

首次使用需要构建文档索引：

nanobot rag index

这个过程会自动分析所有文档，建立搜索索引。完成后你就可以基于自己的文档库提问了。

5.4 使用知识库功能

现在你可以问一些基于文档内容的问题，比如：

根据技术文档，如何配置数据库连接？

我的笔记中关于项目架构是怎么描述的？

nanobot会从你的文档中检索相关信息，并生成准确的回答。

6. 实用技巧与最佳实践

为了让你更好地使用nanobot，这里分享一些实用技巧。

6.1 性能优化建议

• 合理配置资源：根据服务器配置调整模型参数
• 定期清理缓存：保持系统运行流畅
• 监控服务状态：使用内置工具查看运行状况

6.2 常见问题解决

问题1：模型服务启动失败

• 检查日志文件中的错误信息
• 确认硬件资源是否充足
• 验证模型文件是否完整

问题2：QQ机器人无法连接

• 检查网络连接状态
• 验证AppID和AppSecret是否正确
• 确认开放平台配置无误

问题3：RAG检索效果不佳

• 检查文档格式是否规范
• 尝试调整检索参数
• 确保文档内容质量良好

6.3 进阶使用建议

• 自定义插件开发：基于nanobot框架开发专属功能
• 多模型切换：配置不同的AI模型应对不同场景
• 自动化脚本：结合cron任务实现定时处理

7. 总结

通过本教程，你已经掌握了nanobot的核心使用方法。这个超轻量级的AI助手虽然代码量很小，但功能却十分强大。

关键收获回顾：

• nanobot是一个仅需4000行代码的超轻量级AI助手
• 内置Qwen3-4B-Instruct-2507模型，性能出色
• 支持chainlit网页交互和QQ机器人两种使用方式
• RAG插件可以接入本地文档构建专属知识库
• 配置简单，使用方便，适合个人和小团队使用

下一步学习建议：

• 尝试接入自己的文档库，体验RAG的强大功能
• 探索更多的插件和扩展可能性
• 加入社区交流，获取更多使用技巧

nanobot作为一个开源项目，还在不断发展和完善中。如果你在使用过程中遇到问题或有改进建议，可以通过官方渠道反馈。记住，这只是你AI助手之旅的开始，更多精彩功能等待你去探索和发现。

---

获取更多AI镜像

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