基于 nanobot 搭建轻量级 QQ AI 机器人及搜索功能优化

获取 Gemini API Key 请访问：https://aistudio.google.com/apikey

第五步：配置 QQ 机器人

1. 前往 QQ 开放平台注册开发者账号。
2. 创建一个机器人应用，获取 AppID 和 Secret。
3. 在配置文件中启用 QQ 频道：

{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "你的 AppID",
      "secret": "你的 Secret"
    }
  }
}

第六步：启动

python3.11 -m nanobot gateway

看到 机器人「xxx」启动成功！ 即表示就绪。

搜索功能优化实践

默认情况下，nanobot 使用 Brave Search API 作为搜索后端，这需要单独注册并获取 API Key。为降低门槛，可通过策略模式重构搜索模块，支持多种搜索引擎。

架构设计

采用策略模式，使搜索后端可插拔：

• TavilyBackend (AI 优化搜索，推荐)
• BraveBackend (原版默认)
• DuckDuckGoBackend (免费，无需 API Key)

核心代码

class SearchBackend(ABC):
    @abstractmethod
    async def search(self, query: str, max_results: int) -> list[dict]:
        pass

class DuckDuckGoBackend(SearchBackend):
    """免费搜索，无需 API Key"""
    async def search(self, query: str, max_results: int) -> list[dict]:
        # 解析 DuckDuckGo HTML 页面获取结果
        url = f"https://html.duckduckgo.com/html/?q={quote(query)}"
        # ... 实现细节

使用方式

在配置文件中指定引擎即可：

{
  "tools": {
    "web": {
      "search": {
        "engine": "tavily", 
        "apiKey": "你的 API Key"
      }
    }
  }
}

三种引擎对比：

相关 PR 已提交至官方仓库：https://github.com/HKUDS/nanobot/pull/507

效果展示

配置好 Tavily 后，搜索功能运行正常，搜索结果信息及时且全面。

总结

nanobot 是一个适合个人开发者的 AI Agent 框架。

优点：

• 代码量小，易于理解和修改
• 安装部署简单，5 分钟上手
• 支持多平台（QQ、微信、Telegram 等）
• 社区活跃，更新频繁

适合场景：

• 个人 AI 助手
• 学习 AI Agent 原理
• 快速原型验证
• 二次开发定制

不适合场景：

• 企业级生产环境
• 需要复杂工作流的场景