对比 OpenClaw 的 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」启动成功！ 即表示就绪。

常见问题：搜索功能的 API Key 困扰

默认情况下，nanobot 使用 Brave Search API 作为搜索后端，这需要注册并获取 API Key，流程较为繁琐。

为了解决这一问题，可以通过重构搜索模块支持其他搜索引擎，如完全免费的 DuckDuckGo。

扩展功能实现

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

• 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

总结

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

优点：

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

适合场景：

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

不适合场景：

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