Nanobrowser安装指南：3分钟打造你的AI网页自动化助手

Nanobrowser是一款开源的多智能体浏览器自动化工具，通过内置Chrome扩展实现网页自动化操作。本指南将帮助你在3分钟内完成安装配置，立即拥有智能网页助手，解放双手处理重复任务。

安装前准备

在开始安装前，请确保你的环境满足以下要求：

• 浏览器兼容性：Chrome 或 Edge 最新版（查看支持详情）
• 网络环境：可访问互联网以下载扩展和依赖
• 开发环境（可选）：若需从源码构建，需安装Node.js v22.12.0+和pnpm v9.15.1+

快速安装：Chrome商店一键部署

最简单的安装方式是通过Chrome Web Store：

1. 访问 Nanobrowser Chrome扩展页面
2. 点击"添加到Chrome"按钮
3. 在弹出的确认对话框中选择"添加扩展"

提示：安装完成后，扩展图标将出现在浏览器工具栏。若未显示，可点击工具栏右侧的"拼图"图标找到Nanobrowser并固定到工具栏。

高级安装：手动部署最新版本

如需体验最新功能，可手动安装开发版本：

步骤1：下载扩展包

从 GitCode仓库 下载最新发布的nanobrowser.zip文件

步骤2：解压文件

将下载的ZIP文件解压到任意文件夹（例如Documents/nanobrowser）

步骤3：启用开发者模式

1. 打开Chrome浏览器，访问chrome://extensions/
2. 开启右上角"开发者模式"开关

步骤4：加载扩展

1. 点击"加载已解压的扩展程序"
2. 选择之前解压的nanobrowser文件夹
3. 确认添加扩展

从源码构建（开发者选项）

如果你是开发者，想自定义或贡献代码，可以从源码构建：

1. 克隆仓库

git clone https://gitcode.com/GitHub_Trending/na/nanobrowser.git
cd nanobrowser

2. 安装依赖

pnpm install

3. 构建扩展

pnpm build

构建完成的扩展文件将生成在dist目录下，按照"手动部署"的步骤3-4加载即可。

开发模式下可使用热重载：

pnpm dev

基础配置：连接你的AI模型

首次使用需要配置LLM服务提供商，Nanobrowser支持多种选择：

1. 打开设置面板

点击浏览器工具栏的Nanobrowser图标打开侧边栏，然后点击右上角⚙️图标进入设置

2. 配置API密钥

在设置页面中，选择"LLM Providers"选项卡，添加你的API密钥：

• OpenAI API密钥
• Anthropic API密钥
• Google Gemini API密钥
• 或其他兼容OpenAI格式的API（如Ollama、Groq等）

3. 智能体模型分配

Nanobrowser采用多智能体架构，建议为不同角色分配合适的模型：

智能体角色	推荐模型	功能说明
Planner	Claude Sonnet 4	负责任务规划和策略制定
Navigator	Claude Haiku 3.5	负责网页导航和元素交互

查看更多模型配置建议

验证安装：运行你的第一个自动化任务

安装完成后，让我们测试一个简单任务：

1. 打开任意网页（例如GitHub Trending）
2. 在Nanobrowser侧边栏输入：帮我提取当前页面的前5个项目标题和链接
3. 点击发送按钮，观察智能体如何自动浏览并提取信息

常见问题解决

扩展无法加载

• 确保已启用开发者模式
• 检查扩展文件是否完整
• 尝试重启浏览器后重新加载

智能体无响应

• 验证API密钥是否正确配置
• 检查网络连接是否正常
• 确认所选模型是否支持当前地区访问

任务执行失败

• 尝试简化任务描述
• 检查目标网站是否有反爬虫机制
• 在设置中调整智能体的"思考深度"参数

查看完整故障排除指南

下一步：探索高级功能

安装完成后，你可以：

• 查看使用教程 了解多智能体协作原理
• 探索API文档 开发自定义功能
• 加入社区讨论 分享使用经验

现在，你已拥有一个功能强大的AI网页自动化助手。开始探索Nanobrowser如何帮你简化日常工作流程吧！