nanobot 轻量级 AI Agent 框架实战：搭建 QQ 机器人与搜索扩展

💡 获取 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」启动成功！ 就表示一切就绪，去 QQ 上找你的机器人聊天吧！

踩坑记录：搜索功能的 API Key 困扰

当我兴冲冲地让机器人帮我搜索新闻时，它回复："无法获取网页搜索结果，因为缺少 BRAVE_API_KEY"。

什么？搜索还要单独的 API Key？

研究了一下发现，nanobot 默认使用 Brave Search API 作为搜索后端，这需要注册并获取 API Key。虽然有免费额度，但注册流程有点繁琐。

我就想：能不能支持其他搜索引擎？比如完全免费的 DuckDuckGo？

开源贡献：多搜索引擎支持

说干就干！我 fork 了 nanobot 仓库，花了一个下午重构了搜索模块，实现了三种搜索引擎的支持。

架构设计

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

• 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",  // 或 "brave" 或 "duckduckgo"
        "apiKey": "你的 API Key"
      }
    }
  }
}

三种引擎对比：

我已经将这个特性提交了 PR，希望能帮助到更多开发者：

PR 地址：https://github.com/HKUDS/nanobot/pull/507

效果展示

配置好 Tavily 后，搜索功能完美运行！从实际对话截图可以看到：搜索结果的质量相当不错，信息及时且全面，这就是 Tavily 作为 AI 优化搜索引擎的优势。

总结

nanobot 是一个非常适合个人开发者的 AI Agent 框架：

优点：

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

适合场景：

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

不适合场景：

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

如果你也想拥有一个 24 小时在线的 AI 助手，不妨试试 nanobot！

相关链接：

• nanobot 官方仓库：https://github.com/HKUDS/nanobot
• OpenClaw 官方仓库：https://github.com/openclaw/openclaw
• Gemini API：https://aistudio.google.com/apikey
• Tavily API：https://tavily.com/
• QQ 开放平台：https://q.qq.com/