如何将 Bright Data 与 OpenClaw 集成

账户管理不是 Bright Data 平台支持的使用场景（自 2026 年 4 月 1 日起生效）。这包括在 TikTok、Instagram 等类似平台上进行账户管理。Bright Data 代理不得用于此类用途。详情请参阅可接受使用政策。

正在构建 AI 初创公司？

您可能符合我们的初创计划资格。获得本文所介绍基础设施的全额资助访问权限（最高价值 $20,000）。

OpenClaw 是一个自托管的 AI 助手网关，可将 WhatsApp、Telegram、Discord 和 iMessage 等消息应用连接到 AI 编码代理。它具有插件系统，可让您使用新工具和功能扩展代理。 Bright Data 的 OpenClaw 插件将 Bright Data 网络数据基础设施的全部功能直接带入您的 OpenClaw 代理中。安装一次，您的代理即可获得：

实时网络搜索通过 Google、Bing 和 Yandex 进行地理定位
机器人绕过抓取通过 Web Unlocker，它自动处理验证码、JS 渲染和速率限制
完整的浏览器自动化通过实际的 Chromium 实例，由 Bright Data 的住宅代理网络路由
50+ 结构化数据工具用于 Amazon、LinkedIn、Instagram、TikTok、YouTube、Reddit 等

该插件注册了 66 个工��，分为五个类别：搜索、抓取、批量操作、浏览器自动化和结构化网络数据。

入门步骤

前置条件

OpenClaw 已安装并运行
具有 API 密钥的 Bright Data 账户
Node.js 22+（由 OpenClaw 管理）

获取您的 Bright Data API 密钥

登录您的 Bright Data 仪表板。
转到账户设置。
如果尚未生成，请生成 API 密钥。

安装 Bright Data 插件

使用 OpenClaw CLI 安装插件：

openclaw plugins install @brightdata/brightdata-plugin

验证安装：

openclaw plugins inspect brightdata

您应该看到插件 ID brightdata 以及所有已注册的工具。

配置您的 API 密钥

选择以下方法之一来提供您的 Bright Data API 密钥：

环境变量（推荐用于本地开发）
OpenClaw 配置（推荐用于持久设置）

export BRIGHTDATA_API_TOKEN=your_token_here

openclaw config set plugins.entries.brightdata.config.webSearch.apiKey your_token_here

该插件在首次使用时自动创建两个代理区域：mcp_unlocker（Web Unlocker）和 mcp_browser（Browser API）。无需手动设置区域。

要使用现有的区域，请改为执行以下操作：

export BRIGHTDATA_UNLOCKER_ZONE=my_existing_zone
export BRIGHTDATA_BROWSER_ZONE=my_existing_browser_zone

启用插件

启用插件并重启网关：

openclaw plugins enable brightdata
openclaw gateway restart

如果插件工具未向您的代理公开，您可能需要显式允许插件工具：

openclaw config set tools.alsoAllow '["group:plugins"]'

开始使用工具

您的 OpenClaw 代理现在可以访问所有 66 个 Bright Data 工具。尝试这些示例提示：

搜索网络

使用 brightdata_search 工具搜索"最新 AI 新闻"并返回前 5 个结果。

抓取网页

在 https://example.com 上使用 brightdata_scrape 工具，并用 3 个要点总结页面。

自动化浏览器

使用 brightdata_browser_navigate 打开 https://example.com，然后使用 brightdata_browser_get_text 返回可见的页面文本。

获取结构化数据

使用 brightdata_amazon_product 获取 https://www.amazon.com/dp/B0D2Q9397Y 的详细信息

可用工具

搜索

工具	描述
`brightdata_search`	使用地理定位搜索 Google、Bing 或 Yandex。返回支持分页的结构化结果。
`brightdata_search_batch`	并行运行最多 5 个搜索查询。部分失败会内联返回。

brightdata_search 的参数：

参数	类型	描述
`query`	`string`	必需。搜索查询
`engine`	`"google"` \| `"bing"` \| `"yandex"`	搜索引擎（默认：`google`）
`count`	`number`	要返回的结果数，1-10
`cursor`	`string`	下一页的分页游标
`geo_location`	`string`	2 字母 ISO 国家代码（例如 `us`、`de`）

抓取

工具	描述
`brightdata_scrape`	通过 Web Unlocker 获取任何页面。适用于受机器人保护的站点、JS 渲染页面和地理限制内容。
`brightdata_scrape_batch`	使用相同的提取选项并行抓取最多 5 个 URL。

brightdata_scrape 的参数：

参数	类型	描述
`url`	`string`	必需。要抓取的 HTTP/HTTPS URL
`extractMode`	`"markdown"` \| `"text"` \| `"html"`	输出格式（默认：`markdown`）
`maxChars`	`number`	要返回的最大字符数（最小：100）

浏览器自动化

完整的 Chromium 浏览器控制，通过 Bright Data 的住宅代理网络路由。会话在 10 分钟后空闲超时。

工具	描述
`brightdata_browser_navigate`	使用可选的国家路由导航到 URL
`brightdata_browser_snapshot`	捕获具有交互元素引用的 ARIA 快照
`brightdata_browser_click`	通过快照引用点击元素
`brightdata_browser_type`	通过引用在字段中输入（可选择按 Enter 提交）
`brightdata_browser_fill_form`	在单个操作中填充多个表单字段
`brightdata_browser_screenshot`	拍摄视口或整页截图
`brightdata_browser_get_html`	获取当前页面 HTML
`brightdata_browser_get_text`	获取当前页面文本内容
`brightdata_browser_scroll`	滚动到页面底部
`brightdata_browser_scroll_to`	滚动到由引用指定的特定元素
`brightdata_browser_wait_for`	��待元素变为可见
`brightdata_browser_network_requests`	列出页面加载以来的网络请求
`brightdata_browser_go_back`	后退导航
`brightdata_browser_go_forward`	前进导航

结构化网络数据（50+ 平台）

每个工具接受 url 或 keyword 并返回干净的、类型化的 JSON。无需抓取或解析。

电子商务（10 个工具）

工具	数据
`brightdata_amazon_product`	产品详情、定价、规格
`brightdata_amazon_product_reviews`	客户评论和评分
`brightdata_amazon_product_search`	搜索结果与排名
`brightdata_walmart_product`	产品详情和可用性
`brightdata_walmart_seller`	卖家资料和指标
`brightdata_ebay_product`	列表详情和竞价
`brightdata_homedepot_products`	产品目录和定价
`brightdata_zara_products`	时尚目录数据
`brightdata_etsy_products`	手工制作和古董列表
`brightdata_bestbuy_products`	电子产品目录和优惠

专业网络（7 个工具）

工具	数据
`brightdata_linkedin_person_profile`	完整的个人资料
`brightdata_linkedin_company_profile`	公司概览和统计
`brightdata_linkedin_job_listings`	具有详情的空缺职位
`brightdata_linkedin_posts`	帖子内容和参与度
`brightdata_linkedin_people_search`	人物搜索结果
`brightdata_crunchbase_company`	融资、投资者、创始人
`brightdata_zoominfo_company_profile`	公司情报数据

社交媒体（17 个工具）

Instagram

工具	数据
`brightdata_instagram_profiles`	资料统计和简介
`brightdata_instagram_posts`	帖子内容和参与度
`brightdata_instagram_reels`	卷轴元数据和浏览
`brightdata_instagram_comments`	评论线程

Facebook

工具	数据
`brightdata_facebook_posts`	帖子内容和反应
`brightdata_facebook_marketplace_listings`	市场列表
`brightdata_facebook_company_reviews`	页面评论和评分
`brightdata_facebook_events`	活动详情和参与

TikTok

工具	数据
`brightdata_tiktok_profiles`	创作者资料和统计
`brightdata_tiktok_posts`	视频内容和指标
`brightdata_tiktok_shop`	TikTok 商城产品数据
`brightdata_tiktok_comments`	评论线程

X（Twitter）

工具	数据
`brightdata_x_posts`	帖子内容和指标
`brightdata_x_profile_posts`	资料帖子历史

YouTube 和 Reddit

工具	数据
`brightdata_youtube_profiles`	频道统计和信息
`brightdata_youtube_videos`	视频详情和指标
`brightdata_youtube_comments`	评论线程
`brightdata_reddit_posts`	帖子内容和得分

地图、购物和应用（4 个工具）

工具	数据
`brightdata_google_maps_reviews`	地点评论和评分
`brightdata_google_shopping`	购物结果和价格
`brightdata_google_play_store`	应用详情和评论
`brightdata_apple_app_store`	应用详情和评论

金融、新闻和代码（3 个工具）

工具	数据
`brightdata_yahoo_finance_business`	公司财务和新闻
`brightdata_github_repository_file`	仓库文件内容

房地产和旅游（2 个工具）

工具	数据
`brightdata_zillow_properties_listing`	房产清单和估计
`brightdata_booking_hotel_listings`	酒店列表和定价

AI 见解（3 个工具）

工具	数据
`brightdata_chatgpt_ai_insights`	ChatGPT 响应
`brightdata_grok_ai_insights`	Grok 响应
`brightdata_perplexity_ai_insights`	Perplexity 响应

网络搜索提供商集成

该插件也注册为 OpenClaw 网络搜索提供商。要将 Bright Data 设置为您的默认搜索提供商：

openclaw config set tools.web.search.provider brightdata

设置后，您的代理执行的任何通用网络搜索都将通过 Bright Data 的搜索基础设施路由。

配置参考

所有设置都可以通过环境变量或 OpenClaw 配置提供。环境变量优先。

设置	环境变量	OpenClaw 配置路径	默认值
API 密钥	`BRIGHTDATA_API_TOKEN`	`plugins.entries.brightdata.config.webSearch.apiKey`	必需
基础 URL	`BRIGHTDATA_BASE_URL`	`plugins.entries.brightdata.config.webSearch.baseUrl`	`https://api.brightdata.com`
Unlocker 区域	`BRIGHTDATA_UNLOCKER_ZONE`	`plugins.entries.brightdata.config.webSearch.unlockerZone`	`mcp_unlocker`
浏览器区域	`BRIGHTDATA_BROWSER_ZONE`	`plugins.entries.brightdata.config.webSearch.browserZone`	`mcp_browser`
请求超时	-	`plugins.entries.brightdata.config.webSearch.timeoutSeconds`	`30s` 搜索 / `60s` 抓取
轮询超时	-	`plugins.entries.brightdata.config.webSearch.pollingTimeoutSeconds`	`600s`

插件管理

# 验证安装和加载的工具
openclaw plugins inspect brightdata

# 更新到最新版本
openclaw plugins update brightdata

# 临时禁用
openclaw plugins disable brightdata

# 重新启用
openclaw plugins enable brightdata

# 卸载
openclaw plugins uninstall brightdata

故障排除

安装后找不到插件

运行 openclaw plugins list 以验证插件已安装。
使用 openclaw plugins inspect brightdata 检查插件 ID 是否为 brightdata。
运行 openclaw plugins doctor 获取诊断信息。

工具未注册

确保插件已启用：openclaw plugins enable brightdata。
重启网关：openclaw gateway restart。

身份验证错误

验证您的 API 密钥是否通过环境变量或配置正确设置。
检查密钥是否未在您的 Bright Data 仪表板中过期。

区域创建失败

该插件在首次使用时��动创建 mcp_unlocker 和 mcp_browser 区域。
如果自动创建失败，请在 Bright Data 仪表板中手动创建区域，并通过环境变量设置它们。

Documentation Index

正在构建 AI 初创公司？

​入门步骤

​可用工具

​搜索

​抓取

​浏览器自动化

​结构化网络数据（50+ 平台）

​网络搜索提供商集成

​配置参考

​插件管理

​故障排除

​其他资源

入门步骤

可用工具

搜索

抓取

浏览器自动化

结构化网络数据（50+ 平台）

网络搜索提供商集成

配置参考

插件管理

故障排除

其他资源